An action to build and publish python package to PyPI, TestPyPI or a private wheels repo using poetry.
The version of python to install (default: latest). Use default for a shorter build time.
The version of poetry to install (default: latest).
Required API token to authenticate when uploading package to PyPI (You can find your token here).
The name of a repository where the package will be uploaded. Necessary if you'd like to upload to test PyPi or a private wheels repo. Uploads to official PyPi if not informed.
The URL where the package will be uploaded. Necessary if you'd like to upload to test PyPi or a private wheels repo. Uploads to official PyPi if not informed.
The Username to log in into a repository where the package will be uploaded if using http-basic authentification instead of api token.
The Password to log in into a repository where the package will be uploaded if using http-basic authentification instead of api token.
By default, poetry's build command outputs two formats: wheel and sdist. If you intend to use
only one of them, you may specify that with the build_format
parameter.
This will instruct poetry not to install any developer requirements. this may lead to an overall quicker experience.
Allow poetry pre-release versions to be installed.
An optional space-separated list of debian packages to be installed before building the package
The following will build and publish the python package to the PyPI using the last version of python and poetry. Specify the python package version and dependencies in pyproject.toml
in the root directory of your project.
- name: Build and publish to pypi
uses: JRubics/[email protected]
with:
pypi_token: ${{ secrets.PYPI_TOKEN }}
Python and poetry versions can be specified in inputs as well as the build_format, allow_poetry_pre_release and ignore_dev_requirements.
- name: Build and publish to pypi
uses: JRubics/[email protected]
with:
python_version: "3.7.1"
poetry_version: "==1.0.5" # (PIP version specifier syntax)
pypi_token: ${{ secrets.PYPI_TOKEN }}
build_format: "sdist"
allow_poetry_pre_release: "yes"
ignore_dev_requirements: "yes"
Repository can be changed to TestPyPI or a private wheels repo by specifying repository_name and repository_url.
- name: Build and publish to pypi
uses: JRubics/[email protected]
with:
pypi_token: ${{ secrets.PYPI_TOKEN }}
repository_name: "testpypi"
repository_url: "https://test.pypi.org/legacy/"
Repository authentication can be cahnged to http-basic authentification by specifying repository_username and repository_password instead of pypi_token.
- name: Build and publish to private Python package repository
uses: JRubics/[email protected]
with:
repository_name: "foo"
repository_url: "https://foo.bar/simple/"
repository_username: "username"
repository_password: "password"
Extra debian packages can be installed before building the python package. This is particularly useful for packages that do not need to be included in the base image for this action.
- name: Build and publish to pypi
uses: JRubics/[email protected]
with:
pypi_token: ${{ secrets.PYPI_TOKEN }}
extra_build_dependency_packages: "capnproto libzmq3-dev"
The following will build and publish the python package when project is tagged in the v*.*.*
form.
name: Python package
on:
push:
tags:
- "v*.*.*"
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Build and publish to pypi
uses: JRubics/[email protected]
with:
pypi_token: ${{ secrets.PYPI_TOKEN }}