Automatic package release upon pull request merge
AutoPub enables project maintainers to release new package versions to PyPI by merging pull requests.
AutoPub is intended for use with continuous integration (CI) systems such as GitHub Actions, CircleCI, or Travis CI. Projects used with AutoPub can be published via Poetry or setuptools. Contributions that add support for other CI and build systems are welcome.
AutoPub settings can be configured via the
[tool.autopub] table in the target project’s
pyproject.toml file. Required settings include Git username and email address:
[tool.autopub] git-username = "Your Name" git-email = "firstname.lastname@example.org"
Contributors should include a
RELEASE.md file in their pull requests with two bits of information:
- Release type: major, minor, or patch
- Description of the changes, to be used as the changelog entry
Release type: patch Add function to update version strings in multiple files.
autopub sub-commands can be used as steps in your CI flows:
autopub check: Check whether release file exists.
autopub prepare: Update version strings and add entry to changelog.
autopub build: Build the project.
autopub commit: Add, commit, and push incremented version and changelog changes.
autopub githubrelease: Create a new release on GitHub.
autopub publish: Publish a new release.
For systems such as Travis CI in which only one deployment step is permitted, there is a single command that runs the above steps in sequence:
autopub deploy: Run
publishin one invocation.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.