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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# Cookbook

Short recipes. Run clone-relative paths from the repository root (PyPI installs do not ship `examples/`).

## CI: fail on invalid contracts

```bash
dtcs validate contracts/**/*.dtcs.yaml --json
# Exit 0 = no error diagnostics
```

See [ci-integration.md](ci-integration.md).

## CI: compatibility gate

```bash
dtcs compat old.dtcs.yaml new.dtcs.yaml --json
```

Accept only levels you intend (often `identical` / `backwardCompatible`). See [compatibility.md](compatibility.md).

## Download + validate without cloning

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

## Run the 0.11 flagship pipeline

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

Expected: two `customer_clean` rows (`status: active` only), lowercased emails.

## Null / missing / invalid tokens

```python
import dtcs, json
# Prefer asserting token shape, not coercing to None
row = {"email": {"$dtcs": "missing"}}
assert row["email"]["$dtcs"] == "missing"
```

## Vendor registry merge

```bash
dtcs validate contract.dtcs.yaml --registry ./vendor-registry.yaml
```

See [extensions-and-registries.md](extensions-and-registries.md).

## Conformance certification

```bash
dtcs conformance run --profile all --json
```