releasecmd is a release subcommand for setup.py (setuptools.setup). the subcommand create a git tag and push, and upload packages to PyPI.
Project description
releasecmd
Summary
releasecmd is a release subcommand for setup.py (setuptools.setup). The subcommand create a git tag and push, and upload packages to PyPI.
The subcommand class (releasecmd.ReleaseCommand) is implemented as a subclass of setuptools.Command class. The release subcommand will do the followings:
- Find a file that defined the package version (e.g. <package>/__init__.py)
- Create .asc files if --sign option is specified
- Create a git tag from the package version information
- GPG signing to the git tag if --sign option is specified
- Push git tags
- Upload package files to PyPI by using twine
release command options
Options for 'ReleaseCommand' command: --skip-tagging skip a git tag creation --dry-run do no harm --sign make a GPG-signed tag --dir specify a search root directory path. defaults to the current directory. --tag-template specify git tag format. defaults to 'v{version}'. --version specify version manually
Example
$ python setup.py release running release [get the version from ./releasecmd/__version__.py] [create a git tag: v0.0.15] [push git tags] [upload the package to PyPI] ...
prerequisite: package binaries must bein in the dist/ directory.
Specify version manually
You can specify a vesion manually by --version option:
$ python setup.py release --version 0.1.0 [create a git tag: v0.1.0] [push git tags] [upload packages to PyPI]
Create a GPG signed tag and upload packages
$ python setup.py release --sign running release [get the version from ./releasecmd/__version__.py] [create a .asc file for releasecmd-0.1.0.tar.gz] [create a .asc file for releasecmd-0.1.0-py2.py3-none-any.whl] [create a git tag with gpg signing: v0.1.0] [push git tags] [upload packages to PyPI] ...
Skip create a git tag and upload packages
$ python setup.py release --skip-tagging running release [get the version from ./releasecmd/__version__.py] [push git tags] [upload packages to PyPI] ...
Dependencies
- Python 3.5+
- git
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.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size releasecmd-0.4.0-py3-none-any.whl (5.6 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size releasecmd-0.4.0.tar.gz (6.0 kB) | File type Source | Python version None | Upload date | Hashes View |
Close
Hashes for releasecmd-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7ab97e16eaad1ba97e6eeccc3ee839b227302a355e5e68c1d98aa43b58534d09 |
|
MD5 | 48d5a5875112a32d20dbae463402c737 |
|
BLAKE2-256 | a0dca9c486de19123292e0cd481368040509df3b5ce59847066008d71d1d327d |