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.

Files for version-upper, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size version_upper-0.1.1-py3-none-any.whl (9.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size version-upper-0.1.1.tar.gz (9.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page