gtlv 0.1.0__tar.gz

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

@@ -0,0 +1,52 @@
+name: CI
+
+on:
+  push:
+    branches: [dev, main] # dev = snapshot verification; main = formal (post-merge)
+  pull_request:
+    branches: [main] # gate the dev -> main PR
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ci:
+    name: Rust + Python (lint · test)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      # Honor rust-toolchain.toml so CI uses the same toolchain as local `make lint`.
+      - name: Install pinned Rust toolchain
+        run: rustup show
+
+      - uses: Swatinem/rust-cache@v2
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.10"
+
+      - name: Install dev dependencies
+        run: python -m pip install --upgrade "maturin>=1.0,<2.0" "mypy>=1.19"
+
+      - name: cargo fmt
+        run: cargo fmt --all -- --check
+
+      - name: cargo clippy
+        run: cargo clippy --all-targets -- -D warnings
+
+      # Building through maturin also exercises the models embedded in gtlv-core.
+      - name: Install the package
+        run: python -m pip install .
+
+      - name: mypy
+        env:
+          MYPYPATH: python
+        run: mypy --python-version 3.10 python/gtlv tests
+
+      - name: Python tests
+        run: python -m unittest discover -s tests

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

@@ -0,0 +1,114 @@
+name: Release
+
+# Build wheels and an sdist, then publish them to PyPI on a version tag.
+# Publishing uses PyPI Trusted Publishing: GitHub mints a short-lived OIDC token
+# that PyPI exchanges for upload credentials, so no API token is stored here.
+#
+# One-time setup on PyPI (Your projects -> Publishing, or a pending publisher for
+# the first release) must match this workflow exactly:
+#   Owner            cca2878
+#   Repository       gtlv-py
+#   Workflow         release.yml
+#   Environment      pypi
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch: # builds and verifies the matrix without publishing
+
+permissions:
+  contents: read
+
+jobs:
+  guard:
+    name: Tag matches Cargo.toml
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - uses: actions/checkout@v7
+      # PyPI versions are immutable, so catch a mismatch before anything uploads.
+      - run: |
+          tag="${GITHUB_REF_NAME#v}"
+          crate="$(sed -n '0,/^version = /s/^version = "\(.*\)"/\1/p' Cargo.toml)"
+          echo "tag=$tag cargo=$crate"
+          test "$tag" = "$crate"
+
+  wheels:
+    name: wheel ${{ matrix.platform.os }}-${{ matrix.platform.target }}
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - { os: linux, runner: ubuntu-latest, target: x86_64 }
+          - { os: linux, runner: ubuntu-latest, target: aarch64 }
+          - { os: macos, runner: macos-latest, target: aarch64 }
+          - { os: macos, runner: macos-15-intel, target: x86_64 }
+          - { os: windows, runner: windows-latest, target: x64 }
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          # Pinned rather than "3.x": abi3 fixes the output ABI at py310 no matter
+          # which interpreter builds it, so a floating latest only adds the risk of
+          # outrunning what this PyO3 release knows about.
+          python-version: "3.13"
+
+      # abi3-py310 yields a single wheel per platform, so no interpreter sweep.
+      - uses: PyO3/maturin-action@v1
+        env:
+          # The manylinux containers pick their own interpreter, which may be newer
+          # than the above; the stable ABI holds either way.
+          PYO3_USE_ABI3_FORWARD_COMPATIBILITY: 1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist
+          manylinux: auto
+          sccache: "true"
+
+      # Smoke-test the actual artifact on the one runner that can load it.
+      # A wheel that fails to import must never reach PyPI.
+      - name: Install and test the built wheel
+        if: matrix.platform.os == 'linux' && matrix.platform.target == 'x86_64'
+        run: |
+          python -m pip install dist/*.whl
+          python -m unittest discover -s tests -v
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist-${{ matrix.platform.os }}-${{ matrix.platform.target }}
+          path: dist
+
+  sdist:
+    name: sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist-sdist
+          path: dist
+
+  publish:
+    name: publish -> PyPI
+    needs: [guard, wheels, sdist]
+    if: startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/gtlv
+    permissions:
+      id-token: write # required for Trusted Publishing; no token secret is used
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          pattern: dist-*
+          path: dist
+          merge-multiple: true
+      # A rejected upload still burns the version number, so validate metadata
+      # and README rendering first.
+      - run: pipx run twine check dist/*
+      - uses: pypa/gh-action-pypi-publish@release/v1

gtlv-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+/target/
+*.so
+__pycache__/
+*.egg-info/
+/dist/
+.coverage
+.mypy_cache/
+.pytest_cache/
+.DS_Store
+.idea/
+.vscode/