Skip to main content

Automatic semantic versioning for python projects

Project description

Automatic semantic versioning for python projects. This blogpost explains in more detail.

Install

pip3 install python-semantic-release

Python 2 is currently not supported. See #10 for more information.

Usage

The general idea is to have some sort of tag in commit messages that indicates certain types of changes. If a commit message lack a tag it is ignored. Running release can be run locally or from a CI service.

Usage: semantic-release [OPTIONS] COMMAND

Options:
  --major  Force major version.
  --minor  Force minor version.
  --patch  Force patch version.
  --noop   No-operations mode, finds the new version number without changing it.
  --help   Show this message and exit.

Commands

  • version - Create a new release. Will change the version, commit it and tag it.

  • publish - Runs version before pushing to git and uploading to pypi.

Running commands from setup.py

Add the following to your setup.py and you will be able to run python setup.py <command> as you woul semantic-release <command>.

try:
    from semantic_release import setup_hook
    setup_hook(sys.argv)
except ImportError:
    pass

Configuration

All configuration described here belongs in setup.cfg in a section: semantic-release.

version_variable - The filename and variable name of where the version number is stored, e.g. semantic_release/__init__.py:__version__.

Tags

There are a set of tags used to evaluate the changes from commit messages. They can be configured to meet what you want them to be. The different tags are listed below with their defaults.

  • Major change: major_tag = :boom: :boom:

  • Minor change: minor_tag = :sparkles: :sparkles:

  • Patch change: patch_tag = :bug: :bug:

Project details


Release history Release notifications | RSS feed

This version

0.6.0

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

python_semantic_release-0.6.0-py3-none-any.whl (12.2 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