A semantic-release plugin for Python (with support for both setup.cfg/setup.py and pyproject.toml with e.g. Poetry and uv)

Table of Contents

• Overview
• Requirements
  • Developer Requirements
• This Repository (Shared Common)
• Contributing
• License

Overview

Semantic Release Python is a semantic-release plugin that brings support for managing the version update and publication of PyPi packages. It supports traditional Python projects with a setup.cfg file and also pyproject.toml file with e.g. Poetry and uv.

This plugin requires both Python 3 and a recent version of Node.js to be present. After installing the plugin, a few supporting Python packages will automatically be installed into a virtualenv located at .venv. Using a virtualenv helps to prevent incompatibilities with your current installed software. Before you run any configuration that contains, you must source the virtualenv by running . venv/bin/activate or install the dependencies in this project's requirements.txt through other means prior to utilizing the plugin.

Requirements

If you are simply including this library in your project, all you need is a recent version of Node.js, Node.js >= 18 is sometimes required and is the only version range we actively support. Albeit, it is highly probable that lower versions will work as well depending on the requirements that this project imports.

Developer Requirements

The following versions of Node.js and Python are required for development:

• Node.js >= 18
• Python >= 3.10

Other versions may work, but only the above versions are supported.

License

Copyright © 2020-2021 Megabyte LLC. This project is MIT licensed.