Skip to content
box

GitHub Action

semantic-poetry

v0 Latest version

semantic-poetry

box

semantic-poetry

Release to GitHub and PyPI with poetry and python-semantic-release

Installation

Copy and paste the following snippet into your .yml file.

              

- name: semantic-poetry

uses: matteo4diani/poetry-semantic-release@v0

Learn more about this action in matteo4diani/poetry-semantic-release

Choose a version

Tests Release

semantic-poetry 🪶

semantic-poetry is a GitHub Action that automates the release of poetry-based Python packages on GitHub and PyPI following semantic versioning and conventional commits standards.

Usage

To use it in your CI:

  1. Generate a PyPI Token from PyPI: https://pypi.org/help/#apitoken
  2. Set your PyPI Token as a repository secret named PYPI_TOKEN: https://docs.github.com/en/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository
  3. For a quick start copy the [tool.semantic_release] section of this pyproject.toml and adjust it to your needs.
  4. For advanced semantic-release configurations: https://python-semantic-release.readthedocs.io/en/latest/configuration.html#configuration

Happy hacking 😼

Tests

Test runs can be found at https://github.com/matteo4diani/poetry-semantic-release-test/actions, which is a sample poetry-based Python project used to test this action.

Tools

This action uses poetry and python-semantic-release.