Skip to content

Additory

Elegant data operations for DataFrames. Lookup, transform, generate, compare — all through a consistent, expressive API.

v0.1.3a11


Install

pip install additory

Requires Python 3.9+. Works with both polars (required) and pandas (optional).


What can additory do?

:material-table-arrow-left: add.to() — Bring data from one DataFrame to another

Look up columns from a reference table and attach them to your target DataFrame. Supports aggregation, multi-key joins, and list-of-DataFrames patterns.

import additory as add

result = add.to(patients, bring_from=doctors, bring='name', against='doctor_id')

Learn more :material-arrow-right:


:material-swap-horizontal: add.transform() — Reshape data in place

Twelve modes for calculating, filtering, sorting, aggregating, deducing, encoding, and more — all through a single function.

result = add.transform('@calc', df, expression='price * quantity', name='total')

Learn more :material-arrow-right:


:material-flask-outline: add.synthetic() — Generate realistic data

Create new DataFrames from scratch or augment existing ones with synthetic rows. Pipe-friendly.

result = add.synthetic(df, n=500)
result = df.pipe(add.synthetic, n=500)

Learn more :material-arrow-right:


:material-magnify: add.scan() — Inspect and compare

Analyze data quality, track lineage, and compare DataFrames with @diff.

add.scan('@analyze', df)
add.scan('@diff', old=df_jan, new=df_feb)

Learn more :material-arrow-right: · Diff :material-arrow-right:


:material-function-variant: add.<dynamic>() — Call expressions by name

Load named expressions from .add files and call them directly on the module.

add.scan('@set', './my_expressions')
result = add.bmi(df)

Learn more :material-arrow-right:


Explore the docs

Section What you'll find
Getting Started Installation, quickstart walkthrough
Core Functions add.to(), add.transform(), add.synthetic(), add.scan(), add.<dynamic>()
Transform Modes @calc, @filter, @sort, @aggregate, @deduce, and more
Cross-Cutting Features Pipe compatibility, lineage tracking, logging, type handling
Guides Expression files, reconciliation, troubleshooting
Reference Full API signatures, expression catalog, changelog