Skip to main content

Publishing a new version of your Python package has never been easier

Project description

Puprelease

Publishing a new version of your Python package has never been easier:

Screencast of pup making a new release

Installation

$ pip install puprelease

This will get you the latest version on PyPI

Usage

In the root directory of the package you want to release a new version of (where your setup.py file is located):

$ pup

Then follow along with the program.

Git tags for versioning

We recommend using git tags as the single-source-of-truth for package versions.

To do this, add the following lines to your setup.py, replacing the version=... argument of the setup() call:

setup(
    ...
    setup_requires=["setuptools_scm"],
    use_scm_version={
        "version_scheme": "post-release",
        "local_scheme": "dirty-tag",
    },  # Example configuration.
        # See the docs [*] for other options.
)

[*] setuptools_scm documentation.

Then call pup, which will take care of the rest, for each new release.

Also, check-out semantic versioning.

Supported by

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