Python template for libraries

Run the following to copy the template to <destination-path>:

pixi exec copier copy --trust --no-cleanup https://github.com/maurosilber/python-lib-template <destination-path>

What's inside?

• A src layout package with a pyproject.toml using hatchling as a build backend.

• A tool.pixi section with environments for linting, testing and building the package.

• Lint with pre-commit using:

  • ruff to check and format Python code,
  • pyright to type-check Python code,
  • taplo to format TOML files,
  • mdformat to format markdown files.

• A GitHub Action, .github/workflows/ci.yml, to test and publish the package. It is:

  • tested for different Python versions,
  • published to PyPI when the commit is tagged.

The --trust flag is needed to run the tasks defined in the _tasks key of copier.yml, which creates a git repository with an initial commit and installs the pre-commit hooks.

The --no-cleanup flag does not delete the repository if there are failures, which can be needed if the pre-commit checks fail.