Metadata-Version: 2.4
Name: controltree
Version: 0.1.0
Summary: Scaffolding for a production-quality control tree library.
Author: ControlTree Contributors
License: MIT
Keywords: controltree,decision-tree,library
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.26
Requires-Dist: pandas>=2.0
Requires-Dist: scikit-learn>=1.4
Requires-Dist: seaborn>=0.13
Requires-Dist: graphviz>=0.20
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: sphinx>=7.0; extra == "dev"
Dynamic: license-file

# controltree

`controltree` is a small decision-tree toolkit for tabular classification workflows, with support for manual tree-building and automated training workflows.

## Package layout

- `src/controltree/config.py`: package defaults and runtime configuration.
- `src/controltree/schema.py`: shared schema and type definitions.
- `src/controltree/datasets.py`: dataset loading helpers.
- `src/controltree/evaluation.py`: reusable metrics and model evaluation helpers.
- `src/controltree/reporting.py`: reporting and console-formatting helpers.
- `src/controltree/builders.py`: tree-building and training helpers.
- `src/controltree/rendering.py`: tree rendering and visualization support.
- `src/controltree/workflow.py`: higher-level orchestration utilities.

## Installation

```bash
pip install .
```

For local development:

```bash
pip install -e .[dev]
```

## Example Data

The package exposes a `load_titanic()` helper backed by `seaborn.load_dataset("titanic")` for local experimentation and demos.

## Documentation

The repository is set up for Sphinx-based documentation, and the root `README.md` is the canonical package overview.
