DTCS — Data Transformation Contract Standard

DTCS is a draft standard and toolkit for writing vendor-neutral data transformation contracts in YAML/JSON — the semantics of transforms, not a Spark, Polars, or SQL engine.

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

Documentation · Getting started · Adoption · Examples · Changelog · Security

Try it (no clone)

Requirements: Python 3.9+ for PyPI wheels, or Rust 1.75+ for cargo install (compile can take several minutes).

pip install dtcs
dtcs version
# → dtcs 0.12.0
# → spec 2.0.0

curl -fsSL https://raw.githubusercontent.com/eddiethedean/dtcs/main/examples/minimal.dtcs.yaml \
  -o contract.dtcs.yaml
dtcs validate contract.dtcs.yaml
# → valid
# → exit 0

Or paste the same file from examples/minimal.dtcs.yaml. Prefer dtcsVersion: "2.0.0"; "1.0.0" remains accepted for compatibility.

Bindings: Python (pip install dtcs), WASM (@eddiethedean/dtcs-wasm), Node (@eddiethedean/dtcs). See docs/api/.

What this repository contains

SPEC.md — normative DTCS 2.0 draft (26 chapters + Appendix A, including Portable Relational)
Reference tools — parse, validate, analyze, plan, optimize, match, compile, and run contracts (Rust CLI + Python; limited WASM/Node surface)


Spec status	Draft (`2.0.0`)
Reference tools	`0.12.0` (alpha) — validator through reference runtime, portable relational profiles, and conformance
Document `dtcsVersion`	`"2.0.0"` preferred; `"1.0.0"` / `"1.0.0-draft"` still accepted

Coverage tables labeled “Covered” or “Complete” mean the reference implementation exercises that draft SPEC area, not that DTCS 2.0 is finalized or production-certified.

Next steps (after `valid`)

Clone for richer examples and fixtures (PyPI wheels do not include examples/ or tests/):

git clone https://github.com/eddiethedean/dtcs.git
cd dtcs
dtcs validate examples/customer_pipeline.dtcs.yaml
dtcs run examples/customer_pipeline.dtcs.yaml \
  --input tests/fixtures/runtime/customer_pipeline_input.json

Goal	Where
Concepts in two pages	docs/user/concepts.md
Versions	docs/user/versioning.md
Write contracts	docs/user/writing-contracts.md
CLI reference	docs/user/cli-guide.md
Upgrade to 0.12 / Spec 2.0	docs/user/migration-0.12.md
Evaluate for your org	docs/adoption/overview.md

Develop from source

Requires Rust + maturin. See CONTRIBUTING.md.

Repository layout

Path	Purpose
SPEC.md	Full DTCS 2.0.0 draft specification
docs/user/	User guides
docs/adoption/	Evaluator / security materials
docs/api/	Python, Rust, WASM, Node API docs
docs/implementation/	Reference implementation design guides
examples/	Sample contracts
src/	Rust crate (`dtcs`)
python/	Python package
ROADMAP.md	Implementation milestones

Contributing

See CONTRIBUTING.md and CODE_OF_CONDUCT.md. Security reports: SECURITY.md. When guidance conflicts with the specification, SPEC.md wins.

License

Licensed under the Apache License, Version 2.0. See LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dtcs-0.12.0.tar.gz (378.5 kB view details)

Uploaded Jul 17, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dtcs-0.12.0-cp39-abi3-win_arm64.whl (2.2 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+Windows ARM64

dtcs-0.12.0-cp39-abi3-win_amd64.whl (2.4 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+Windows x86-64

dtcs-0.12.0-cp39-abi3-win32.whl (2.1 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+Windows x86

dtcs-0.12.0-cp39-abi3-musllinux_1_2_x86_64.whl (2.8 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+musllinux: musl 1.2+ x86-64

dtcs-0.12.0-cp39-abi3-musllinux_1_2_i686.whl (2.8 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+musllinux: musl 1.2+ i686

dtcs-0.12.0-cp39-abi3-musllinux_1_2_armv7l.whl (2.8 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+musllinux: musl 1.2+ ARMv7l

dtcs-0.12.0-cp39-abi3-musllinux_1_2_aarch64.whl (2.7 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+musllinux: musl 1.2+ ARM64

dtcs-0.12.0-cp39-abi3-manylinux_2_28_aarch64.whl (2.5 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+manylinux: glibc 2.28+ ARM64

dtcs-0.12.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+manylinux: glibc 2.17+ x86-64

dtcs-0.12.0-cp39-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl (2.7 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+manylinux: glibc 2.17+ s390x

dtcs-0.12.0-cp39-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (3.0 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+manylinux: glibc 2.17+ ppc64le

dtcs-0.12.0-cp39-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (2.5 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+manylinux: glibc 2.17+ ARMv7l

dtcs-0.12.0-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.whl (2.8 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+manylinux: glibc 2.5+ i686

dtcs-0.12.0-cp39-abi3-macosx_11_0_arm64.whl (2.3 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+macOS 11.0+ ARM64

dtcs-0.12.0-cp39-abi3-macosx_10_12_x86_64.whl (2.4 MB view details)

Uploaded Jul 17, 2026 CPython 3.9+macOS 10.12+ x86-64

File details

Details for the file dtcs-0.12.0.tar.gz.

File metadata

Download URL: dtcs-0.12.0.tar.gz
Upload date: Jul 17, 2026
Size: 378.5 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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}

File hashes

Hashes for dtcs-0.12.0.tar.gz
Algorithm	Hash digest
SHA256	`7298a6a71e8b56077d670cf5d0c40333c5e4f02428d7bf63c3023d9aa0df47fe`
MD5	`422a95c68b39aca6585cd568e5b11377`
BLAKE2b-256	`fc12b3c6fc7ada5198a8d5f580771a9557ad6083f0e87e988f0dab19f43fd1d1`

Algorithm	Hash digest
SHA256	`d159dc0720ff8927d39dbb7ce4865d77f843023f5ebc01cc986f0db79ecfc5d3`
MD5	`cef5f197288be045cbe41f1ae00768b7`
BLAKE2b-256	`27408f8cdf031cb448e3cab5970cb3b52d0945fb25a472600f0f7d172477ab28`

Algorithm	Hash digest
SHA256	`df78a84c953ec0a01c514a2c3a000843f14568dd6e591ebf27de74d0c770ce3c`
MD5	`219fc5f18f2d536900158445afd10171`
BLAKE2b-256	`c39f54e387769b58df55cb9d86e086fd1fcb622b534dafb37358b87e71e44e2b`

Algorithm	Hash digest
SHA256	`07637827ff9b46acaa7d578c3279faae9f1a29449a8d167bde2df825bf697639`
MD5	`1724d740eaa2481e7e9139511b081bef`
BLAKE2b-256	`39296ca8c21ce21d8534cc2623a8880da61a7cb1dfdb77f4f1d85602ade0ff84`

Algorithm	Hash digest
SHA256	`2d8e6fa9756e98c3b14f8dccc8eacb5513af35b62262c2d85e76c6d93d62aed8`
MD5	`236ddb1676d3cfcae7e202bacbe89e9d`
BLAKE2b-256	`233b633116f6d128b731c1ec5c2ebfcca73e825ee465a5346d7e66beba1a780b`

Algorithm	Hash digest
SHA256	`014ff31ffbb5d4d28ebf32d9661131fc8e769b80e12b2fa6f121228f458ee382`
MD5	`ac0596c11b8ced2eb922fe1a55a77250`
BLAKE2b-256	`07aaee59a6a102480b317764369a0979e62b98f7bad81dc4a676e96000325de9`

Algorithm	Hash digest
SHA256	`f2f4a5b4dcf2b03f888e009190fcb38146e7d6dd0cbd4da1410e5cebb8570094`
MD5	`36ddc5bfe158f65c9691c53e62cafa12`
BLAKE2b-256	`d5a976ac198ae262edd6eb11264e3a0e42953d528eb24bea28e9c1c0d1fa23a4`

Algorithm	Hash digest
SHA256	`832bba7b82eb1a437206196307db5efeee531d7b9b8ad3147b3fd5b63ec0b8ea`
MD5	`8917c0bd1af1b48b8c7f3b91da260b17`
BLAKE2b-256	`a16884a0ea3312b0df851420ffcb7497727293a7871bfe913754519339864bb4`

Algorithm	Hash digest
SHA256	`4e7aa1a68cc5deac529649b29da236a93fda8640d26d66aaf3ed479fbbe98743`
MD5	`89fc108a5834310162c3563b9ddd0274`
BLAKE2b-256	`21b8aec591470ba5a91cba859e34e29ac030e7d3a3a8293d07d8f820e6288eb5`

Algorithm	Hash digest
SHA256	`54045c9b68067b9401c2bd610531752a2b7bee254900fd141c5e31ad261c4a72`
MD5	`8326acad03d6d92bcbaa228115de48b6`
BLAKE2b-256	`d9f1d5351c8d3d571491782aedb91dea7b480cea7354ef9699298f2b8ab1e467`

Algorithm	Hash digest
SHA256	`1f4ef1b0f3f1ef96a091be6933ae7129590eb025fefa62d1e8330b75b5d53b75`
MD5	`b95edf2730b1b753913549d52b3fcc88`
BLAKE2b-256	`7454d21d089f848f206f6b57db9b2fafe9e605159ba808e00befbba118445d1d`

Algorithm	Hash digest
SHA256	`b016bf51eca6c3d636dc41854b586bea080b49368201c8c0991eef7774b2ae2b`
MD5	`3b08a9de436df5c85805dcc1a1f2b97e`
BLAKE2b-256	`ede2e1b8333329370829a0afc0128fd553c704b0a200fb83e6cd4b0c002c0909`

Algorithm	Hash digest
SHA256	`65efcc1df80f47d689bc4b9c4488d30938f7efd397485f3c554f9224901b303f`
MD5	`95624a9899c3c7b83c98fd8bebf669b9`
BLAKE2b-256	`8dcfeffbc526f8684c1db01f50022a928012b1c35dcafb5242178ce8ccbda32d`

Algorithm	Hash digest
SHA256	`ff7b19188a2cd4b02e3f2cdb1634f08c65b519d62253d0ebc5b54aea916ef930`
MD5	`39b835190589d7b6fe1cd49ca5e52b34`
BLAKE2b-256	`0c48043a113fb0710698917aa3a7875a35bfeab9853ca0393da41e7a6e3456c9`

Algorithm	Hash digest
SHA256	`4fad75b6a3b310d6a52e308225fd8efffbd37e8cc6da64424317257db7099a30`
MD5	`444ccc24f43b834c0c06227c59ad8aaa`
BLAKE2b-256	`3d12259707fed26510dcce4aa2155953c99d27942ace450e68c0a8d8fc2d99a6`

Algorithm	Hash digest
SHA256	`7e28d075ab5e9c71858f3142c5c14891c75f5da73c8db6b7b581134cde870f01`
MD5	`72e83c43c8c068ddaa29bc23ec204d20`
BLAKE2b-256	`09f3994f1c40a22fcf2e97536cf027b9495adad313f82a8c2133a77003018756`

dtcs 0.12.0

DTCS — Data Transformation Contract Standard

Try it (no clone)

What this repository contains

Next steps (after valid)

Develop from source

Repository layout

Contributing

License

Project links

Key dates

1 maintainer

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed

Next steps (after `valid`)