zest.releaser plugin to call towncrier
Project description
zestreleaser.towncrier
This calls towncrier when releasing a package with zest.releaser. towncrier updates your history file (like CHANGES.rst) based on news snippets. This is for example used by pip.
The plugin will call towncrier --version <package version> --yes. You can get a preview of the result yourself by calling towncrier --version 1.2.3 --draft.
The towncrier command should be on your PATH. The plugin can also find it when it is in the same directory as the fullrelease script (or prerelease/postrelease).
Installation
Install zestreleaser.towncrier with pip:
$ pip install zestreleaser.towncrier
Then you can run fullrelease like you would normally do when releasing a package.
Contribute
Issue Tracker: https://github.com/collective/zestreleaser.towncrier/issues
Source Code: https://github.com/collective/zestreleaser.towncrier
Support
If you are having problems, please let us know by filing an issue.
License
The project is licensed under the GPL.
pyproject.toml example
towncrier needs a configured pyproject.toml file in the root of the package, next to the setup.py. For reference, here is the literal pyproject.toml file from zestreleaser.towncrier:
[tool.towncrier] issue_format = "`Issue #{issue} <https://github.com/collective/zestreleaser.towncrier/issues/{issue}>`_" filename = "CHANGES.rst" directory = "news/" title_format = "{version} ({project_date})" # First underline is used for version/date header. # Second underline is used for the type names (like 'Bug fixes:'). underlines = ["-", ""] [[tool.towncrier.type]] directory = "breaking" name = "Breaking changes:" showcontent = true [[tool.towncrier.type]] directory = "feature" name = "New features:" showcontent = true [[tool.towncrier.type]] directory = "bugfix" name = "Bug fixes:" showcontent = true
Contributors
Maurits van Rees, m.van.rees@zestsoftware.nl
Changelog
1.2.0 (2019-03-05)
New features:
Use ‘python -m towncrier’ when the script is not easily findable. Still check the directory of the fullrelease script first. No longer check the PATH. [maurits] (Issue #17)
Bug fixes:
Do not run sanity checks or run draft during postrelease. [maurits] (Issue #16)
1.1.0 (2019-03-05)
New features:
Rerelease 1.0.3 as 1.1.0, as it contains new features. (Issue #9)
1.0.3 (2019-03-05)
New features:
1.0.2 (2019-03-04)
Bug fixes:
Fixed finding towncrier when sys.argv is messed up. [maurits] (Issue #6)
1.0.1 (2019-02-20)
Bug fixes:
Tell bumpversion to not update the history. [maurits] (Issue #10)
1.0.0 (2019-02-06)
New features:
Warn and ask when towncrier is wanted but not found. [maurits] (Issue #7)
1.0.0b3 (2018-05-17)
New features:
Require towncrier 18.5.0 so we don’t need a package name in the config. [maurits] (Issue #3)
Bug fixes:
First look for towncrier next to the full/prerelease script. Then fall back to looking on the PATH. [maurits] (Issue #4)
1.0.0b2 (2018-05-16)
Bug fixes:
Do not fail when pyproject.toml file is not there. [maurits] (Issue #2)
1.0.0b1 (2018-05-15)
New features:
First release. [maurits] (Issue #1)
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
Hashes for zestreleaser.towncrier-1.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b2c98018744f73b8082fbe28f564a671d77834edc21ba0e51195032d03e0d9e8 |
|
MD5 | 7211f73c1816ab7a850f4ba8076a46e6 |
|
BLAKE2b-256 | 81623536c956bd52e087ac2336b0cf3d424439768c8151cf343e717083945569 |
Hashes for zestreleaser.towncrier-1.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c6d0534c3e6d84ca45cd052c1cdf12665be35caab42a38e607a835aa24555234 |
|
MD5 | 7334500bb2daab61ec191f6d02a03dbc |
|
BLAKE2b-256 | 39efd86e9ccc635aa0be9cb64437c54d2c869efe80abb2e1499eea708666c96b |