gitlab-projects-settings 4.2.1__tar.gz → 5.2.1__tar.gz

gitlab_projects_settings-5.2.1/.cz.yaml

@@ -0,0 +1,188 @@
+---
+commitizen:
+
+  # commitizen configurations
+  always_signoff: true
+  bump_message: 'docs(changelog): regenerate release tag changes history'
+  changelog_incremental: false
+  major_version_zero: true
+  retry_after_failure: false
+  tag_format: $version
+  update_changelog_on_bump: false
+  use_shortcuts: true
+  version_provider: scm
+  version_scheme: pep440
+
+  # commitizen rules
+  #  - Based upon 'cz_conventional_commits' original rules for Conventional Commits
+  #  - Improved with 'Issue:' detailed messages examples and 'Signed-off-by' footer
+  #  - Commit scope turned mandatory by the rules
+  #  - Commit scope refactored with support for spaces and comma
+  #  - Breaking change reimplemented with the standard '!' scope suffix
+  #  - Questions simplified for professional usage
+  #  - Type 'security' implemented for security related commits
+  #  - Accept temporary commits starting with 'wip' or 'WIP'
+  name: cz_customize
+  customize:
+    example: |-
+      feat(scope): implement feature ABC in sources
+
+      Issue: #123
+      Details: Details about the changes
+      ---
+
+      Signed-off-by: Firstname LASTNAME <firstname.lastname@example.com>
+    info: |
+
+      ## Conventional Commits - Customized specification
+
+      The commit contains the following structural elements, to communicate
+      intent to the consumers of your library:
+
+      ### Commit type
+
+      fix: a commit of the type fix patches a bug in your codebase
+      (this correlates with PATCH in semantic versioning).
+
+      feat: a commit of the type feat introduces a new feature to the codebase
+      (this correlates with MINOR in semantic versioning).
+
+      Others: commit types other than fix: and feat: are allowed,
+      like chore:, docs:, style:, refactor:, perf:, test:, and others.
+
+      We also recommend improvement for commits that improve a current
+      implementation without adding a new feature or fixing a bug.
+
+      For temporary commits, start with 'wip' or 'WIP' to ignore commit validation.
+
+      ### Commit scope
+
+      A scope has to be provided to a commit’s type, to provide additional contextual information,
+      such as the changed file, the containing folder or a globally modified feature,
+      and is contained within parenthesis, e.g., feat(parser): add ability to parse arrays.
+
+      ### Commit breaking changes
+
+      BREAKING CHANGE: A commit with '!' before the ':' or that has the text BREAKING CHANGE:
+      at the beginning of its optional body or footer section introduces a breaking API change
+      (correlating with MAJOR in semantic versioning).
+      A BREAKING CHANGE can be part of commits of any type.
+
+      ### Commit syntax
+
+      Notice these types are not mandated by the conventional commits specification,
+      and have no implicit effect in semantic versioning (unless they include a BREAKING CHANGE).
+
+      <type>(mandatory scope)[optional !]: <description>
+
+      [optional body]
+
+      [optional footer]
+    message_template: "\
+      {{prefix}}\
+      ({{scope}})\
+      {% if is_breaking_change %}!{% endif %}\
+      : \
+      {{subject}}\
+      {% if body or footer %}\n{% endif %}\
+      {% if body %}\n{{body}}{% endif %}\
+      {% if footer %}\n{{footer}}{% endif %}\
+      {% if body or footer %}\n---{% endif %}\
+    "
+    questions:
+      - type: list
+        name: prefix
+        message: 'Type of the change :'
+        choices:
+          - value: fix
+            name: 'fix: Bug or issues fixes'
+            key: x
+          - value: feat
+            name: 'feat: New or extended feature'
+            key: f
+          - value: chore
+            name: 'chore: Changes to non-production code'
+            key: h
+          - value: docs
+            name: 'docs: Documentation only changes'
+            key: d
+          - value: style
+            name: 'style: Cosmetic changes only (white-space, formatting, etc)'
+            key: s
+          - value: refactor
+            name: 'refactor: Code changes that neither fix a bug nor add a feature'
+            key: r
+          - value: perf
+            name: 'perf: Code change that improve performance'
+            key: p
+          - value: security
+            name: 'security: Changes that improve sources without any impact'
+            key: e
+          - value: test
+            name: 'test: Adding missing or correcting existing tests'
+            key: t
+          - value: build
+            name: 'build: Changes to the build system or dependencies _(example: makefile, pip, docker)'
+            key: b
+          - value: ci
+            name: 'ci: Changes to CI configuration files and scripts (example: gitlab-ci)'
+            key: c
+          - value: improvement
+            name: 'improvement: Changes that improve sources without any impact'
+            key: i
+      - type: input
+        name: scope
+        message: 'Scope of the change :'
+        filter: 'lambda text: commitizen.cz.utils.required_validator(text, msg="! Error: Scope is required")'
+        default: ''
+      - type: input
+        name: subject
+        message: 'Title of the commit (starting in lower case and without period) :'
+        filter: 'lambda text: commitizen.cz.utils.required_validator(text.strip(".").strip(), msg="! Error: Title is required")'
+        default: ''
+      - type: input
+        name: body
+        message: 'Additional contextual message (Empty to skip) :'
+        default: 'Issue: #...'
+        filter: 'commitizen.cz.utils.multiple_line_breaker'
+      - type: input
+        name: footer
+        message: 'Footer information and references (Empty to skip) :'
+        default: ''
+      - type: confirm
+        message: 'BREAKING CHANGE to warn ?'
+        name: is_breaking_change
+        default: False
+    schema: |-
+      <type>(<scope>): <subject>
+      <BLANK LINE>
+      <body>
+      <BLANK LINE>
+      <footer>
+    schema_pattern: "\
+      (?s)\
+      ^(wip|WIP).*$\
+      |\
+      (fix|feat|chore|docs|style|refactor|perf|test|build|ci|improvement|security|revert)\
+      (\\([^\\n\\r]+\\))\
+      !?\
+      :\
+       \
+      ([^\\n\\r]+)\
+      ((\\n\\n.*)|(\\s*))?\
+      (\\n[^\\n\r]+-by:.*)*\
+      $\
+    "
+
+  # commitizen styles
+  style:
+    - ["qmark", "fg:#FF9D00 bold"]
+    - ["question", "bold"]
+    - ["answer", "fg:#FF9D00 bold"]
+    - ["pointer", "fg:#FF9D00 bold"]
+    - ["highlighted", "fg:#FF9D00 bold"]
+    - ["selected", "fg:#CC5454"]
+    - ["separator", "fg:#CC5454"]
+    - ["instruction", ""]
+    - ["text", ""]
+    - ["disabled", "fg:#858585 italic"]

gitlab_projects_settings-5.2.1/.gitlab-ci.yml

@@ -0,0 +1,428 @@
+stages:
+  - development
+  - prepare
+  - build
+  - deploy
+
+variables:
+  REGISTRY_HOST: registry.gitlab.com
+  REGISTRY_NAMESPACE: radiandevcore/tools
+  REGISTRY_PROJECT: gitlab-projects-settings
+
+.local:
+  engine: docker,auto
+  real_paths: true
+  version: 9.0
+
+# =============================================================================
+# Stage: development
+
+clean:
+  stage: development
+  image: local
+  script:
+    - sudo rm -rf ./build ./dist ./*.egg-info ./.eggs
+  rules:
+    - if: $CI_LOCAL
+
+changelog:
+  stage: development
+  image: local:silent
+  script:
+    # Prepare git-cliff binaries
+    - |
+      mkdir -p ./.tmp/
+      if ! ls ./.tmp/git-cliff-x86_64-unknown-linux-gnu.tar.gz >/dev/null 2>&1; then
+        wget -O ./.tmp/git-cliff-x86_64-unknown-linux-gnu.tar.gz -q https://github.com/orhun/git-cliff/releases/download/v2.4.0/git-cliff-2.4.0-x86_64-unknown-linux-gnu.tar.gz
+        tar -xzf ./.tmp/git-cliff-x86_64-unknown-linux-gnu.tar.gz -C ./.tmp/ --strip-components 1
+        rm -f ./.tmp/git-cliff-x86_64-unknown-linux-gnu.tar.gz
+      fi
+    # Request release tag
+    - |
+      echo -n " > Current commit : "
+      git describe --always
+      echo ''
+      if [ ! -z "${RELEASE_TAG:-}" ]; then
+        tag="${RELEASE_TAG}"
+      else
+        read -p " > Release tag : " -r tag
+      fi
+      echo ''
+    # Generate changelog
+    - |
+      git tag -f -m "${tag}" "${tag}"
+      ./.tmp/git-cliff --no-exec --config ./config/cliff.toml --output ./CHANGELOG.md
+      sed -i "s#raw/[^/]*/docs#raw/${tag}/docs#g" ./README.md
+      git add -v ./CHANGELOG.md ./README.md
+      echo ''
+      git commit -m "docs(changelog): regenerate release tag changes history" -s
+      echo ''
+    # Create release tag
+    - git tag -f -m "${tag}" "${tag}"
+  rules:
+    - if: $CI_LOCAL
+
+images:
+  stage: development
+  image: local:silent
+  script:
+    # Rehost standard images
+    - |
+      for image in \
+          python:3.12-alpine \
+      ; do
+        if [ -z "${IMAGE}" ] || echo "${image}" | grep -q "${IMAGE}"; then
+          echo ''
+          echo " [INFO] Pull: ${image}"
+          echo ''
+          docker pull "${image}" || true
+          docker tag "${image}" "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}"
+          echo ''
+          echo " [INFO] Push: ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}"
+          echo ''
+          docker push "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" || true
+          docker rmi "${image}" >/dev/null || true
+        fi
+      done
+    # Prepare build image
+    - |
+      base='python:3.12-alpine'
+      image='gitlab-projects-settings:build'
+      if [ -z "${IMAGE}" ] || echo "${image}" | grep -q "${IMAGE}"; then
+        echo ''
+        echo " [INFO] Pull: ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}"
+        echo ''
+        docker pull "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}" || true
+        docker pull "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" || true
+        docker build -t "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" -f - . <<-EOF
+      FROM ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}
+      RUN apk add -q git
+      COPY ./requirements/runtime.txt /tmp/
+      COPY ./requirements/build.txt /tmp/
+      RUN export PIP_DISABLE_PIP_VERSION_CHECK=1 \
+       && pip3 install -q -r /tmp/runtime.txt --no-cache-dir --upgrade \
+       && pip3 install -q -r /tmp/build.txt --no-cache-dir --upgrade \
+       && rm -f /tmp/runtime.txt \
+       && rm -f /tmp/build.txt
+      EOF
+        echo ''
+        echo " [INFO] Push: ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}"
+        echo ''
+        docker push "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" || true
+      fi
+    # Prepare codestyle image
+    - |
+      base='python:3.12-alpine'
+      image='gitlab-projects-settings:codestyle'
+      if [ -z "${IMAGE}" ] || echo "${image}" | grep -q "${IMAGE}"; then
+        echo ''
+        echo " [INFO] Pull: ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}"
+        echo ''
+        docker pull "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}" || true
+        docker pull "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" || true
+        docker build -t "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" -f- . <<-EOF
+      FROM ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}
+      RUN apk add -q git
+      COPY ./requirements/runtime.txt /tmp/
+      COPY ./requirements/quality.txt /tmp/
+      RUN export PIP_DISABLE_PIP_VERSION_CHECK=1 \
+       && pip3 install -q -r /tmp/runtime.txt --no-cache-dir --upgrade \
+       && pip3 install -q -r /tmp/quality.txt --no-cache-dir --upgrade \
+       && rm -f /tmp/runtime.txt \
+       && rm -f /tmp/quality.txt \
+       && rm -f /tmp/tests.txt
+      EOF
+        echo ''
+        echo " [INFO] Push: ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}"
+        echo ''
+        docker push "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" || true
+      fi
+    # Prepare deploy image
+    - |
+      base='python:3.12-alpine'
+      image='gitlab-projects-settings:deploy'
+      if [ -z "${IMAGE}" ] || echo "${image}" | grep -q "${IMAGE}"; then
+        echo ''
+        echo " [INFO] Pull: ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}"
+        echo ''
+        docker pull "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}" || true
+        docker pull "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" || true
+        docker build -t "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" -f - . <<-EOF
+      FROM ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}
+      RUN apk add -q gcc git libc-dev libffi-dev sed
+      COPY ./requirements/deploy.txt /tmp/
+      RUN export PIP_DISABLE_PIP_VERSION_CHECK=1 \
+       && pip3 install -q -r /tmp/deploy.txt --no-cache-dir --upgrade \
+       && rm -f /tmp/deploy.txt
+      EOF
+        echo ''
+        echo " [INFO] Push: ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}"
+        echo ''
+        docker push "${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${image}" || true
+      fi
+  rules:
+    - if: $CI_LOCAL
+
+# =============================================================================
+# Stage: prepare
+
+codestyle:
+  stage: prepare
+  image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:codestyle
+  needs: []
+  script:
+    - yapf -i ./.hooks/*.py ./src/*.py ./src/*/*.py ./setup.py
+    - echo '' && git diff --name-status
+    - git diff --quiet
+  rules:
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+      changes:
+        - 'CHANGELOG.md'
+        - '.hooks/**/*'
+        - 'requirements/**/*'
+        - 'setup.py'
+        - 'src/**/*'
+    - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != $CI_DEFAULT_BRANCH
+      when: on_success
+
+commits:
+  stage: prepare
+  image: registry.gitlab.com/radiandevcore/tools/gcil/gcil:codestyle
+  needs: []
+  before_script:
+    # Check system context
+    - git cz version -r
+    # Show commits documentation
+    - |
+      (
+        set +x
+        echo ' '
+        for hint in 'example:33' 'info:36' 'schema:32'; do
+          command="${hint%%:*}"
+          color="${hint##*:}"
+          echo '---'
+          echo "git cz ${command}:"
+          echo -e "\033[1;${color}m"
+          git cz "${command}" | sed 's#^$# #g'
+          echo -e '\033[0m '
+        done
+        echo '---'
+      )
+  script:
+    # Detect commits range
+    - set +x
+    - remote=$(git remote -v | grep '(fetch)' | awk '{print $1}' | head -n1)
+    - none_sha='0000000000000000000000000000000000000000'
+    - head_sha=$(git rev-parse "${CI_COMMIT_SHA:-HEAD}")
+    - |
+      if [ ! -z "${CI_MERGE_REQUEST_TARGET_BRANCH_NAME:-}" ]; then
+        git fetch "${remote}" "${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}" >/dev/null 2>&1 || true
+        base_sha=$(git rev-parse "${remote}/${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}")
+        base_branch=$(git rev-parse --abbrev-ref "${remote}/${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}")
+      elif [ ! -z "${CI_LOCAL:-}" ]; then
+        base_sha=$(git rev-parse "${remote}/HEAD")
+        base_branch=$(git rev-parse --abbrev-ref "${remote}/HEAD")
+      elif [ ! "${CI_COMMIT_BEFORE_SHA:-${none_sha}}" = "${none_sha}" ] && git cat-file -e "${CI_COMMIT_BEFORE_SHA}" 2>/dev/null; then
+        base_sha="${CI_COMMIT_BEFORE_SHA}"
+        base_branch="${CI_COMMIT_REF_NAME:-}"
+      else
+        base_sha=$(git rev-parse 'HEAD^')
+        base_branch=$(git rev-parse --abbrev-ref 'HEAD')
+      fi
+    # Validate commits range
+    - |
+      set +x
+      echo ' '
+      echo '---'
+      echo -e "\033[0m\033[1mINFO: Commitizen checks from \033[1m'\033[1;36m${base_sha:0:8}\033[0m\033[1m' (\033[1;33m${base_branch}\033[0m\033[1m) to '\033[1;36m${head_sha:0:8}\033[0m\033[1m' (\033[1;33mHEAD\033[0m\033[1m)\033[0m"
+      echo ' '
+      git log --pretty=oneline --abbrev-commit "${base_sha}..${head_sha}" | sed "s#^\([^ ]*\) #$(printf '\033[1;33m')\1$(printf '\033[0m') #g"
+      echo ' '
+      set -x
+      git cz --no-raise 3 check --rev-range "${base_sha}..${head_sha}"
+
+lint:
+  stage: prepare
+  image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:codestyle
+  needs: []
+  script:
+    - pylint --errors-only ./.hooks/*.py ./src/ ./setup.py
+    - pylint --disable=missing-docstring --load-plugins=pylint.extensions.no_self_use ./.hooks/*.py ./src/ ./setup.py
+  rules:
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+      changes:
+        - 'CHANGELOG.md'
+        - '.hooks/**/*'
+        - 'requirements/**/*'
+        - 'setup.py'
+        - 'src/**/*'
+    - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != $CI_DEFAULT_BRANCH
+      when: on_success
+
+typings:
+  stage: prepare
+  image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:codestyle
+  needs: []
+  variables:
+    MYPY_CACHE_DIR: /dev/null
+    MYPY_FORCE_COLOR: 1
+    TERM: ansi
+  script:
+    - set +x
+    - |
+      if [ $(git rev-list --count HEAD) -gt 1 ]; then
+        mypy --follow-imports silent --pretty $(git diff --name-only $(git diff --exit-code >/dev/null && echo 'HEAD^' || echo 'HEAD') ./.hooks/*.py ./src/ ./setup.py) 2>/dev/null || true
+      fi
+    - sleep 1
+    - mypy --follow-imports silent --pretty ./.hooks/*.py ./src/ ./setup.py
+  rules:
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+      changes:
+        - 'CHANGELOG.md'
+        - '.hooks/**/*'
+        - 'requirements/**/*'
+        - 'setup.py'
+        - 'src/**/*'
+    - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != $CI_DEFAULT_BRANCH
+      when: on_success
+
+# =============================================================================
+# Stage: build
+
+build:
+  stage: build
+  image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:build
+  needs:
+    - job: codestyle
+      artifacts: false
+    - job: commits
+      artifacts: false
+    - job: lint
+      artifacts: false
+    - job: typings
+      artifacts: false
+  script:
+    - rm -rf ./build ./dist ./*.egg-info ./.eggs
+    - python3 -m build
+  after_script:
+    - rm -rf ./build ./*.egg-info ./.eggs
+  rules:
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+      changes:
+        - 'CHANGELOG.md'
+        - 'requirements/**/*'
+        - 'src/**/*'
+    - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != $CI_DEFAULT_BRANCH
+      when: on_success
+  artifacts:
+    paths:
+      - dist/
+
+install:
+  stage: build
+  image: local:quiet
+  script:
+    - pipx uninstall $(ls -1 ./dist/*.whl | cut -d'/' -f3 | cut -d'-' -f1) || true
+    - pipx install --force ./dist/*.whl
+  rules:
+    - if: $CI_LOCAL
+
+readme:
+  stage: build
+  image: local:silent
+  script:
+    - |
+      export COLUMNS=120
+      mkdir -p ./.tmp/
+      PROJECT_PACKAGE=$(grep '^PROJECT_PACKAGE =' ./setup.py | cut -d"'" -f2)
+      {
+        echo ''
+        echo '```yaml'
+        alignments='[ ]\{2,\}'
+        argument='[[:alnum:]][[:alnum:]_-]\{0,\}'
+        letter='[[:alnum:]_]\{1\}'
+        parameter='[-]\{1,2\}[[:alnum:]][[:alnum:]_-]\{0,\}'
+        separator='--'
+        word='[[:alnum:]_-]\{1,\}'
+        help="[(]\{0,1\}${word}"
+        "${PROJECT_PACKAGE}" --help \
+          | sed '1d; $d' \
+          | sed "s/^\(  ${parameter} \[${word}\]${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${parameter}\( ${word}\)\{1,\}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${parameter}\( ${word}\)\{1,\}, ${parameter}\( ${word}\)\{1,\}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${parameter}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${parameter}, ${parameter}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${separator}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${argument}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${alignments}\)\(${help}\)/\1# \2/g"
+        echo '```'
+        echo ''
+      } >./.tmp/README.help.tmp
+    - |
+      lead='^<!-- readme-help-start -->$'
+      tail='^<!-- readme-help-stop -->$'
+      sed -i "/${lead}/,/${tail}/{ /${lead}/{ p; r ./.tmp/README.help.tmp
+        }; /${tail}/p; d }"  ./README.md | head -n 100
+    - rm -f ./.tmp/README.help.tmp
+    - |
+      git -c color.diff=always --no-pager diff ./README.md | grep --color=never '.' && echo ''
+      echo  ' > README: Updated successfully'
+      git diff --quiet ./README.md
+  rules:
+    - if: $CI_LOCAL
+
+# =============================================================================
+# Stage: deploy
+
+deploy:release:
+  stage: deploy
+  image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:deploy
+  needs:
+    - job: build
+  variables:
+    TWINE_PASSWORD: ${TWINE_PASSWORD}
+  before_script:
+    # Validate protected tag
+    - if [ ! "${CI_COMMIT_REF_PROTECTED}" = 'true' ]; then echo '[ERROR] Please protect this tag...'; exit 1; fi
+  script:
+    # Extract tag changelog
+    - tag=${CI_COMMIT_REF_NAME:-$(git describe --always --abbrev=0)}
+    - |
+      description=$(
+        sed -n "
+          /^## \[${tag}\]/,/^## \[/{
+            n; :a; n; h;
+            /^$/{
+              n; H;
+              /^$/{
+                n; H;
+                /^<a name=/{ q; };
+              };
+              g;
+            };
+            p; ba;
+          }" ./CHANGELOG.md \
+        | sed -z 's/"/\\"/g'
+      )
+    # Create tag release
+    - |
+      description="${description}"$'\n\n''### Download'$'\n'
+      gitlab-release --description "${description}" --link-prefix '* ' ./dist/*
+    # Deploy package release
+    - twine upload -u '__token__' -p "${TWINE_PASSWORD}" ./dist/*
+  rules:
+    - if: $CI_COMMIT_TAG
+
+deploy:trial:
+  stage: deploy
+  image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:deploy
+  needs:
+    - job: build
+  variables:
+    TWINE_PASSWORD_TEST: ${TWINE_PASSWORD_TEST}
+  script:
+    # Deploy package release
+    - twine upload -u '__token__' -p "${TWINE_PASSWORD_TEST}" --repository testpypi ./dist/*
+  rules:
+    - if: $CI_LOCAL
+  when: manual