python-cad-tools 0.1.0rc1__tar.gz → 0.1.2__tar.gz

python_cad_tools-0.1.2/.gitattributes

@@ -0,0 +1,2 @@
+# Generated viewer bytes are reviewed through the canonical asset manifest.
+src/python_cad_tools/_viewer_static/** -text -diff

python_cad_tools-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,313 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  lint-type-unit:
+    name: Lint, type, unit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - run: ruff check src tests
+      - run: mypy
+      - run: pytest -q
+
+  exporter-integration:
+    name: Exporter integration
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - run: pytest tests/integration -q
+
+  viewer-browser:
+    name: Viewer and browser tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e .
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        with:
+          node-version: "22.15.0"
+          cache: npm
+          cache-dependency-path: viewer/package-lock.json
+      - working-directory: viewer
+        run: npm ci
+      - working-directory: viewer
+        run: npm test
+      - working-directory: viewer
+        run: npm run build
+      - working-directory: viewer
+        run: npx playwright install --with-deps chromium
+      - working-directory: viewer
+        run: npm run test:e2e
+
+  wheel-sdist:
+    name: Wheel and sdist inspection
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - run: python -m build --wheel --sdist --outdir dist .
+      - run: python -m twine check dist/*
+      - run: pytest tests/packaging -q
+
+  clean-install:
+    name: Clean non-editable install
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - run: python -m build --wheel --outdir dist .
+      - name: Install wheel into clean venv
+        run: |
+          python -m venv /tmp/clean-venv
+          /tmp/clean-venv/bin/pip install dist/*.whl
+          /tmp/clean-venv/bin/python-cad --version
+      - name: Init and build generic project
+        run: |
+          mkdir /tmp/generic-project
+          /tmp/clean-venv/bin/python-cad init --destination /tmp/generic-project
+          /tmp/clean-venv/bin/python-cad build --project-root /tmp/generic-project
+          /tmp/clean-venv/bin/python-cad verify --project-root /tmp/generic-project
+
+  generic-e2e:
+    name: Generic E2E
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - name: Init, build, verify, clean
+        run: |
+          python-cad init --destination /tmp/e2e-project
+          python-cad build --project-root /tmp/e2e-project
+          python-cad verify --project-root /tmp/e2e-project
+          python-cad clean --project-root /tmp/e2e-project
+
+  public-api:
+    name: Public API surface
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - run: pytest tests/unit/test_public_api.py -q
+
+  active-terminology:
+    name: Active terminology scan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - name: Scan for active legacy concepts
+        run: |
+          set -euo pipefail
+          EXCLUDES="\.git/|\.venv/|__pycache__|\.back_agents/|back_AGENTS|back_opencode|PYTHON_CAD_TOOLS_REPOSITORY_MIGRATION_PLAN|docs/migration-prompts/|docs/migration/|node_modules|\.egg-info|\.mypy_cache|\.pytest_cache|\.ruff_cache|\.coverage|\.opencode/node_modules|\.opencode/package|\.opencode/tools|\.opencode/commands|generated/|\.github/workflows/ci\.yml"
+          HITS=$(grep -rliE "freecad|fcstd|freecadcmd|benge_freecad_project|python-cad-project|python-cad-artifact-viewer|bengecomplexfunctional|functional\.benge_complex|complex-functional|benge_functional_output|freecad macro project template" \
+            --include="*.py" --include="*.toml" --include="*.json" --include="*.jsonc" --include="*.md" --include="*.yml" --include="*.yaml" --include="*.sh" --include="*.txt" --include="*.in" . 2>/dev/null \
+            | grep -vE "$EXCLUDES" || true)
+          if [ -n "$HITS" ]; then
+            echo "Active legacy concepts found:"
+            echo "$HITS"
+            exit 1
+          fi
+          echo "No active legacy concepts found."
+
+  tree-shape:
+    name: Tree shape and policy checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - name: Verify tree shape, symlinks, allowlists, backup exclusions
+        run: |
+          set -euo pipefail
+          echo "=== Check .tools/ is absent ==="
+          test ! -d .tools
+          echo "=== Check root legacy files are absent ==="
+          for f in build.py start.sh config.py model.py drawing_annotations.py; do
+            test ! -f "$f"
+          done
+          echo "=== Check CLAUDE.md resolves to AGENTS.md ==="
+          test "$(readlink CLAUDE.md)" = "AGENTS.md"
+          test -f AGENTS.md
+          echo "=== Check backups are untracked ==="
+          git status --short .back_agents/ back_AGENTS.md back_opencode.jsonc | grep -qE '^\?\?' || true
+          echo "=== Check no dangling symlinks ==="
+          find .claude .codex .opencode -type l ! -exec test -e {} \; -print 2>/dev/null | grep -v node_modules || true
+          echo "=== Check .github/workflows has expected files ==="
+          for f in ci.yml release-candidate.yml downstream-compatibility.yml; do
+            test -f ".github/workflows/$f"
+          done
+          echo "All tree shape checks passed."
+
+  supported-platforms:
+    name: Supported platforms (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - run: ruff check src tests
+        if: matrix.os != 'windows-latest'
+      - run: mypy
+        if: matrix.os != 'windows-latest'
+      - run: pytest tests/unit -q
+      - name: Init and build on platform
+        run: |
+          python-cad init --destination /tmp/platform-test
+          python-cad build --project-root /tmp/platform-test
+        if: matrix.os != 'windows-latest'
+      - name: Init and build on Windows
+        run: |
+          python-cad init --destination C:\platform-test
+          python-cad build --project-root C:\platform-test
+        if: matrix.os == 'windows-latest'
+
+  platform-locks:
+    name: Platform lock generation (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            lock: requirements-linux.lock
+          - os: macos-latest
+            lock: requirements-macos.lock
+          - os: windows-latest
+            lock: requirements-windows.lock
+
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - name: Generate platform lock
+        run: |
+          pip freeze > ${{ matrix.lock }}
+          echo "Generated ${{ matrix.lock }} on ${{ matrix.os }}"
+          cat ${{ matrix.lock }}
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
+        with:
+          name: ${{ matrix.lock }}
+          path: ${{ matrix.lock }}
+
+  build-publish:
+    name: Build and publish to PyPI
+    if: |
+      (github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+      (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v'))
+    needs:
+      - lint-type-unit
+      - exporter-integration
+      - viewer-browser
+      - wheel-sdist
+      - clean-install
+      - generic-e2e
+      - public-api
+      - active-terminology
+      - tree-shape
+      - supported-platforms
+      - platform-locks
+    runs-on: ubuntu-latest
+    outputs:
+      hashes: ${{ steps.hash.outputs.hashes }}
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install build twine
+      - name: Build wheel and sdist
+        run: python -m build --wheel --sdist --outdir dist .
+      - name: Generate hashes for provenance
+        id: hash
+        run: |
+          cd dist
+          HASHES=$(sha256sum * | base64 -w0)
+          echo "hashes=$HASHES" >> "$GITHUB_OUTPUT"
+      - name: Twine check
+        run: python -m twine check dist/*
+      - name: Publish to PyPI
+        run: python -m twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+
+  provenance:
+    name: Generate SLSA provenance
+    if: |
+      (github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+      (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v'))
+    needs: [build-publish]
+    permissions:
+      actions: read
+      id-token: write
+      contents: write
+    uses: slsa-framework/slsa-github-generator/.github/workflows/generator_generic_slsa3.yml@v2.1.0
+    with:
+      base64-subjects: ${{ needs.build-publish.outputs.hashes }}
+      upload-assets: true
+      private-repository: true

python_cad_tools-0.1.2/.github/workflows/downstream-compatibility.yml

@@ -0,0 +1,40 @@
+name: Downstream compatibility
+
+on:
+  workflow_dispatch:
+    inputs:
+      companion-repository-url:
+        description: Future companion repository URL (e.g. https://github.com/owner/repo)
+        required: true
+        type: string
+      companion-commit:
+        description: Companion repository commit SHA to check out
+        required: true
+        type: string
+      candidate-wheel-sha256:
+        description: SHA-256 of the candidate wheel to test against
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  downstream-compatibility:
+    name: Downstream compatibility (manual, deferred)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Report deferred downstream compatibility
+        run: |
+          echo "Downstream compatibility verification is deferred."
+          echo ""
+          echo "Inputs recorded for a future companion repository:"
+          echo "  companion-repository-url: ${{ inputs.companion-repository-url }}"
+          echo "  companion-commit: ${{ inputs.companion-commit }}"
+          echo "  candidate-wheel-sha256: ${{ inputs.candidate-wheel-sha256 }}"
+          echo ""
+          echo "This workflow does not check out, build, or test a companion"
+          echo "repository. It must not be run until a companion repository"
+          echo "exists at the provided URL. No companion revision is"
+          echo "hard-coded in this repository."
+          exit 1

python_cad_tools-0.1.2/.github/workflows/release-candidate.yml

@@ -0,0 +1,92 @@
+name: Release candidate
+
+on:
+  workflow_dispatch:
+    inputs:
+      candidate-label:
+        description: Candidate label (e.g. 0.1.0rc1)
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build wheel and sdist
+    runs-on: ubuntu-latest
+    outputs:
+      wheel-sha256: ${{ steps.hashes.outputs.wheel-sha256 }}
+      sdist-sha256: ${{ steps.hashes.outputs.sdist-sha256 }}
+      wheel-name: ${{ steps.hashes.outputs.wheel-name }}
+      sdist-name: ${{ steps.hashes.outputs.sdist-name }}
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - run: ruff check src tests
+      - run: mypy
+      - run: pytest -q
+      - name: Build wheel and sdist
+        run: python -m build --wheel --sdist --outdir dist .
+      - name: Twine check
+        run: python -m twine check dist/*
+      - name: Record hashes
+        id: hashes
+        run: |
+          WHEEL=$(ls dist/*.whl)
+          SDIST=$(ls dist/*.tar.gz)
+          WHEEL_SHA=$(sha256sum "$WHEEL" | cut -d' ' -f1)
+          SDIST_SHA=$(sha256sum "$SDIST" | cut -d' ' -f1)
+          echo "wheel-sha256=$WHEEL_SHA" >> "$GITHUB_OUTPUT"
+          echo "sdist-sha256=$SDIST_SHA" >> "$GITHUB_OUTPUT"
+          echo "wheel-name=$(basename "$WHEEL")" >> "$GITHUB_OUTPUT"
+          echo "sdist-name=$(basename "$SDIST")" >> "$GITHUB_OUTPUT"
+          echo "WHEEL_SHA256=$WHEEL_SHA" > dist/CHECKSUMS
+          echo "SDIST_SHA256=$SDIST_SHA" >> dist/CHECKSUMS
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
+        with:
+          name: release-candidate-${{ inputs.candidate-label }}
+          path: dist/
+          retention-days: 90
+
+  verify:
+    name: Verify candidate hashes
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e '.[dev]'
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093
+        with:
+          name: release-candidate-${{ inputs.candidate-label }}
+          path: dist
+      - name: Verify hashes match
+        run: |
+          set -euo pipefail
+          WHEEL=$(ls dist/*.whl)
+          SDIST=$(ls dist/*.tar.gz)
+          WHEEL_SHA=$(sha256sum "$WHEEL" | cut -d' ' -f1)
+          SDIST_SHA=$(sha256sum "$SDIST" | cut -d' ' -f1)
+          echo "Wheel: $WHEEL_SHA"
+          echo "Expected: ${{ needs.build.outputs.wheel-sha256 }}"
+          test "$WHEEL_SHA" = "${{ needs.build.outputs.wheel-sha256 }}"
+          echo "Sdist: $SDIST_SHA"
+          echo "Expected: ${{ needs.build.outputs.sdist-sha256 }}"
+          test "$SDIST_SHA" = "${{ needs.build.outputs.sdist-sha256 }}"
+      - name: Install wheel non-editably and verify
+        run: |
+          python -m venv /tmp/candidate-venv
+          /tmp/candidate-venv/bin/pip install dist/*.whl
+          /tmp/candidate-venv/bin/python-cad --version
+      - name: Run packaging tests
+        run: pytest tests/packaging -q

python_cad_tools-0.1.2/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+build/
+dist/
+*.egg-info/
+
+generated/*
+!generated/.gitkeep
+
+.autocommit/

python_cad_tools-0.1.2/.opencode/commands/autocommit.md

@@ -0,0 +1,15 @@
+---
+description: Save verified repository changes through the exclusive Save agent
+agent: save
+subtask: true
+---
+
+Load the `save` skill and follow it exactly.
+
+Save the already-verified repository changes by calling the native OpenCode
+tool `specrepo-autocommit` exactly once. Use `$ARGUMENTS` as its `summary` when
+the value is non-empty; otherwise use `Save verified repository changes`.
+
+Do not inspect or edit files, run tests, call shell commands, invoke Git
+directly, or use any fallback. Report the single tool call's completed,
+blocked, rejected, or failed result.

python_cad_tools-0.1.2/.opencode/tools/specrepo-autocommit.js

@@ -0,0 +1,25 @@
+import { tool } from "@opencode-ai/plugin"
+import { fileURLToPath } from "node:url"
+
+const script = fileURLToPath(new URL("./specrepo-autocommit.py", import.meta.url))
+
+export default tool({
+  description: "Save verified changes through SpecRepo autocommit; callable only by the save agent.",
+  args: {
+    summary: tool.schema.string().trim().min(1).describe("What changed and why"),
+  },
+  async execute({ summary }, context) {
+    if (context.agent !== "save") {
+      throw new Error("specrepo-autocommit is restricted to the save agent.")
+    }
+    const python = process.platform === "win32" ? "python" : "python3"
+    const result = await Bun.$`${python} ${script} ${summary}`
+      .cwd(context.worktree || context.directory)
+      .nothrow()
+      .quiet()
+    const output = `${result.stdout}${result.stderr}`.trim()
+
+    if (result.exitCode !== 0) throw new Error(output)
+    return output || "Autocommit completed successfully."
+  },
+})