DTCS

Vendor-neutral data transformation contracts in YAML/JSON — the semantics of transforms, not a Spark, Polars, or SQL engine.

Status: Spec 3.0.0 (draft) · Tools 0.13.0 (alpha). Good for validation, compatibility analysis, portable relational profiles, and conformance research — not a production ETL runtime.

Try it

pip install 'dtcs==0.13.0'
dtcs version
# → dtcs 0.13.0
# → spec 3.0.0

Then: Getting started (validate in minutes) · Adoption · Versioning · SPEC

Choose your path

Audience	Start here
New users	getting-started → concepts → writing contracts
Evaluators / architects	adoption/overview · limits · what-dtcs-is-not
Upgrading to 0.13 / Spec 3.0	migration-0.13
Upgrading to 0.12 / Spec 2.0 (historical)	migration-0.12 · Portable Relational 0.12 tables
What DTCS is not	what-dtcs-is-not
Contributors	CONTRIBUTING · architecture
Spec authors	editorial/baseline · SPEC

Documentation map

Tutorials

Document	Description
getting-started	Install, validate, and run without cloning
concepts	COM → validate → plan → run
writing-contracts	Contract structure and catalog
cookbook	Short recipes

Guides

Document	Description
versioning	Crate vs Spec vs dtcsVersion
cli-guide	Commands, flags, exit codes
expressions	Expression language and null tokens
compatibility	Compatibility classifications
json-output	JSON envelopes
ci-integration	Adopter CI gates
conformance	Conformance profiles
error-taxonomy	Raises vs diagnostics vs exit codes
diagnostic-catalog	Common diagnostic codes
extensions-and-registries	Vendor catalogs
migration-0.13	Upgrade to tools 0.13 / Spec 3.0
migration-0.12	Historical: tools 0.12 / Spec 2.0
migration-portable-relational	Historical: 0.12 /1 compatibility tables
migration-0.11	Historical: 0.10.x → 0.11.x
limits	Runtime / deployment limits
what-dtcs-is-not	Design philosophy / boundaries
troubleshooting	Common failures
faq	FAQ
glossary	Terms

Adoption · API · Spec

Area	Links
Adoption	overview · what DTCS is not · security checklist · SECURITY.md
API	Python · Rust · WASM · Node
Spec	SPEC · completeness · portable conformance · CHANGELOG · ROADMAP

Contribute (reference implementers)

Document	Description
implementation index	Implementer docs
architecture	Layers and bindings
release-runbook	Maintainer releases
editorial/baseline	Spec authoring process

Preview this site locally

pip install -r docs/requirements.txt
NO_MKDOCS_2_WARNING=true mkdocs serve

Configuration: mkdocs.yml · .readthedocs.yaml.