Bump version

August 6, 2025 ยท View on GitHub

This action bumps package versions based on the repository's commit messages written according to the Conventional Commits specification. It assumes Python, pip and Commitizen are already setup, see the setup Python action and setup Commitizen action for ready to use actions to do this.

Action inputs

InputDescriptionDefault
prereleaseOptional prerelease identifier, supported values include alpha, beta, and rc.''
major_version_zeroSet to true to keep the major version at zero, even for breaking changes.false

Action outputs

  • version: The new version that packages were bumped to.

Example usage

name: Bump version

on:
  push:
    branches:
      - main

jobs:
  bump_version:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
        with:
          fetch-depth: 0

      - name: Setup Python
        uses: dfinity/ci-tools/actions/setup-python@main

      - name: Setup Commitizen
        uses: dfinity/ci-tools/actions/setup-commitizen@main

      - name: Bump version
        id: bump_version
        uses: dfinity/ci-tools/actions/bump-version@main

      - name: Print version
        run: |
          echo "New version: ${{ steps.bump_version.outputs.version }}"