pyodcs 0.2.0__tar.gz

pyodcs-0.2.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

pyodcs-0.2.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

pyodcs-0.2.0/.github/workflows/ci.yml

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

pyodcs-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,217 @@
+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-crates-io:
+    needs: checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - 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: |
+          set +e
+          output="$(cargo publish --locked --token "$CARGO_REGISTRY_TOKEN" 2>&1)"
+          code=$?
+          echo "$output"
+          if [ "$code" -ne 0 ] && echo "$output" | grep -q "already exists on crates.io index"; then
+            echo "crate already published; skipping"
+            exit 0
+          fi
+          exit "$code"
+
+  build-python-linux:
+    needs: checks
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+            manylinux: 2_28
+          - runner: ubuntu-22.04
+            target: armv7
+          - runner: ubuntu-22.04
+            target: s390x
+          - runner: ubuntu-22.04
+            target: ppc64le
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --features python --locked --compatibility pypi
+          sccache: "true"
+          manylinux: ${{ matrix.platform.manylinux || 'auto' }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-dist-linux-${{ matrix.platform.target }}
+          path: dist/*
+          if-no-files-found: error
+
+  build-python-musllinux:
+    needs: checks
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --features python --locked --compatibility pypi
+          sccache: "true"
+          manylinux: musllinux_1_2
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-dist-musllinux-${{ matrix.platform.target }}
+          path: dist/*
+          if-no-files-found: error
+
+  build-python-windows:
+    needs: checks
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+            python_arch: x64
+          - runner: windows-latest
+            target: x86
+            python_arch: x86
+          - runner: windows-11-arm
+            target: aarch64
+            python_arch: arm64
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          architecture: ${{ matrix.platform.python_arch }}
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --features python --locked --compatibility pypi
+          sccache: "true"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-dist-windows-${{ matrix.platform.target }}
+          path: dist/*
+          if-no-files-found: error
+
+  build-python-macos:
+    needs: checks
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --features python --locked --compatibility pypi
+          sccache: "true"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-dist-macos-${{ matrix.platform.target }}
+          path: dist/*
+          if-no-files-found: error
+
+  build-python-sdist:
+    needs: checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-dist-sdist
+          path: dist/*
+          if-no-files-found: error
+
+  publish-pypi:
+    needs:
+      - build-python-linux
+      - build-python-musllinux
+      - build-python-windows
+      - build-python-macos
+      - build-python-sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: python-dist-*
+          merge-multiple: true
+          path: dist
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Publish Python package to PyPI
+        run: |
+          pip install maturin
+          maturin upload --username __token__ --password "$MATURIN_PYPI_TOKEN" dist/*

pyodcs-0.2.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/

pyodcs-0.2.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+## 0.2.0
+
+First published release.
+
+- Phase 1 skeleton milestone (module stubs, fixtures, CLI tests, exit codes)
+- Rust crate `odcs` and Python package `pyodcs`
+- CI and release workflows
+
+## 0.1.0
+
+Phase 1 — Skeleton (complete).
+
+- Professional repository layout aligned with DTCS conventions
+- Rust crate skeleton with full module tree per `crate-layout.md`
+- Basic YAML and JSON parsing for minimal ODCS contracts
+- Extension field preservation on parse
+- CLI: `validate`, `inspect`, `diagnostics`, `schema`, `version` with `--json`
+- CLI exit codes: 0 valid, 1 validation error, 2 parse/IO failure
+- Expanded fixture suite and integration tests (`tests/skeleton.rs`, `tests/cli.rs`)
+- `pyodcs` Python package with PyO3 bindings
+- CI pipeline (fmt, clippy, test) plus release workflow
+- Documentation reorganized under `docs/implementation/`

pyodcs-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing to ODCS
+
+Thank you for contributing to the Open Data Contract Standard reference implementation.
+
+## Upstream specification
+
+Normative ODCS semantics are defined in the [upstream specification](https://github.com/bitol-io/open-data-contract-standard). This repository's [SPEC.md](SPEC.md) documents how we track and synchronize with upstream releases.
+
+When implementing behavior:
+
+1. Read the relevant upstream ODCS specification sections.
+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).
+
+### Authority
+
+The upstream ODCS specification 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 upstream specification sections.
+2. Consult [docs/implementation/crate-layout.md](docs/implementation/crate-layout.md) for module boundaries.
+3. Preserve spec-aligned naming and behavior.
+4. Add tests for behavioral changes.
+
+### Scope
+
+The initial crate targets parsing, the canonical object model, validation, and diagnostics. Do not add execution, pipeline composition, or transformation 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 implementation, documentation, or infrastructure.
+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 upstream spec language, open an issue with the relevant section rather than inventing behavior in code.