How I publish python packages

The purpose of this post is to give a brief overview of the pieces I’ve got in place to build and publish python libraries. I’m not going to cover any of the steps in much detail though I may in later posts.

Code and testing

The code is hosted on github. Github actions are triggered on each PR and push. The github action config is relatively small:

name: Validate

on: [push, pull_request]

    name: ${ { matrix.python-version } }
    runs-on: ubuntu-latest
        python-version: ["3.6", "3.7", "3.8", "3.9", "3.10.0-alpha.4"]

    - uses: actions/checkout@v2
    - name: Set up Python ${ { matrix.python-version } }
      uses: actions/setup-python@v2
        python-version: ${ { matrix.python-version } }
    - name: Install dependencies
      run: |
        make setup
    - name: Run Tests
      run: |
        make test

A makefile in my repo has a test target which runs some combination of:

I currently target all minor python versions higher than 3.6.


In the package I have a this contains a variable representing the version of my package but also acts as a script that prints out the version number (I use this later in various bash scripts).

"""Module for tracking the version of the library"""
__version__ = "1.0.0"

if __name__ == "__main__":

This version number is also imported from the root of my python package:

from .version import __version__

python packaging

For building and getting the package onto pypi I use flit. So far it’s the simplest tool I’ve found for this and works with a fairly small amount of config.

# pyproject.toml
requires = ["flit_core >=2,<4"]
build-backend = "flit.buildapi"

module = "lagom"
author = "meadsteve"
author-email = ""
classifiers = [
  "License :: OSI Approved :: MIT License",
  "Programming Language :: Python :: 3.6",
  "Programming Language :: Python :: 3.7",
  "Programming Language :: Python :: 3.8",
  "Programming Language :: Python :: 3.9",
  "Topic :: Software Development :: Libraries",
  "Typing :: Typed",

exclude = ["tests/", "scripts/"]

Publish script

Once the build checks have passed on github I have a bash script called that I run locally. This does a few things

Checks for any blocking issues

Sometimes I have something I want to fix before I consider releasing. The master branch may contain breaking changes or be broken. So I don’t forget I create an issue tagged as a release_blocker and use the github api to check there are none of these.

blocking_issues=$(curl ''|jq length)

if [[ "$blocking_issues" -gt 0 ]]; then
  echo "There are $blocking_issues issues that must be fixed before release."
  exit 1

Checks for existing git tags with the version number

I have a git tag for each released version of the software. So before any packaging I check that a tag with the current version doesn’t already exist (this is where from earlier helps).

version=$(pipenv run python lagom/

git fetch --tags

if git tag --list | grep "$version\$";
    echo "Version already released"
    exit 2

Push and tag

Finally if everything was okay then I run the flit command that publishes the package. After this is successful I automatically tag the commit and push this back up to the main github repo.

pipenv run flit publish
git tag -a "$version" -m "$version"
git push origin "$version"
exit 0

And that’s it

I’ve not spent too much time on this flow but it gives me enough automation and tracking to be comfortable in releasing code without too much fuss that I know has been tested.

Thoughts? Comments? Send me a tweet!
Edit this post