A better poetry publish experience.
Project description
🗞 Publicator
A better
poetry publish
experience.
While Poetry finally brings us a sane solution for publishing and maintaining Python packages, many developers crave for a more enhanced and safer user experience. Publicator aims to offer a convenient method for publishing your everyday libraries.
Publicator has been inspired by Sindre Sorhus' excellent np
package for Node.js ecosystem and graciously funded by Futurice Spice Program.
Table of Contents
Features
- Ensures you are publishing from your release branch (
main
andmaster
by default) - Ensures the working directory is clean and latest changes are pulled
- Reinstalls dependencies to ensure your project works with the latest dependency tree
- Ensures your Python version is supported by the project and its dependencies
- Runs the tests with custom test script
- Bumps the version in
pyproject.toml
and creates a Git tag based on it - Publishes the new version to Python Package Index or custom repository
- Pushes commits and tags (newly & previously created) to your Git server
- If the project is hosted on GitHub opens a prefilled GitHub Releases draft after publishing
- Fully configurable via command-line arguments or the
pyproject.toml
file - See what will be executed with preview mode, without pushing or publishing anything remotely
Prerequisites
- Python 3.8 or later
- Poetry 1.1 or later
- Git 2.11 or later
Install
Install or run directly using pipx
, which manages an isolated virtual environment for you.
pipx install publicator
pipx run publicator <version>
Alternatively, add it as dependency to your Poetry project.
poetry add --dev publicator
poetry run publicator <version>
Usage
Publicator takes one command-line argument indicating the suitable version bump. It follows semantic versioning rules accurately.
# Release a new patch version (e.g. 1.0.0 -> 1.0.1)
publicator patch
# Release a new minor version (e.g. 1.0.1 -> 1.1.0)
publicator minor
# Release a new major version (e.g. 1.1.0 -> 2.0.0)
publicator major
Run publicator --help
to see the full list of supported options:
$ publicator --help
Usage: publicator [OPTIONS] version
Handles publishing a new Python package via Poetry safely and conveniently.
Arguments:
version can be a valid semver or one of: patch, minor, major, prepatch,
preminor, premajor, prerelease [required]
Options:
-V, --version
--repository name Custom repository for publishing (must be
specified in pyproject.toml)
--any-branch / --no-any-branch Allow publishing from any branch [default:
no-any-branch]
--clean / --no-clean Ensure you're working with the latest
changes [default: clean]
--tag / --no-tag Create a new tag for Git [default: tag]
--publish / --no-publish Publish the package to the registry
[default: publish]
--push / --no-push Push commits and tags to Git [default:
push]
--test-script TEXT Name of the test script to run under the
current virtual environment [default:
pytest -x --assert=plain]
--template TEXT Commit message template (`%s` will be
replaced with the new version tag)
[default: release: %s]
--release-draft / --no-release-draft
Opens a pre-filled GitHub release page with
browser if the current project is hosted on
GitHub [default: release-draft]
--install-completion [bash|zsh|fish|powershell|pwsh]
Install completion for the specified shell.
--show-completion [bash|zsh|fish|powershell|pwsh]
Show completion for the specified shell, to
copy it or customize the installation.
--help Show this message and exit.
Configuration
Publicator follows the pleasantly Pythonic way of specifying the configuration within pyproject.toml
file. Below are the default configuration values.
[tool.publicator]
any-branch = false
clean = true
publish = true
push = true
release-draft = true
tag = true
template = "release: %s"
Values passed as command-line arguments take precedence over configuration file values.
Configuration enables for more granular usage. For example, in CI/CD pipelines you might want to disable publishing the package to registry or disable creating Git tags depending on your use case.
Preview Mode (Dry-Run)
If you'd rather skip on everything and check what would be executed, you can activate a preview mode via environment variable like so:
PUBLICATOR_PREVIEW=true publicator <version>
Shell Completion
Publicator stands on the shoulders of Typer, which is a robust CLI library for Python. You can generate TAB completions for common shells such as Bash, ZSH, Fish, and Powershell.
publicator --install-completion <shell>
Contributing
See here for instructions.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file publicator-1.3.0.tar.gz
.
File metadata
- Download URL: publicator-1.3.0.tar.gz
- Upload date:
- Size: 11.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.2.0 CPython/3.10.6 Darwin/21.6.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0b126146b5307df5433c6b929d32ae2af6ecba4fa90cd65bb50d05a02dbab28b |
|
MD5 | b25b3eb013ced8a08f9ea3d64cd41092 |
|
BLAKE2b-256 | 4034a9d4e9efe7891c556f04ba3f4d715f26b6c1c799e568a4cdaca178885126 |
File details
Details for the file publicator-1.3.0-py3-none-any.whl
.
File metadata
- Download URL: publicator-1.3.0-py3-none-any.whl
- Upload date:
- Size: 10.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.2.0 CPython/3.10.6 Darwin/21.6.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 97e1e6bdc553ca9a5f52602b27202e739cc4c7599a1b06a79d27d5e773e3d123 |
|
MD5 | 165fe92a9f798e5eb2dc67d2ffa6091f |
|
BLAKE2b-256 | 3e22827575dbd6cd44680d637f806227bc40908945fee145f866e807768eff3e |