taksonomia 2026.6.25

Taxonomy (Finnish: taksonomia) of a folder tree, guided by conventions.

Taksonomia

Taxonomy (Finnish: taksonomia) of a folder tree, guided by conventions.

Requires Python 3.11 or later.

Install

pip install taksonomia

Optional: for blake3 key function and content hashing support:

pip install blake3

Quickstart

See quickstart/README.md for a step-by-step walkthrough from install to first taxonomy. For a step-by-step guided build with runnable code at every stage, see tutorial/README.md.

Manual

See man taksonomia for the full CLI reference. Install the man page with:

mkdir -p ~/.local/share/man/man1
cp docs/taksonomia.1 ~/.local/share/man/man1/

Bug Tracker

Any feature requests or bug reports shall go to the todos of taksonomia.

Primary Source repository

The main source of taksonomia is on a mountain in Central Switzerland under configuration control (fossil).

Contributions

If you like to share small changes under the repositories license please kindly do so by sending a patchset. You can send such a patchset per email using git send-email.

Support

Please kindly submit issues at https://todo.sr.ht/~sthagen/taksonomia or write plain text email to ~sthagen/[e-mail] to support. Thanks.

Changes

See docs/changes.md for the release history.

Coverage

The test suite maintains full branch coverage. The HTML report (if generated) is in site/coverage/.

SBOM

Runtime dependency information is published in docs/sbom/ in SPDX 3.0 (JSON-LD) and CycloneDX 1.6 (JSON) formats. See docs/sbom/README.md for the component inventory and validation guide.