Skip to main content

Bump version strings in your repo

Project description


Build Status Coverage Status

Primarily a reaction to bumpversion not supporting git hashes -- issue



Usage: version-upper [OPTIONS] COMMAND [ARGS]...

  A tool to update version strings in files using semantic versioning and
  commit hashes.


  # bump commit hash version
  version-upper bump commit_hash

  # bump patch version
  version-upper bump patch

  # bump patch version as release candidate
  version-upper bump patch --release-candidate

  # bump minor version
  version-upper bump minor

  # bump major version
  version-upper bump major

  The config file adheres to the Config Pydantic schema, and is named
  version-upper.json by default.

  Here is a sample config:
      "current_version": "0.0.0",
      "current_semantic_version": "0.0.0",
      "files": []

  --config TEXT  [default: version-upper.json]
  --help         Show this message and exit.

  bump                      Bumps version strings, updates config.
  config-schema             Prints the config schema in JSON
  current-semantic-version  Prints the current semantic version
  current-version           Prints the current version
  release                   Removes rc from the version strings
  sample-config             Prints a sample config


Create a file called version-upper.json (can be overridden using --config) like below:

  "current_version": "0.0.0",
  "current_semantic_version": "0.0.0",
  "files": ["", "app/version.json"]

Be sure to add files to "files" otherwise nothing will be updated :)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

version-upper-0.1.0.tar.gz (9.1 kB view hashes)

Uploaded Source

Built Distribution

version_upper-0.1.0-py3-none-any.whl (9.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page