name: Release

on:

schedule:

- cron: '0 0 * * 1' # Auto-release every Monday at midnight UTC

workflow_dispatch: # Manual trigger for quick fixes

jobs:

release:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v2

with:

fetch-depth: 0

- name: Python Semantic Release

uses: relekang/python-semantic-release@master

with:

github_token: ${{ secrets.GITHUB_TOKEN }}

pypi_token: ${{ secrets.PYPI_TOKEN }}

Releases

A release workflow is triggered every Monday and automatically creates a new

release if any commits merged to the main branch contain commit message scopes

that would result in a semantic version bump.

Additionally, the release workflow can be run manually to publish urgent fixes,

either on GitHub or using the ``gh`` CLI with ``gh workflow run release.yml``.

**Note:** As a maintainer, this means you should carefully review commit messages

used by contributors in their pull requests. If scopes such as ``fix`` and ``feat``

are applied to trivial commits not relevant to end users, it's best to squash their

pull requests and summarize the addition in a single conventional commit.

This avoids triggering incorrect version bumps and releases without functional changes.

The release workflow uses `python-semantic-release

<https://python-semantic-release.readthedocs.io>`_ and does the following:

* Bumps the version in ``__version__.py`` and adds an entry in ``CHANGELOG.md``,

* Commits and tags the changes, then pushes to the main branch as the ``github-actions`` user,

* Creates a release from the tag and adds the changelog entry to the release notes,

* Uploads the package as assets to the GitHub release,

* Uploads the package to PyPI using ``PYPI_TOKEN`` (configured as a secret).

[tool.semantic_release]

version_variable = "gitlab/__version__.py:__version__"

commit_subject = "chore: release v{version}"

commit_message = ""