🧾 disco-tools

Common tools for disco simulation engine.

🧭 Overview

disco-tools is a collection of reusable Python utilities supporting simulation, analytics, and data-driven decision systems.
It provides modular building blocks for working with metadata, scheduling, simulation orchestration, and system integration.

Each tool is designed to be:

• Lightweight — minimal dependencies
• Composable — works as a standalone library or inside larger systems
• Fast — optimized for high-throughput, data-heavy environments

Documentation for individual modules is available in the docs/ folder.

✨ Features

• ⚙️ Label Selector — Fast rule engine for qualifying and filtering metadata.
  → Read documentation ›

• ⚙️ Multi-Process Logging — Safe, queue-based logging across worker processes using Python's QueueHandler + QueueListener.
  → Read documentation ›

• 🪤 errsnap — Capture full post-mortem exception snapshots — including arbitrary runtime state — to a self-contained .errsnap file for offline inspection.
  → Read documentation ›

🚀 Installation

pip install disco-tools

🧰 Development Setup

Clone and install in editable mode:

git clone https://github.com/michielmj/disco-tools.git
cd disco-tools
pip install -e .[dev]

Run all tests:

pytest -q

📚 Documentation

• Label Selector — fast, composable rule engine for key–value metadata
• Multi-Process Logging — process-safe logging via queue-based architecture
• errsnap — post-mortem exception snapshots with state capture

Additional module docs will be added under the docs/ directory as the toolkit evolves.

🧪 Example Usage

from disco_tools.label_selector import Label, qualifies

rule = (Label("env") == "prod") + Label("version").gte(10)
meta = {"env": "prod", "version": 12}

if qualifies(meta, rule):
    print("Match!")

🧾 License

Apache 2.0 License © 2025 — part of the disco-tools project.