dirtree-db 0.1.2

Plain file hierarchical database

[!IMPORTANT] This is a learning project. The code quality is poor, tests are sparse and there're countless mistakes. I'm well aware of that. Please don't use this thing in prod (as if anyone were considering that in the first place).

Dirtree DB

Hierarchical, plain file database-like python library.

"Wow, this thing is stupid." - myself, 2026

Installation & Usage

Installation:

# Requires python 3.11 or newer
pip install dirtree-db

Usage:

from dirtree_db import Database

db = Database("path/to/directory/containing/config/toml")

You will need a config.toml file in the path selected when defining the database, this is a minimal functional example:

[store]
name = "name"

Usage of functions of the Database class and syntax of config.toml are explained in a separate document

There's also nix package available.

If for some reason you want to use it, add this flake input to your flake:

dirtree-db.url = "github:first-non-interesting-username/dirtree-db";

You can then access this package in your flake as:

inputs.dirtree-db.packages.${pkgs.stdenv.hostPlatform.system}.dirtree-db

If the build is too demanding for you, cachix cache is available, paste that into your configuration:

nix.settings = {
  extra-substituters = ["https://dirtree-db.cachix.org"];
  extra-trusted-public-keys = [
    "dirtree-db.cachix.org-1:geR/eeJBzFUNhj3mwjHm1EK/mzXIG/PF3Bg48YlF1ys="
  ];
};