siderust 0.2.1__tar.gz

siderust-0.2.1/.github/workflows/ci.yml

@@ -0,0 +1,244 @@
+name: Siderust Python CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+env:
+  CARGO_TERM_COLOR: always
+  PACKAGE_NAME: siderust
+  MATURIN_VERSION: v1.15.0
+
+jobs:
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+          cache: pip
+      - name: Install formatter
+        run: python -m pip install --upgrade pip ruff
+      - name: Check Rust formatting
+        run: |
+          cargo fmt --all -- --check
+          cargo fmt --manifest-path tests/interop_consumer/Cargo.toml -- --check
+      - name: Check Python formatting
+        run: python -m ruff format --check python tests examples scripts
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+          cache: pip
+      - name: Install linters
+        run: python -m pip install --upgrade pip ruff
+      - name: Run clippy
+        run: |
+          cargo clippy --all-targets --all-features -- -D warnings
+          cargo clippy --manifest-path tests/interop_consumer/Cargo.toml --all-targets -- -D warnings
+      - name: Run ruff
+        run: python -m ruff check python tests examples scripts
+
+  rust-test:
+    name: Rust Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - name: Run Rust tests
+        run: cargo test --all-targets
+
+  crates-package:
+    name: crates.io Package Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      - uses: Swatinem/rust-cache@v2
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+      - name: Test release policy guards
+        run: bash scripts/test-publish-release-policy.sh
+      - name: Validate packaged crate and publish dry-run
+        run: bash scripts/publish-release.sh --dry-run
+
+  bridge-contract:
+    name: Bridge Contract (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+          cache: pip
+      - name: Build extensions and run bridge contract
+        run: python scripts/test_interop_contract.py
+
+  python-test:
+    name: Python Test (3.${{ matrix.python-minor }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-minor: ["8", "9", "10", "11", "12", "13", "14"]
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - name: Set up Python 3.${{ matrix.python-minor }}
+        uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.${{ matrix.python-minor }}"
+          cache: pip
+      - name: Install test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pytest
+          python -m pip install .
+          python -m pip install ./tests/interop_consumer
+      - name: Run Python tests
+        run: |
+          tmpdir="$(mktemp -d)"
+          cd "$tmpdir"
+          python -m pytest --rootdir "$GITHUB_WORKSPACE" "$GITHUB_WORKSPACE/tests"
+
+  distribution-package:
+    name: PyPI Distribution Validation
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+
+      - name: Install wheel test dependencies
+        run: python -m pip install --upgrade pip pytest
+
+      - name: Build PyPI-compatible wheel
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          command: build
+          maturin-version: ${{ env.MATURIN_VERSION }}
+          manylinux: "2_28"
+          args: >-
+            --release
+            --compatibility pypi
+            --out dist
+            -i python3.14
+
+      - name: Install built wheel
+        run: python -m pip install --force-reinstall dist/*.whl
+
+      - name: Test installed wheel
+        run: |
+          tmpdir="$(mktemp -d)"
+          cd "$tmpdir"
+          python -m pytest --rootdir "$GITHUB_WORKSPACE" "$GITHUB_WORKSPACE/tests/test_api.py"
+
+      - name: Build source distribution
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          command: sdist
+          maturin-version: ${{ env.MATURIN_VERSION }}
+          args: --out dist
+
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: siderust-release-package
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+          if-no-files-found: error
+          retention-days: 7
+
+  coverage:
+    name: Coverage
+    if: ${{ github.event_name == 'push' || github.event.pull_request.draft == false }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+          cache: pip
+      - name: Install coverage dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pytest pytest-cov
+          python -m pip install .
+          python -m pip install ./tests/interop_consumer
+      - name: Run coverage
+        run: |
+          rm -f coverage.xml
+          rm -rf htmlcov
+          tmpdir="$(mktemp -d)"
+          cd "$tmpdir"
+          python -m pytest \
+            --rootdir "$GITHUB_WORKSPACE" \
+            --cov="${PACKAGE_NAME}" \
+            --cov-branch \
+            --cov-report=term-missing \
+            --cov-report=xml:"$GITHUB_WORKSPACE/coverage.xml" \
+            --cov-report=html:"$GITHUB_WORKSPACE/htmlcov" \
+            "$GITHUB_WORKSPACE/tests"
+      - name: Upload coverage artifacts
+        if: always()
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: siderust-coverage
+          path: |
+            coverage.xml
+            htmlcov
+          retention-days: 7

siderust-0.2.1/.github/workflows/release.yml

@@ -0,0 +1,263 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v[0-9]*"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  MATURIN_VERSION: v1.15.0
+
+jobs:
+  validate:
+    name: Validate release
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Verify tag and package metadata
+        shell: python
+        run: |
+          import os
+          import re
+          import tomllib
+          from pathlib import Path
+
+          tag = os.environ["GITHUB_REF_NAME"]
+          if not re.fullmatch(r"v\d+\.\d+\.\d+", tag):
+              raise SystemExit(f"release tag must be vMAJOR.MINOR.PATCH, got {tag!r}")
+
+          pyproject = tomllib.loads(Path("pyproject.toml").read_text())
+          cargo = tomllib.loads(Path("Cargo.toml").read_text())
+
+          python_name = pyproject["project"]["name"]
+          python_version = pyproject["project"]["version"]
+          cargo_version = cargo["package"]["version"]
+
+          if python_name != "siderust":
+              raise SystemExit(
+                  f"expected PyPI project name 'siderust', got {python_name!r}"
+              )
+          if python_version != cargo_version:
+              raise SystemExit(
+                  f"version mismatch: pyproject.toml={python_version}, Cargo.toml={cargo_version}"
+              )
+          if tag != f"v{python_version}":
+              raise SystemExit(
+                  f"tag {tag!r} does not match package version v{python_version}"
+              )
+
+      - name: Validate crate release package
+        run: bash scripts/publish-release.sh --dry-run --tag "${GITHUB_REF_NAME}"
+
+  linux-wheels:
+    name: Linux wheels (${{ matrix.arch }})
+    needs: validate
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-24.04
+            arch: x86_64
+            target: x86_64-unknown-linux-gnu
+          - runner: ubuntu-24.04-arm
+            arch: aarch64
+            target: aarch64-unknown-linux-gnu
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@v7.0.1
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          command: build
+          maturin-version: ${{ env.MATURIN_VERSION }}
+          target: ${{ matrix.target }}
+          manylinux: "2_28"
+          args: >-
+            --release
+            --compatibility pypi
+            --out dist
+            -i python3.8
+            -i python3.9
+            -i python3.10
+            -i python3.11
+            -i python3.12
+            -i python3.13
+            -i python3.14
+
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: wheels-linux-${{ matrix.arch }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  macos-wheels:
+    name: macOS wheels (${{ matrix.arch }})
+    needs: validate
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15-intel
+            arch: x86_64
+            python_versions: |
+              3.8
+              3.9
+              3.10
+              3.11
+              3.12
+              3.13
+              3.14
+          - runner: macos-15
+            arch: aarch64
+            python_versions: |
+              3.11
+              3.12
+              3.13
+              3.14
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@v7.0.1
+
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: ${{ matrix.python_versions }}
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          command: build
+          maturin-version: ${{ env.MATURIN_VERSION }}
+          args: >-
+            --release
+            --compatibility pypi
+            --out dist
+            --find-interpreter
+
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: wheels-macos-${{ matrix.arch }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  windows-wheels:
+    name: Windows wheels (x86_64)
+    needs: validate
+    runs-on: windows-2025
+    steps:
+      - uses: actions/checkout@v7.0.1
+
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: |
+            3.8
+            3.9
+            3.10
+            3.11
+            3.12
+            3.13
+            3.14
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          command: build
+          maturin-version: ${{ env.MATURIN_VERSION }}
+          args: >-
+            --release
+            --compatibility pypi
+            --out dist
+            --find-interpreter
+
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: wheels-windows-x86_64
+          path: dist/*.whl
+          if-no-files-found: error
+
+  sdist:
+    name: Source distribution
+    needs: validate
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1.51.0
+        with:
+          command: sdist
+          maturin-version: ${{ env.MATURIN_VERSION }}
+          args: --out dist
+
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs:
+      - linux-wheels
+      - macos-wheels
+      - windows-wheels
+      - sdist
+    runs-on: ubuntu-24.04
+    environment:
+      name: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8.0.1
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Show release artifacts
+        run: ls -lah dist
+
+      - name: Publish Python distribution
+        uses: pypa/gh-action-pypi-publish@v1.14.2
+
+  publish-crates:
+    name: Publish to crates.io if missing
+    needs:
+      - linux-wheels
+      - macos-wheels
+      - windows-wheels
+      - sdist
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.14"
+
+      - name: Publish crate or skip existing version
+        run: bash scripts/publish-release.sh --tag "${GITHUB_REF_NAME}"
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}

siderust-0.2.1/.gitignore

@@ -0,0 +1,58 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+venv/
+ENV/
+env/
+
+# Rust
+/target/
+**/target/
+**/*.rs.bk
+Cargo.lock
+
+# PyO3/maturin
+*.so
+*.pyd
+*.dylib
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+.ruff_cache/
+coverage.xml
+htmlcov/
+.tox/
+
+# OS
+.DS_Store
+Thumbs.db
+
+.venv/

siderust-0.2.1/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.1] - 2026-10-04
+
+### Added
+
+- Added automated PyPI publishing through GitHub Actions and PyPI Trusted Publishing/OIDC.
+- Added cross-platform release wheels for Linux x86_64/aarch64, macOS x86_64/arm64, and Windows x86_64, plus a source distribution.
+- Added CI validation of built Python distribution artifacts before release tags are created.
+- Added declared and tested CPython 3.13 and 3.14 support.
+
+### Changed
+
+- Consolidated tag-driven PyPI and crates.io publication into a single release workflow.
+- Kept crates.io publication idempotent: an already-published crate version is detected and skipped instead of failing the release.
+
+## [0.2.0] - 2026-10-04
+
+### Added
+
+- Added `rlib` output alongside the Python `cdylib` so downstream Rust/PyO3
+  crates can depend on `siderust-py`.
+- Added the public `siderust_py::interop` API for converting Observer and
+  Direction values across independently compiled Python extensions.
+- Added a versioned, primitive-only bridge protocol that preserves canonical
+  Python type identity across extension boundaries.
+- Added independent downstream-consumer and bridge-contract tests for the
+  Observer/Direction interoperability surface.
+
+### Changed
+
+- Updated the bindings to Siderust 0.12.x and affn 0.10.x.
+- Aligned the extension and downstream consumer with PyO3 0.29.x.
+- Kept Rust and Python package version metadata synchronized at 0.2.0.
+
+### Removed
+
+- Removed the legacy Siderust submodule and obsolete dependency overrides.
+
+## [0.1.0] - 2026-03-07
+
+### Added
+
+- Initial `siderust` Python bindings backed by the Siderust Rust library.