Pivot: High-Performance Python Pipeline Tool
Change your code. Pivot knows what to run.
Pivot is a Python pipeline tool with automatic code change detection. Stages are plain
Python functions; you wire them together by calling them inside a Pipeline block, and
Pivot works out what needs to re-run.
- Automatic code change detection using Python introspection
- No paths in pipeline code: Pivot chooses where every output is stored
- Per-stage lock files for fast parallel writes
- Warm worker pools with preloaded imports
- Content-addressable caching with S3 remote storage
Python: 3.13+ | Platform: Unix (Linux/macOS)
Quick Start
pip install pivot
mkdir my_project && cd my_project
git init && pivot init
Put a raw input under data/raw/:
mkdir -p data/raw
printf 'name,value\nalice,100\nbob,200\ncarol,\n' > data/raw/records.csv
Define stages and the pipeline in pipeline.py:
# pipeline.py
import pandas as pd
from pivot import Pipeline, StageParams, stage
class CleanParams(StageParams):
min_value: int = 0
@stage
def clean(records: pd.DataFrame, params: CleanParams) -> pd.DataFrame:
kept = records.dropna()
return kept[kept["value"] >= params.min_value]
@stage
def summarize(rows: pd.DataFrame) -> dict:
return {"count": len(rows), "total": int(rows["value"].sum())}
with Pipeline("demo") as pipeline:
records = pipeline.input("records.csv")
cleaned = clean(records, params=CleanParams(min_value=50))
summarize(cleaned)
Then run it; Pivot resolves the DAG from the handles passed between stages:
pivot repro # runs clean, then summarize
pivot repro # nothing changed: both stages are cached
pivot repro --watch # re-run automatically on file changes
Pivot writes outputs to data/demo/clean.jsonl and data/demo/summarize.yaml.
Learn More
- Documentation
- Source code
- Interactive TUI:
pip install pivot[tui], thenpivot repro --tui
1 maintainer
Metadata
1 maintainer
Release files for pivot 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pivot-0.4.0.tar.gz | 338.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pivot-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 730.6 kB
Release files / pivot-0.4.0.tar.gz
| Download URL | pivot-0.4.0.tar.gz |
|---|---|
| Size | 338.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ebc8d8f134e4be5c4735448233aa750516388a2581ccf7c5e940a0cb1ac35d64
|
|
BLAKE2b-256 checksum How to use checksums |
00d8a9a8956631204f2c9038ed8bba07906eb295dd9214a0edf598d998bac867
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / pivot-0.4.0-py3-none-any.whl
| Download URL | pivot-0.4.0-py3-none-any.whl |
|---|---|
| Size | 392.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
653d6b0f24b018e9cdbcb6bff321dca8e4e4dc19cd3077ea3d46f03e345a22e7
|
|
BLAKE2b-256 checksum How to use checksums |
10a6c43dca482b3233f28b7c9e43fe239ff7021d734a802164f4b493958eb60a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for pivot 0.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
