dda-devops-build/doc/ReleaseMixin.md

ReleaseMixin

Support for releases following the trunk-based-release flow (see https://trunkbaseddevelopment.com/)

classDiagram
    class ReleaseMixin {
        prepare_release() - adjust all build files to carry the correct version & commit locally
        tag_and_push_release() - tag the git repo and push changes to origin
        update_release_type (release_type) - change the release type during run time
    }

Input

name	description	default
release_type	one of MAJOR, MINOR, PATCH, NONE	"NONE"
release_main_branch	the name of your trank	"main"
release_primary_build_file	path to the build file having the leading version info (read & write). Valid extensions are .clj, .json, .gradle, .py	"./project.clj"
release_secondary_build_files	list of secondary build files, version is written in.	[]

Example Usage

build.py

rom os import environ
from pybuilder.core import task, init
from ddadevops import *

name = 'my-project'
MODULE = 'my-module'
PROJECT_ROOT_PATH = '..'

@init
def initialize(project):
    project.build_depends_on("ddadevops>=4.0.0")

    input = {
        "name": name,
        "module": MODULE,
        "stage": "notused",
        "project_root_path": PROJECT_ROOT_PATH,
        "build_types": [],
        "mixin_types": ["RELEASE"],
        "release_type": "MINOR",
        "release_primary_build_file": "project.clj",
        "release_secondary_build_files": ["package.json"],
    }

    roject.build_depends_on("ddadevops>=4.0.0-dev")
    
    build = ReleaseMixin(project, input)
    build.initialize_build_dir()


@task
def prepare_release(project):
    build = get_devops_build(project)
    build.prepare_release()

@task
def build(project):
    print("do the build")

@task
def publish(project):
    print("publish your artefacts")

@task
def after_publish(project):
    build = get_devops_build(project)
    build.tag_bump_and_push_release()

call the build

pyb prepare_release build publish after_publish