Skip to main content

python-semantic-release

Automatic semantic versioning for python projects. This is an python implementation of the semantic-release for js by Stephan Bönnemann. If you find this topic interesting you should check out his talk from JSConf Budapest.

Build status PyPI version

Install

pip install python-semantic-release

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.
  --post   If used with the changelog command, the changelog will be posted to the release api.
  --retry  Retry the same release, do not bump.
  --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.

  • changelog - Generates the changelog for the next release.

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 would semantic-release <command>.

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

Configuration

Configuration belongs in semantic_release section of the setup.cfg file in your project. Details about configuration options can be found in the configuration documentation.

Metadata

Release files for python-semantic-release-pypi 3.11.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-semantic-release-pypi 3.11.2
File Size Uploaded Provenance Actions
python-semantic-release-pypi-3.11.2.tar.gz 18.3 kB Without provenance Details for python-semantic-release-pypi-3.11.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-semantic-release-pypi 3.11.2
File Interpreter ABI Platform Actions
python_semantic_release_pypi-3.11.2-py2.py3-none-any.whl Python 2, Python 3 none any Details for python_semantic_release_pypi-3.11.2-py2.py3-none-any.whl

Total release size: 46.9 kB

Release files / python-semantic-release-pypi-3.11.2.tar.gz

Download URL python-semantic-release-pypi-3.11.2.tar.gz
Size 18.3 kB
Tags Source
SHA-256 checksum
How to use checksums
291ebcb1e11cbd2f83ea25e74eacab199dbb719f90b1e35aa39c8ad69f8e809d
BLAKE2b-256 checksum
How to use checksums
445f74ca15fddcd7a72a2e4741e0699377dd913a84b2e3600df987957762c5c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Release files / python_semantic_release_pypi-3.11.2-py2.py3-none-any.whl

Download URL python_semantic_release_pypi-3.11.2-py2.py3-none-any.whl
Size 28.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
d05eda720121316ff85ca32d644db6641684d10866b697b35ecf65eb465fb2bc
BLAKE2b-256 checksum
How to use checksums
f9fc1b3bb2ab667f7d5f2727c3033d000c64321c426a29ae9b31b26831d382ec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Security for python-semantic-release-pypi 3.11.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.11.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page