tomte 0.6.2

A library that wraps many useful tools (linters, analysers, etc) to keep Python code clean, secure, well-documented and optimised.

tomte

A library that wraps many useful tools (linters, analysers, etc) to keep Python code clean, secure, well-documented and optimised.

Essentially does nothing else but pinning multiple packages to compatible versions, for consistency across many projects and simplicity of use.

Extremely (!) opinionated by design!

Wrapped tools

• black
• bandit
• isort
• flake8
• mypy
• safety
• darglint
• vulture
• pylint
• docs (various mkdocs libraries)
• tests (various pytest libraries)
• tox
• liccheck

To install, for instance black, simply specify tomte[black]==VERSION, where VERSION is the latest version, and then use black CLI as required.

Development:

Install deps:

Install poetry. Install development dependencies before running maintenance scripts:

poetry install --with dev

Upgrading versions

Use the script directly (fully automated, no manual pin editing):

1. Run poetry run python bump_to_latest.py

This command automatically:

• Resolves latest compatible versions for <4,>=3.10 support.
• Applies strict == pins with Poetry.
• Falls back to the highest resolver-compatible version when the absolute latest conflicts.
• Bumps package version (patch by default) in pyproject.toml, tomte/__init__.py, and tests/test_tomte.py.
• Regenerates poetry.lock.

Useful flags:

• --dry-run
• --bump-version none|patch|minor|major
• --no-lock

Name

"The Swedish hustomte (house elf/gnome) is a quiet little guy, dressed mostly in gray and red, living at your house or farmsted helping out by taking care of things around the house and keep everyone safe."

"A tomte and his son enjoying quiet company of the cat. Illustration by Rolf Lidberg."

Release guide:

Finish edits and ensure dev dependencies are installed (poetry install --with dev), then run poetry run python bump_to_latest.py, then poetry run pytest -q, then poetry build, then rm -rf dist, then poetry publish --build --username=<username> --password=<password>.