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.
Shipped configs
Since 0.7.0, tomte ships canonical linter configurations as packaged resources. Reach them from a tox env (or any tooling) via:
from tomte.configs import PYLINTRC, MYPY_INI, ISORT_CFG, FLAKE8_CFG, DARGLINT_CFG, BANDIT_YAML, SAFETY_POLICY
Each constant is a pathlib.Path to the file inside the installed
wheel. Typical use:
[testenv:pylint]
commands = pylint --rcfile={envsitepackagesdir}/tomte/configs/pylintrc <paths>
tomte tox runtime wrapper
Since 0.7.0, tomte tox renders the canonical tox.ini (shipped at
tomte/configs/tox.ini) at runtime, reading per-repo identity from
[tool.tomte] in the consumer's pyproject.toml and a slim
[tomte-extensions] section in their local tox.ini. The rendered file
is ephemeral — nothing generated lives on disk between runs. Invoke as a
drop-in replacement: tomte tox -e <env>.
Per-repo settings in [tool.tomte] (TOML in pyproject.toml):
packages_paths, pytest_targets[_extra|_exclude],
service_specific_packages[_extra], service_public_id,
known_first_party, open_autonomy_version, open_aea_version,
check_handlers_ignores, check_dependencies_extra_excludes,
upstream_pins, gitleaks_extra_paths, gitleaks_extra_regexes,
safety_ignores, tomte_dep_pin. Most defaults
auto-derive from packages.json.
The safety env scans the repo's locked dependencies: it runs
tomte export-safety-requirements, which pins every released package in
uv.lock (or, failing that, poetry.lock), and the scan reads only that
export, not safety's own virtualenv. A missing or unreadable lock fails
the env. A package locked from git or a URL is checked as the PyPI
release of its version, not as its source, and the export names each one.
safety_ignores takes an advisory id or a list of them and renders them
as --ignore flags on the safety scan, after the fleet baseline in
_FLEET_SAFETY_IGNORES. Add an entry only when the vulnerable code is
unreachable from the repo, and record why alongside it. An unavailable
fix is a reason an entry cannot be retired yet, not a reason to add one.
service_public_id takes a single public id or a list of them, and
[testenv:analyse-service] runs autonomy analyse service once per
entry. Left undeclared, it defaults to every service in packages.json;
in a repo with no services the env is not rendered at all, so
tomte tox -e analyse-service there reports an unknown environment.
Per-repo settings in [tomte-extensions] (raw INI in local tox.ini,
for things that don't fit cleanly in TOML): extra_deps,
extra_pylint_disables, extra_pylint_ignored_modules,
extra_testenvs — multi-line continuation values that configparser
preserves verbatim.
Scope. tomte tox targets AEA agent repos — the homogeneous fleet
that ships packages/valory/ skills + agents + services and bootstraps
via the autonomy CLI. Framework repos (open-aea, open-autonomy)
keep their own hand-written tox.ini and consume the canonical configs
directly (from tomte.configs import PYLINTRC, MYPY_INI, …) via
--rcfile= / --config= flags.
Pytest plugin (opt-in)
Tomte declares a pytest11 entry-point plugin in pyproject.toml that
ships fleet-canonical pytest defaults: the integration and e2e
markers, plus an ignore::DeprecationWarning:aea.*: filter. Pytest
auto-loads pytest11 plugins, so the plugin module is imported in any
environment where tomte is installed — but the plugin is silent by
default; it registers nothing unless the consumer opts in:
# tox.ini (or pyproject.toml [tool.pytest.ini_options], or pytest.ini)
[pytest]
tomte_defaults = true
Truthy spellings: true, 1, yes, on (case-insensitive). Without
opt-in, non-fleet tomte[black] / tomte[mypy] consumers see no
config injection.
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):
- Run
poetry run python bump_to_latest.py
This command automatically:
- Resolves latest compatible versions for
<4,>=3.10support. - 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, andtests/test_tomte.py. - Regenerates
poetry.lock.
Useful flags:
--dry-run--bump-version none|patch|minor|major--no-lock
Name
"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>.
Metadata
Release files for tomte 0.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tomte-0.8.0.tar.gz | 48.6 kB | Without provenance | Details for tomte-0.8.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tomte-0.8.0-py3-none-any.whl | Python 3 | none | any | Details for tomte-0.8.0-py3-none-any.whl |
Total release size: 105.5 kB
Release files / tomte-0.8.0.tar.gz
| Download URL | tomte-0.8.0.tar.gz |
|---|---|
| Size | 48.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
19ee8a33860f20b4299f6500e7ed3df734ef0e2988cc5257d6fa168d45f4c756
|
|
BLAKE2b-256 checksum How to use checksums |
2041caf28f400492fab8c818dd787264cb7fac52e783fabbd2da744aadf846ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Release files / tomte-0.8.0-py3-none-any.whl
| Download URL | tomte-0.8.0-py3-none-any.whl |
|---|---|
| Size | 56.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c0a6bb097179fcd8b51728b35088664ac243acfb4cb836de3317398c2ef464ec
|
|
BLAKE2b-256 checksum How to use checksums |
cb15b09f687b71bb59d4012d36f1b7a353fceb14eada49b75f30687d428ae4be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for tomte 0.8.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.