gdsdiff 0.1.0__tar.gz

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

@@ -0,0 +1,88 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  UV_VERSION: 0.11.29
+
+jobs:
+  test:
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.14"]
+    runs-on: ${{ matrix.os }}
+    env:
+      UV_PYTHON: ${{ matrix.python-version }}
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+      - run: uv lock --check
+      - run: uv sync --locked --extra test
+      - run: uv run --locked --extra test python -m pytest
+
+  package:
+    timeout-minutes: 20
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+      - run: uv build --no-sources
+      - run: uvx --from twine==6.2.0 twine check --strict dist/*
+      - name: Smoke-test installed wheel
+        shell: bash
+        run: |
+          uv venv --python 3.14 /tmp/gdsdiff-wheel-smoke
+          uv pip install --python /tmp/gdsdiff-wheel-smoke/bin/python dist/*.whl jsonschema
+          cd /tmp
+          /tmp/gdsdiff-wheel-smoke/bin/python "$GITHUB_WORKSPACE/scripts/installed_smoke.py"
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
+        with:
+          name: gdsdiff-distributions
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 14
+
+  compilerless-cpu:
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+      - run: uv sync --locked --extra test
+      - name: Verify passive CPU operation with no toolchain on PATH
+        shell: bash
+        run: |
+          python_path=$(uv run --locked python -c 'import sys; print(sys.executable)')
+          mkdir -p /tmp/gdsdiff-no-tools /tmp/gdsdiff-empty-cache
+          cd /tmp
+          PATH=/tmp/gdsdiff-no-tools GDSDIFF_NATIVE_CACHE_DIR=/tmp/gdsdiff-empty-cache \
+            "$python_path" -c 'import gdsdiff; d=gdsdiff.backend_diagnostics(); assert d["capabilities"]["cpu_available"]; assert not d["capabilities"]["nvcc_available"]'
+          test -z "$(find /tmp/gdsdiff-empty-cache -type f -print -quit)"

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

@@ -0,0 +1,124 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  UV_VERSION: 0.11.29
+
+jobs:
+  build:
+    timeout-minutes: 20
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+      - name: Verify tag and package versions
+        shell: bash
+        run: |
+          package_version=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')
+          test "v$package_version" = "$GITHUB_REF_NAME"
+      - run: uv lock --check
+      - run: uv sync --locked --extra test
+      - run: uv run --locked --extra test python -m pytest
+      - run: uv build --no-sources
+      - run: uvx --from twine==6.2.0 twine check --strict dist/*
+      - name: Stage immutable release artifacts and hashes
+        shell: bash
+        run: |
+          mkdir -p release/packages
+          cp dist/* release/packages/
+          cd release/packages
+          sha256sum * > ../SHA256SUMS
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
+        with:
+          name: release-distributions
+          path: release/
+          if-no-files-found: error
+          retention-days: 30
+
+  testpypi:
+    needs: build
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
+        with:
+          name: release-distributions
+          path: release
+      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1
+        with:
+          packages-dir: release/packages
+          repository-url: https://test.pypi.org/legacy/
+
+  verify-testpypi:
+    needs: testpypi
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+      - name: Install exact TestPyPI release without dependency confusion
+        shell: bash
+        run: |
+          version=${GITHUB_REF_NAME#v}
+          uv venv /tmp/gdsdiff-testpypi
+          uv pip install --python /tmp/gdsdiff-testpypi/bin/python --index-url https://pypi.org/simple gdstk numpy jsonschema
+          uv pip install --python /tmp/gdsdiff-testpypi/bin/python --index-url https://test.pypi.org/simple --no-deps "gdsdiff==$version"
+          cd /tmp
+          /tmp/gdsdiff-testpypi/bin/python "$GITHUB_WORKSPACE/scripts/installed_smoke.py"
+
+  pypi:
+    if: ${{ !contains(github.ref_name, 'rc') }}
+    needs: verify-testpypi
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
+        with:
+          name: release-distributions
+          path: release
+      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1
+        with:
+          packages-dir: release/packages
+
+  github-release:
+    if: ${{ !contains(github.ref_name, 'rc') }}
+    needs: pypi
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
+        with:
+          name: release-distributions
+          path: release
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "$GITHUB_REF_NAME" release/packages/* release/SHA256SUMS --verify-tag --generate-notes

gdsdiff-0.1.0/AGENTS.md

@@ -0,0 +1,32 @@
+# Agent Notes
+
+This repository is the standalone `gdsdiff` GDSII comparison library. Durable
+implementation belongs under `src/gdsdiff/`; tests belong under `tests/`.
+Read `agents/gdsdiff.md` before changing comparator semantics, reports,
+artifacts, acceleration, or agent-facing diff workflows.
+
+## Environment
+
+- Identify the host OS and architecture before environment-sensitive work.
+- Use `.venv_wsl/bin/python` on Windows 11 through WSL,
+  `.venv_mac/bin/python` on macOS, and `.venv/bin/python` on native Linux.
+- Do not use the base system Python for imports, builds, or tests.
+- CPU behavior must remain usable without CUDA, Metal, CMake, or a compiler.
+- Use the exact `uv` version required by `pyproject.toml`. On WSL under
+  `/mnt/f`, set `UV_PROJECT_ENVIRONMENT=.venv_wsl`, `UV_LINK_MODE=copy`, and
+  `TMPDIR=/tmp` for pytest. Use `.venv_mac` on macOS and `.venv` on Linux.
+
+## Development Rules
+
+- Work on the current branch unless the user explicitly requests another one.
+- Preserve neutral report wording and stable exit-code semantics.
+- Treat report schemas, CLI behavior, and root exports as public contracts.
+- Do not commit generated GDS, build products, native binaries, caches, or
+  benchmark results.
+- Use `.tmp/` for disposable local work and ignored `results/` for retained
+  local qualification evidence.
+- Run `python -m pytest` plus distribution build/inspection for packaging work.
+- For performance-sensitive changes, compare exact semantics first, then use a
+  warm-up and at least seven measured runs.
+- CUDA and Metal are optional runtime capabilities. Never make their toolchains
+  mandatory installation dependencies.

gdsdiff-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.1.0 - 2026-07-18
+
+- Promote the independently verified `0.1.0rc1` package without behavior or
+  dependency changes.
+- Record successful OIDC Trusted Publishing, signed attestations, exact
+  GitHub/TestPyPI artifact parity, clean indexed installation, and the complete
+  Python 3.10/3.14 Ubuntu, macOS, and Windows release-candidate matrix.
+
+## 0.1.0rc1 - 2026-07-17
+
+- Extract `gdsdiff` from `scgds` as an independently installable package while
+  preserving its comparator history and public behavior.
+- Replaced executable pickle geometry caches with versioned JSON/NumPy caches.
+- Added side-effect-free CUDA inspection, explicit preparation, stronger native
+  cache identity/permissions, packaged-schema validation, and release workflows.

gdsdiff-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# Contributing
+
+Use Python 3.10 or newer and the pinned `uv` release. On WSL use:
+
+```bash
+UV_PROJECT_ENVIRONMENT=.venv_wsl UV_LINK_MODE=copy uv sync --locked --extra dev
+TMPDIR=/tmp .venv_wsl/bin/python -m pytest
+```
+
+Use `.venv_mac` on macOS and `.venv` on native Linux. Ordinary `pip` installs
+remain a required distribution-compatibility gate.
+
+Changes to comparison semantics, report fields, exit codes, root exports, or
+native acceleration must include focused tests and compatibility notes. Keep
+CPU-only operation fully supported.