This release is a pre-release and may not be stable for production use.
AutoPub
AutoPub enables project maintainers to release new package versions to PyPI by merging pull requests.
Environment
AutoPub is intended for use with continuous integration (CI) systems such as GitHub Actions, CircleCI, or Travis CI. Projects used with AutoPub are built via build and published via Twine. Contributions that add support for other CI and build systems are welcome.
Configuration
AutoPub settings can be configured via the [tool.autopub] table in the target project's pyproject.toml file or via environment variables.
Git Configuration
You can configure the git username and email used for release commits in three ways:
1. Via pyproject.toml (recommended for project-specific settings)
[tool.autopub.plugin_config.git]
git-username = "Your Name"
git-email = "your_email@example.com"
2. Via environment variables (recommended for CI/CD)
export GIT_USERNAME="release-bot[bot]"
export GIT_EMAIL="123456+release-bot[bot]@users.noreply.github.com"
Environment variables take precedence over pyproject.toml configuration.
3. Default values
If neither environment variables nor pyproject.toml configuration is provided, autopub will use:
- Username:
autopub - Email:
autopub@autopub
Legacy Configuration
For backward compatibility, the old configuration format is still supported:
[tool.autopub]
git-username = "Your Name"
git-email = "your_email@example.com"
However, this format is deprecated and will be removed in a future release. Please migrate to the plugin_config format shown above.
Release Files
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
Example:
Release type: patch
Add function to update version strings in multiple files.
Usage
The following 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: Runprepare,build,commit,githubrelease, andpublishin one invocation.
Release files for autopub 1.0.0a62
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| autopub-1.0.0a62.tar.gz | 25.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| autopub-1.0.0a62-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 56.6 kB
Release files / autopub-1.0.0a62.tar.gz
| Download URL | autopub-1.0.0a62.tar.gz |
|---|---|
| Size | 25.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4e79154ff795f8b30c62012c05f84c915f0f62d7ddabbdd0860d514ba2c26d57
|
|
BLAKE2b-256 checksum How to use checksums |
46791aab171cdf176874e95235c4d1c7d6d20257ace4879532942f6ca81d4592
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.22 {"installer":{"name":"uv","version":"0.11.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / autopub-1.0.0a62-py3-none-any.whl
| Download URL | autopub-1.0.0a62-py3-none-any.whl |
|---|---|
| Size | 31.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
20e0eb1c2b6cf35a5778489853094253fddb61a476e0e21fefb02ad7847ca646
|
|
BLAKE2b-256 checksum How to use checksums |
ef8dc8a79be02629dcfca4107680ea65086205c091555e5807655e030942348e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.22 {"installer":{"name":"uv","version":"0.11.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
