https://github.com/abichinger/semantic-release-pypi
semantic-release plugin to publish a python package to PyPI
https://github.com/abichinger/semantic-release-pypi
Last synced: about 1 year ago
JSON representation
semantic-release plugin to publish a python package to PyPI
- Host: GitHub
- URL: https://github.com/abichinger/semantic-release-pypi
- Owner: abichinger
- License: mit
- Created: 2020-11-28T20:23:47.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-03-28T13:02:52.000Z (about 1 year ago)
- Last Synced: 2025-03-30T13:08:33.075Z (about 1 year ago)
- Language: TypeScript
- Size: 456 KB
- Stars: 27
- Watchers: 1
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📦🐍 semantic-release-pypi
[semantic-release](https://semantic-release.gitbook.io/semantic-release/) plugin to publish a python package to PyPI
## CI environment
- [Node.js](https://semantic-release.gitbook.io/semantic-release/support/node-version) >= 18.0.0
- Python >= 3.9
## Build System Interfaces
`semantic-release-pypi` support two [build system interfaces](https://pip.pypa.io/en/stable/reference/build-system/#)
- `pyproject.toml` based (Recommended)
- `version` will be set inside `pyproject.toml` - [PEP 621](https://peps.python.org/pep-0621/)
- The build backend can be specified inside `pyproject.toml` (defaults to `setuptools`) - [PEP 518](https://peps.python.org/pep-0518/)
- `setup.py` based (Legacy interface)
- `setuptools` is required, other packaging tools like Poetry or Hatch are not supported when using this interface
- `version` will be set inside `setup.cfg`
- `version` must **not be set** inside `setup.py`
## Steps
| Step | Description
| ---- | -----------
| ```verifyConditions``` |
- verify the environment variable ```PYPI_TOKEN```
- verify ```PYPI_TOKEN``` is authorized to publish on the specified repository
- check if the packages `setuptools`, `wheel` and `twine` are installed
| ```prepare``` | Update the version in `pyproject.toml` (legacy: `setup.cfg`) and create the distribution packages
| ```publish``` | Publish the python package to the specified repository (default: pypi)
## Environment variables
| Variable | Description | Required | Default
| -------- | ----------- | ----------- | -----------
| ```PYPI_TOKEN``` | [API token](https://test.pypi.org/help/#apitoken) for PyPI | true |
| ```PYPI_USERNAME``` | Username for PyPI | false | ```__token__```
| ```PYPI_REPO_URL``` | Repo URL for PyPI | false | See [Options](#options)
## Usage
The plugin can be configured in the [**semantic-release** configuration file](https://github.com/semantic-release/semantic-release/blob/master/docs/usage/configuration.md#configuration). Here is a minimal example:
```json
{
"plugins": [
"@semantic-release/commit-analyzer",
"@semantic-release/release-notes-generator",
"semantic-release-pypi",
]
}
```
Note that this plugin modifies the version inside of `pyproject.toml` (legacy: `setup.cfg`).
Make sure to commit `pyproject.toml` using the `@semantic-release/git` plugin, if you want to save the changes:
```json
{
"plugins": [
"@semantic-release/commit-analyzer",
"@semantic-release/release-notes-generator",
"semantic-release-pypi",
[
"@semantic-release/git",
{
"message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}",
"assets": ["pyproject.toml"]
}
]
]
}
```
Working examples using Github Actions can be found here:
- [semantic-release-pypi-pyproject](https://github.com/abichinger/semantic-release-pypi-pyproject)
- [semantic-release-pypi-setup](https://github.com/abichinger/semantic-release-pypi-setup)
## Options
| Option | Type | Default | Description
| ------ | ---- | ------- | -----------
| ```srcDir``` | str | ```.``` | source directory (defaults to current directory)
| ```distDir``` | str | ```dist``` | directory to put the source distribution archive(s) in, relative to ```srcDir```
| ```repoUrl``` | str | ```https://upload.pypi.org/legacy/``` | The repository (package index) to upload the package to.
| ```pypiPublish``` | bool | ```true``` | Whether to publish the python package to the pypi registry. If false the package version will still be updated.
| ```gpgSign``` | bool | ```false``` | Whether to sign the package using GPG. A valid PGP key must already be installed and configured on the host.
| ```gpgIdentity``` | str | ```null``` | When ```gpgSign``` is true, set the GPG identify to use when signing files. Leave empty to use the default identity.
| ```envDir``` | string \| ```false``` | ```.venv``` | directory to create the virtual environment in, if set to `false` no environment will be created
| ```installDeps``` | bool | ```true``` | wether to automatically install python dependencies
| ```versionCmd``` | string | ```undefined``` | Run a custom command to update the version (e.g. `hatch version ${version}`). `srcDir` is used as working directory. `versionCmd` is required if the version is set [dynamically](https://packaging.python.org/en/latest/specifications/pyproject-toml/#dynamic)
## Development
### Pre-requisites
- pyenv >= 2.1.0
```shell
source init.sh
```
### Contribute
- Fork from this repository
- Run `source init.sh`
- Add your changes
- Make sure your code passes all unit tests by running `yarn test`
- Run `yarn lint` to ensure your code adheres to the linting rules
- Issue a PR
## Alternatives
[Python Semantic Release](https://github.com/python-semantic-release/python-semantic-release)