dtcs 0.1.0__tar.gz

dtcs-0.1.0/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{rs,toml}]
+indent_style = space
+indent_size = 4
+
+[*.yaml]
+indent_style = space
+indent_size = 2

dtcs-0.1.0/.github/workflows/checks.yml

@@ -0,0 +1,47 @@
+name: Checks
+
+on:
+  workflow_call:
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  python:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build and test Python package
+        run: |
+          python -m venv .venv
+          source .venv/bin/activate
+          python -m pip install --upgrade pip
+          python -m pip install maturin pytest
+          maturin develop --features python --locked
+          pytest python/tests -v
+      - name: maturin build (dry run)
+        run: |
+          source .venv/bin/activate
+          maturin build --features python --locked
+
+  rust:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      - name: cargo fmt
+        run: cargo fmt --all -- --check
+      - name: cargo clippy
+        run: cargo clippy --all-targets -- -D warnings
+      - name: cargo test
+        run: cargo test --locked
+      - name: cargo build
+        run: cargo build --locked --all-targets
+      - name: cargo publish (dry run)
+        run: cargo publish --dry-run --locked

dtcs-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,9 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  checks:
+    uses: ./.github/workflows/checks.yml

dtcs-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+env:
+  CARGO_TERM_COLOR: always
+  CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+  MATURIN_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+
+jobs:
+  checks:
+    uses: ./.github/workflows/checks.yml
+
+  publish:
+    needs: checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Verify tag matches crate and Python versions
+        run: |
+          crate_version=$(grep '^version' Cargo.toml | head -1 | cut -d'"' -f2)
+          py_version=$(grep '^version' pyproject.toml | head -1 | cut -d'"' -f2)
+          tag_version="${GITHUB_REF_NAME#v}"
+          if [ "$crate_version" != "$tag_version" ]; then
+            echo "Tag ${GITHUB_REF_NAME} (v${tag_version}) does not match Cargo.toml version ${crate_version}"
+            exit 1
+          fi
+          if [ "$py_version" != "$tag_version" ]; then
+            echo "Tag ${GITHUB_REF_NAME} (v${tag_version}) does not match pyproject.toml version ${py_version}"
+            exit 1
+          fi
+      - name: cargo publish
+        run: cargo publish --locked --token "$CARGO_REGISTRY_TOKEN"
+      - name: Publish Python package to PyPI
+        run: |
+          pip install maturin
+          maturin publish --features python --locked

dtcs-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Rust
+/target/
+**/*.rs.bk
+
+# Editor and OS
+.DS_Store
+*.swp
+*.swo
+*~
+.idea/
+.vscode/
+.cursor/
+*.code-workspace
+
+# Environment
+.env
+.env.*
+
+# Python
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+.eggs/
+dist/
+.python-version
+venv/
+.venv/

dtcs-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contributing to DTCS
+
+Thank you for contributing to the Data Transformation Contract Standard and its reference implementation.
+
+## Specification changes
+
+Normative changes belong in [SPEC.md](SPEC.md). Follow the editorial process documented in:
+
+- [docs/editorial/baseline.md](docs/editorial/baseline.md) — mandatory editorial conventions
+- [docs/editorial/style-guide.md](docs/editorial/style-guide.md) — terminology and prose style
+- [docs/editorial/authoring-guide.md](docs/editorial/authoring-guide.md) — chapter structure and normative language
+- [docs/editorial/review-checklist.md](docs/editorial/review-checklist.md) — pre-publication review
+
+### Normative language
+
+Use RFC 2119 / RFC 8174 keywords (`MUST`, `SHALL`, `SHOULD`, `MAY`, etc.) for requirements.
+
+### Authority
+
+[SPEC.md](SPEC.md) is the single source of truth for semantics, terminology, and conformance. Implementation docs in [docs/implementation/](docs/implementation/) are illustrative unless explicitly normative.
+
+## Implementation changes
+
+The Rust reference crate lives in [src/](src/). Before implementing a module:
+
+1. Read the relevant [SPEC.md](SPEC.md) chapter(s).
+2. Consult [docs/implementation/](docs/implementation/) for architecture and API guidance.
+3. Preserve spec-aligned naming and behavior.
+4. Add tests that exercise spec requirements. See [docs/implementation/testing-plan.md](docs/implementation/testing-plan.md).
+
+### Scope
+
+The initial crate targets parsing, the canonical object model, validation, and diagnostics. Do not add execution, compilation, or runtime features without an agreed milestone. See [docs/implementation/non-goals.md](docs/implementation/non-goals.md).
+
+### Code style
+
+- Run `cargo fmt` and `cargo clippy` before submitting changes.
+- Keep modules aligned with [docs/implementation/crate-layout.md](docs/implementation/crate-layout.md).
+- Prefer conservative behavior when the spec is ambiguous; document open questions with a `TODO` referencing the spec section.
+
+## Pull requests
+
+1. Describe whether the change is specification, implementation, or editorial.
+2. Link related issues or design discussions when available.
+3. Include or update tests for behavioral changes.
+4. Ensure `cargo test` passes.
+
+## Questions
+
+For ambiguous spec language, open an issue with the relevant chapter and section number rather than inventing behavior in code.