Metadata-Version: 2.4
Name: taksonomia
Version: 2026.6.23
Summary: Taxonomy (Finnish: taksonomia) of a folder tree, guided by conventions.
Author-email: Stefan Hagen <stefan@hagen.link>
Maintainer-email: Stefan Hagen <stefan@hagen.link>
License-Expression: MIT
Project-URL: Documentation, https://codes.dilettant.life/docs/taksonomia
Keywords: developer-tools,fingerprints,validation,verification,sbom,taxonomy
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6.0.3
Requires-Dist: kaava>=2026.6.20
Requires-Dist: msgspec>=0.20.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# Taksonomia

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

![License](docs/badges/license-spdx-mit.svg)
![Country of Origin](docs/badges/country-of-origin-name-switzerland-neutral.svg)
![Export Classification Control Number (ECCN)](docs/badges/export-control-classification-number_eccn-ear99-neutral.svg)
![Configuration](docs/badges/configuration-sbom.svg)

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.

## Manual

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

```sh
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](https://todo.sr.ht/~sthagen/taksonomia).

## Primary Source repository

The main source of `taksonomia` is on a mountain in Central Switzerland under configuration control ([fossil](https://fossil-scm.org/)).

## 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](https://git-send-email.io).

## Support

Please kindly submit issues at https://todo.sr.ht/~sthagen/taksonomia or write plain text email to ~sthagen/taksonomia@lists.sr.ht 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.
