dtcs 0.11.0

Reference implementation of the Data Transformation Contract Standard (DTCS)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# Examples

Sample DTCS contracts. **Run commands from the repository root.** PyPI/crates installs do not include this directory — download files with `curl` from GitHub raw URLs or clone the repo.

## First success (no large fixture)

| File | Description |
|------|-------------|
| [minimal.dtcs.yaml](minimal.dtcs.yaml) | Smallest install-check contract (`dtcsVersion: "1.0.0"`) |

```bash
dtcs validate examples/minimal.dtcs.yaml
# → valid
```

## Flagship (0.11 features)

| File | Description |
|------|-------------|
| [customer_pipeline.dtcs.yaml](customer_pipeline.dtcs.yaml) | Filter/project `parameters`, lineage `flow`, `one_of`, explicit ordering |
| [customer_normalize.dtcs.yaml](customer_normalize.dtcs.yaml) | Smaller classic normalize + rule example |

```bash
dtcs validate examples/customer_pipeline.dtcs.yaml
dtcs run examples/customer_pipeline.dtcs.yaml \
  --input tests/fixtures/runtime/customer_pipeline_input.json --json
```

Expected runtime: two active customers with lowercased emails.

## Analysis examples

| Path | Purpose |
|------|---------|
| [analysis/backward_old.yaml](analysis/backward_old.yaml) / [backward_new.yaml](analysis/backward_new.yaml) | Compatibility |
| [analysis/evolution/](analysis/evolution/) | Evolution revisions |
| [analysis/lineage_multi.yaml](analysis/lineage_multi.yaml) | Multi-interface lineage |

```bash
dtcs compat examples/analysis/backward_old.yaml examples/analysis/backward_new.yaml
# Expected: backwardCompatible
```

## Next

- [Getting started](../docs/user/getting-started.md)
- [Writing contracts](../docs/user/writing-contracts.md)
- [Cookbook](../docs/user/cookbook.md)