simplebumpversion 2.0.5

Bump version numbers across several files

Version Bumper

A tool to bump version numbers in project files. It can be used locally or as a GitHub Action.

Features

• Bump minor, or patch versions (semantic versioning)
• Automatically detects version patterns in files
• Option to use Git tags as version source
• Can be used as a GitHub Action or CLI tool

Installation

For now, the tool is only available as a script or Github Actions tool (recommended). I have plans to publish it on pip soon.

Usage

CLI Usage

If you want to bump the version number in setup.py,

Install the package

pip install simplebumpversion

Then, in your code directory:

# Bump patch version (default)
bump-version setup.py # bumps 1.2.3 -> 1.2.4

# Specific bump types
bump-version setup.py --major # bumps 1.2.3 -> 2.0.0
bump-version setup.py --minor # bumps 1.2.3 -> 1.3.0
bump-version setup.py --patch # bumps 1.2.3 -> 1.2.4

# Use Git tag as version, e.g. v0.9-19-g7e2d
bump-version setup.py --git

# Pass several files to update
bump-version setup.py README.md --patch

GitHub Action Usage

name: Bump Version

on:
  push:
    branches: [main]

# give permission to write and push commits
permissions:
  contents: write

jobs:
  bump-version:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0  # Required for git versioning

      - name: Bump version
        uses: Ikromov247/bump_version@v0.9
        with:
          file: 'package.json' # file containing your package version number
          bump_type: 'patch'  # Options: major, minor, patch, git

      - name: Commit changes
        run: |
          git config --local user.email "[e-mail]"
          git config --local user.name "GitHub Action"
          git add .
          git commit -m "Bump version"
          git push

Config file

You can also add your configurations in a yaml file instead of passing them as arguments. If you pass both the config file and the arguments, config file takes precedence and cli arguments will be ignored.

Example configuration file:

name: 'Patch bump' # Configuration name
description: 'Bump the patch version in dummy.py' # description

settings:
  bump_type: patch
  files: # list of files to update
    - setup.py
    - README.md

In cli, pass as an argument: bump-version --config config.yml

In Github Actions workflow file:

- name: Bump version
  uses: Ikromov247/bump_version@v0.9
  with:
    config: bump_config.yml

Supported Version Formats

The tool recognizes uses regex to recognize various version patterns:

• version = "1.2.3"
• VERSION = "1.2.3"
• __version__ = "1.2.3"
• "version": "1.2.3" (for JSON/package.json)

Common errors

• Invalid version format:

  • Reason: the tool could not find the version number. Your version possibly does not match supported patterns.

• File or permission errors:

  • Reason: the tool could not open or write to specified files.
  • Solution: check file paths and permissions.

• Config file is invalid:

  • Reason: your config file does not have required fields.
  • Solution: check the sample config file for reference.

• Major version bumping is not supported:

  • Reason: Bumping major versions is only possible through cli to prevent accidental major version bumps.
  • Solution: Use cli for major version bumps or set a different bump type

• Error occured when reading the git tag:

  • Reason: your repo does not have tags.
  • Solution: create a tag.

Contributing

If you want to contribute, start from checking the todo file and the CONTRIBUTING.MD for rules. To suggest new features, create an issue with the tag enhancement.

License

MIT