specify-core 0.1.4__tar.gz

specify_core-0.1.4/.github/workflows/ci.yml

@@ -0,0 +1,97 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    env:
+      CARGO_TERM_COLOR: always
+      QUIDDITY_CORPUS: ${{ github.workspace }}/quiddity/tests/corpus
+      SPECIFY_CORPUS: ${{ github.workspace }}/quiddity/tests/corpus
+      QUIDDITY_CORPUS_REQUIRED: "1"
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+      # Same corpus revision and sparse checkout as quiddity-rust's suite.yml.
+      # Tests select Specify's regressions from tests/common/corpus.rs; the full sweep
+      # is a local opt-in (SPECIFY_CORPUS_ALL=1), not a CI tier.
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          repository: pzfreo/quiddity
+          ref: 6d544e060cd0eeb4442d2196e5df757b5a15ea55
+          path: quiddity
+          sparse-checkout: tests/corpus
+      # The toolchain comes from rust-toolchain.toml. quiddity-rust is a public git dependency,
+      # pinned by Cargo.lock.
+      - run: rustup toolchain install
+      - uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
+      - run: cargo fmt --all --check
+      - run: cargo clippy --workspace --all-targets --release -- -D warnings
+      # Maintainer decision, 2026-10-26: macOS PRs build and run only float-sensitive
+      # expectations; five macOS runners are shared across repos, so reduce runner-minutes
+      # rather than add jobs/shards. Linux always runs everything. Main, dispatch and
+      # release* PR heads retain the full macOS suite.
+      - name: Build the workspace and every test
+        run: cargo test --workspace --release --locked --no-run
+      - name: Full suite
+        if: runner.os != 'macOS' || github.event_name != 'pull_request' || startsWith(github.head_ref, 'release')
+        run: cargo test --workspace --release --locked --no-fail-fast
+      - name: macOS PR floating-point checks
+        if: runner.os == 'macOS' && github.event_name == 'pull_request' && !startsWith(github.head_ref, 'release')
+        # features: libm-dependent frame/recognition and rounded face records.
+        # mesh: acos/sin, UV refinement, triangle winding/area and rounded bounds.
+        # anchors: geometric integration and six-decimal leader positions/directions.
+        # schema6: rotated slot end planes, frame roll and PMI coordinates.
+        # resume: rounded centroids, signed zero and persisted fingerprint hashes.
+        # revision: geometric correspondence, rounded report measurements and PNG projection.
+        # characteristic_numbers: macOS-captured legacy serialization hashes.
+        # pyfmt: exact binary rounding/formatting used by all these expectations.
+        run: >-
+          cargo test --release --locked --no-fail-fast
+          --test features --test mesh --test anchors --test schema6
+          --test resume --test revision --test pyfmt --test characteristic_numbers
+
+  wasm:
+    runs-on: ubuntu-latest
+    env:
+      CARGO_TERM_COLOR: always
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          fetch-depth: 0 # API acknowledgement is compared with the PR base / previous push.
+      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: '24'
+      - run: rustup toolchain install
+      - run: rustup target add wasm32-unknown-unknown
+      - run: cargo install wasm-pack --version 0.15.0 --locked
+      - run: python3 -m unittest discover -s tools -p 'test_*.py'
+      - run: wasm-pack build crates/specify-core-wasm --target web --profile wasm-release --locked
+      - name: Check WASM API snapshot and changelog
+        env:
+          API_BASE: ${{ github.event.pull_request.base.sha || github.event.before || github.sha }}
+        run: |
+          if [ -z "$API_BASE" ] || [ "$API_BASE" = "0000000000000000000000000000000000000000" ]; then
+            API_BASE=$(git hash-object -t tree -w --stdin < /dev/null)
+          fi
+          python3 tools/check_wasm_api.py --base-ref "$API_BASE"
+      - run: python3 tools/wasm_size.py
+      - name: Compare released editor kernel (advisory)
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: python3 tools/check_quiddity_pin.py
+      - run: cargo build --locked --release -p specify-core-wasm --example parity_reference
+      - run: node scripts/wasm-parity.mjs
+      - run: node scripts/wasm-hostile.mjs

specify_core-0.1.4/.github/workflows/cli.yml

@@ -0,0 +1,91 @@
+name: Release command line
+
+# The specify-core command line for Linux, macOS and Windows, attached to each release. A change to
+# this workflow builds and tries all three on its pull request, without attaching anything.
+on:
+  release:
+    types: [published]
+  pull_request:
+    paths: ['.github/workflows/cli.yml']
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    if: github.event_name == 'pull_request' || startsWith(github.event.release.tag_name, 'v')
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { os: ubuntu-22.04, target: x86_64-unknown-linux-gnu, exe: '' }
+          - { os: macos-latest, target: aarch64-apple-darwin, exe: '' }
+          - { os: windows-latest, target: x86_64-pc-windows-msvc, exe: .exe }
+    runs-on: ${{ matrix.os }}
+    env:
+      CARGO_TERM_COLOR: always
+      RELEASE_TAG: ${{ github.event.release.tag_name }}
+      # rustc's thin-LTO threads overflow Windows' default stack on step-io.
+      RUST_MIN_STACK: '67108864'
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          ref: ${{ github.event.release.tag_name || github.sha }}
+      - run: rustup toolchain install
+      - uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
+        with:
+          key: cli-${{ matrix.target }}
+      - run: cargo build --locked --release --bin specify-core --target ${{ matrix.target }}
+      - name: Try it on a revision
+        # The hole_removed pair: one entry renumbers with its hole, one is set aside with the
+        # removed hole.
+        run: |
+          bin="target/${{ matrix.target }}/release/specify-core${{ matrix.exe }}"
+          fixtures=tests/fixtures/revisions
+          echo '{"hole.function:holes:7": "fit:H7", "hole.function:holes:9": "general"}' > given.json
+          printed=$("$bin" diff $fixtures/hole_removed.old.step.gz $fixtures/hole_removed.new.step.gz --answers given.json -o smoke)
+          echo "$printed"
+          echo "$printed" | grep -q '"verdict": *"decide"'
+          cat smoke/answers.json
+          # The ⌀6 hole's answer follows it from faces 9 to 8.
+          grep -q '"hole.function:holes:8": *"general"' smoke/answers.json && ! grep -q 'holes:9' smoke/answers.json
+      - name: Package and checksum
+        run: |
+          name="specify-core-${RELEASE_TAG:-pr}-${{ matrix.target }}"
+          mkdir -p dist "$name"
+          cp "target/${{ matrix.target }}/release/specify-core${{ matrix.exe }}" LICENSE README.md "$name/"
+          if [ "${{ runner.os }}" = Windows ]; then
+            asset="$name.zip"; 7z a -bd "dist/$asset" "$name" > /dev/null
+          else
+            asset="$name.tar.gz"; tar -czf "dist/$asset" "$name"
+          fi
+          cd dist
+          if command -v sha256sum > /dev/null; then sha256sum "$asset"; else shasum -a 256 "$asset"; fi > "$asset.sha256"
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: cli-${{ matrix.target }}
+          path: dist/*
+          if-no-files-found: error
+
+  # Only this job can write to the repository, and only for a release.
+  attach:
+    needs: build
+    if: github.event_name == 'release'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          pattern: cli-*
+          path: dist
+          merge-multiple: true
+      - name: Attach to this release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: gh release upload "$RELEASE_TAG" dist/* --clobber

specify_core-0.1.4/.github/workflows/python.yml

@@ -0,0 +1,147 @@
+name: Python package
+
+# The specify-core Python package (crates/specify-core-py): an abi3 wheel per platform and an
+# sdist. Each wheel is installed and its smoke suite (tests/python) run on CPython 3.12, and the
+# Linux x86_64 wheel on the newest CPython too, as abi3 promises. Published to PyPI for a
+# release. A change to the package, the engine or this workflow builds and tests on its pull
+# request, without publishing.
+on:
+  release:
+    types: [published]
+  pull_request:
+    paths:
+      - 'crates/specify-core-py/**'
+      - 'tests/python/**'
+      - 'src/**'
+      - 'Cargo.toml'
+      - 'Cargo.lock'
+      - '.github/workflows/python.yml'
+  # A manual run on main can publish the version already released (0.1.4 predates this workflow).
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: Publish the built wheels and sdist to PyPI
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+jobs:
+  wheels:
+    if: github.event_name != 'release' || startsWith(github.event.release.tag_name, 'v')
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { name: linux-x86_64, os: ubuntu-22.04, target: x86_64, manylinux: '2_28' }
+          - { name: linux-aarch64, os: ubuntu-24.04-arm, target: aarch64, manylinux: '2_28' }
+          - { name: macos-arm64, os: macos-latest, target: aarch64-apple-darwin }
+          - { name: macos-x86_64, os: macos-15-intel, target: x86_64-apple-darwin }
+          - { name: windows-x64, os: windows-latest, target: x86_64-pc-windows-msvc }
+    runs-on: ${{ matrix.os }}
+    env:
+      CARGO_TERM_COLOR: always
+      # rustc's thin-LTO threads overflow Windows' default stack on step-io (as cli.yml).
+      RUST_MIN_STACK: '67108864'
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          ref: ${{ github.event.release.tag_name || github.sha }}
+      # The package's LICENSE and NOTICE are links to the repository's; a Windows checkout
+      # makes a link a text file holding its target, so it gets the files themselves.
+      - if: runner.os == 'Windows'
+        run: |
+          rm crates/specify-core-py/LICENSE crates/specify-core-py/NOTICE
+          cp LICENSE NOTICE crates/specify-core-py/
+      # The toolchain comes from rust-toolchain.toml.
+      - uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          target: ${{ matrix.target }}
+          manylinux: ${{ matrix.manylinux || 'auto' }}
+          args: --release --locked -m crates/specify-core-py/Cargo.toml --out dist
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheel-${{ matrix.name }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  sdist:
+    if: github.event_name != 'release' || startsWith(github.event.release.tag_name, 'v')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          ref: ${{ github.event.release.tag_name || github.sha }}
+      - uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: sdist
+          args: -m crates/specify-core-py/Cargo.toml --out dist
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  test:
+    needs: wheels
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { name: linux-x86_64, os: ubuntu-22.04, python: '3.12' }
+          - { name: linux-aarch64, os: ubuntu-24.04-arm, python: '3.12' }
+          - { name: macos-arm64, os: macos-latest, python: '3.12' }
+          - { name: macos-x86_64, os: macos-15-intel, python: '3.12' }
+          - { name: windows-x64, os: windows-latest, python: '3.12' }
+          # The abi3 wheel on the newest CPython.
+          - { name: linux-x86_64, os: ubuntu-22.04, python: '3.15' }
+    runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          ref: ${{ github.event.release.tag_name || github.sha }}
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: wheel-${{ matrix.name }}
+          path: dist
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+      - run: uv venv --python ${{ matrix.python }} .venv
+      - name: Install the wheel, and pytest
+        run: |
+          uv pip install --python .venv pytest
+          uv pip install --python .venv --no-index --find-links dist specify-core
+      - name: The wheel carries the licence
+        run: |
+          .venv/${{ runner.os == 'Windows' && 'Scripts' || 'bin' }}/python - <<'EOF'
+          import glob, zipfile
+          (wheel,) = glob.glob("dist/*.whl")
+          names = zipfile.ZipFile(wheel).namelist()
+          for name in ("LICENSE", "NOTICE"):
+              (found,) = [n for n in names if n.endswith(".dist-info/licenses/" + name)]
+              text = zipfile.ZipFile(wheel).read(found).decode()
+              assert len(text) > 100, (found, text)
+          EOF
+      - run: .venv/${{ runner.os == 'Windows' && 'Scripts' || 'bin' }}/python -m pytest tests/python -q
+
+  publish:
+    needs: [wheels, sdist, test]
+    if: >-
+      (github.event_name == 'release' && startsWith(github.event.release.tag_name, 'v')) ||
+      (github.event_name == 'workflow_dispatch' && inputs.publish && github.ref == 'refs/heads/main')
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # PyPI trusted publishing
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3

specify_core-0.1.4/.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Release WASM
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  wasm:
+    if: startsWith(github.event.release.tag_name, 'v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    env:
+      CARGO_TERM_COLOR: always
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          ref: ${{ github.event.release.tag_name }}
+      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: '24'
+      - run: rustup toolchain install
+      - run: rustup target add wasm32-unknown-unknown
+      - run: cargo install wasm-pack --version 0.15.0 --locked
+      - name: Verify release version
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+        run: |
+          python3 - <<'PY'
+          import os, tomllib
+          version = os.environ['TAG'].removeprefix('v')
+          for path in ['Cargo.toml', 'crates/specify-core-wasm/Cargo.toml']:
+              with open(path, 'rb') as source:
+                  assert tomllib.load(source)['package']['version'] == version, path
+          PY
+      - run: wasm-pack build crates/specify-core-wasm --target web --profile wasm-release --locked
+      - run: python3 tools/wasm_size.py
+      - run: cargo build --locked --release -p specify-core-wasm --example parity_reference
+      - run: node scripts/wasm-parity.mjs
+      - run: node scripts/wasm-hostile.mjs
+      - name: Compare released editor kernel and annotate release (advisory)
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_REPO: ${{ github.repository }}
+        run: python3 tools/check_quiddity_pin.py --release "$TAG"
+      - name: Archive, checksum and attach package
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          version="${TAG#v}"
+          archive="specify-core-wasm-${version}.tgz"
+          tar -czf "$archive" -C crates/specify-core-wasm pkg
+          sha256sum "$archive" > "$archive.sha256"
+          gh release upload "$TAG" "$archive" "$archive.sha256" --clobber

specify_core-0.1.4/.gitignore

@@ -0,0 +1,9 @@
+/target
+__pycache__/
+*.pyc
+
+/crates/specify-core-wasm/pkg/
+
+# The Python package built in place (maturin develop)
+/crates/specify-core-py/python/specify_core/_native*.so
+/crates/specify-core-py/python/specify_core/_native*.pyd