buvis-gems 0.12.6__tar.gz

buvis_gems-0.12.6/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: cargo
+    directory: /src/rust
+    schedule:
+      interval: weekly
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly

buvis_gems-0.12.6/.github/workflows/deploy-docs.yml

@@ -0,0 +1,43 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - "docs/**"
+      - "src/**"
+      - "pyproject.toml"
+
+env:
+  BUVIS_SKIP_FRONTEND: "1"
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # stable
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+
+      - name: Install dependencies
+        run: uv sync --all-extras --group docs
+
+      - name: Build documentation
+        run: uv run sphinx-build -b html docs/source docs/build/html
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453 # v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/build/html

buvis_gems-0.12.6/.github/workflows/publish.yml

@@ -0,0 +1,136 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "gems-v*"
+  workflow_dispatch:
+    inputs:
+      testpypi:
+        description: "Publish to TestPyPI"
+        type: boolean
+        default: true
+
+jobs:
+  test:
+    uses: ./.github/workflows/test.yml
+
+  build-wheels:
+    needs: test
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - ubuntu-24.04-arm
+          - macos-latest
+          - windows-latest
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # stable
+
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install build deps
+        run: uv pip install --system maturin tomli
+
+      - name: Pin dependencies from lockfile
+        run: python dev/bin/pin_deps.py .
+
+      - name: Build wheel
+        run: uv build --wheel
+
+      - name: Repair Linux wheel
+        if: runner.os == 'Linux'
+        run: |
+          uv pip install --system auditwheel patchelf
+          auditwheel repair dist/*.whl --wheel-dir dist-repaired
+          rm -rf dist
+          mv dist-repaired dist
+
+      # One sdist for the whole release: indexes that list versions from
+      # .tar.gz filenames (Artifactory, mise's pipx backend) need it.
+      - name: Build sdist
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
+        run: uv build --sdist
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: wheel-${{ matrix.os }}-py${{ matrix.python-version }}
+          path: dist/*
+
+  publish:
+    needs: build-wheels
+    runs-on: ubuntu-latest
+    environment: ${{ (contains(github.ref_name, 'rc') || inputs.testpypi) && 'testpypi' || 'pypi' }}
+    permissions:
+      id-token: write
+      attestations: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          path: dist/
+          pattern: wheel-*
+          merge-multiple: true
+
+      - name: Attest build provenance
+        uses: actions/attest-build-provenance@0f67c3f4856b2e3261c31976d6725780e5e4c373 # v4
+        with:
+          subject-path: dist/*
+
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+        with:
+          packages-dir: dist/
+          repository-url: ${{ (contains(github.ref_name, 'rc') || inputs.testpypi) && 'https://test.pypi.org/legacy/' || 'https://upload.pypi.org/legacy/' }}
+
+  github-release:
+    needs: [build-wheels, publish]
+    if: github.event_name == 'push' && !contains(github.ref_name, 'rc')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          path: dist/
+          pattern: wheel-*
+          merge-multiple: true
+
+      - name: Generate SBOM
+        uses: anchore/sbom-action@e22c389904149dbc22b58101806040fa8d37a610 # v0
+        with:
+          path: dist/
+          format: cyclonedx-json
+          output-file: dist/buvis-gems.cdx.json
+
+      - name: Extract changelog
+        shell: bash
+        run: |
+          tag="${{ github.ref_name }}"
+          version="${tag#gems-v}"
+          echo "VERSION=$version" >> "$GITHUB_ENV"
+          awk "/^## \[${version//./\\.}\]/{found=1; next} /^## \[/{if(found) exit} found" CHANGELOG.md > release-notes.md
+
+      - uses: softprops/action-gh-release@3d0d9888cb7fd7b750713d6e236d1fcb99157228 # v3
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ env.VERSION }}
+          body_path: release-notes.md
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist/*.cdx.json

buvis_gems-0.12.6/.github/workflows/test.yml

@@ -0,0 +1,178 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_call:
+  workflow_dispatch:
+
+env:
+  BUVIS_SKIP_FRONTEND: "1"
+
+jobs:
+  detect:
+    runs-on: ubuntu-latest
+    outputs:
+      changed_tools: ${{ steps.filter.outputs.changed_tools }}
+      run_all: ${{ steps.filter.outputs.run_all }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+
+      - name: Detect changed paths
+        id: filter
+        run: |
+          ALL_TOOLS=$(find src/tools/ -maxdepth 1 -mindepth 1 -type d -printf '%f\n' | sort | jq -R . | jq -sc .)
+
+          # workflow_dispatch and workflow_call always run everything
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ] || [ "${{ github.event_name }}" = "workflow_call" ]; then
+            echo "run_all=true" >> "$GITHUB_OUTPUT"
+            echo "changed_tools=${ALL_TOOLS}" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # determine diff range
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            BASE="${{ github.event.pull_request.base.sha }}"
+          else
+            BASE="${{ github.event.before }}"
+          fi
+
+          # guard null SHA on first push to a new branch
+          NULL_SHA="0000000000000000000000000000000000000000"
+          if [ "${BASE}" = "${NULL_SHA}" ] || [ -z "${BASE}" ]; then
+            echo "run_all=true" >> "$GITHUB_OUTPUT"
+            echo "changed_tools=${ALL_TOOLS}" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          CHANGED=$(git diff --name-only "${BASE}..HEAD" --)
+
+          # check if shared infrastructure changed
+          RUN_ALL=false
+          if echo "${CHANGED}" | grep -qE '^(src/lib/|src/rust/|tests/lib/|tests/conftest\.py|pyproject\.toml|uv\.lock|hatch_build\.py|Cargo\.(toml|lock)|\.github/workflows/test\.yml)'; then
+            RUN_ALL=true
+          fi
+
+          if [ "${RUN_ALL}" = "true" ]; then
+            echo "run_all=true" >> "$GITHUB_OUTPUT"
+            echo "changed_tools=${ALL_TOOLS}" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # extract tool names from changed paths
+          TOOLS=$(echo "${CHANGED}" | grep -oE '^(src/tools|tests/tools)/[^/]+' | sed 's|.*/||' | sort -u)
+          JSON="[]"
+          if [ -n "${TOOLS}" ]; then
+            JSON=$(echo "${TOOLS}" | jq -R . | jq -sc .)
+          fi
+
+          echo "run_all=false" >> "$GITHUB_OUTPUT"
+          echo "changed_tools=${JSON}" >> "$GITHUB_OUTPUT"
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # stable
+
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+
+      - name: Install dependencies
+        run: uv sync --all-extras --group test --group dev
+
+      - name: Audit dependencies
+        run: uv run pip-audit --skip-editable --ignore-vuln CVE-2026-4539  # pygments, no fix available yet
+
+      - name: Lint & format check
+        run: |
+          uv run ruff check src/ tests/
+          uv run ruff format --check src/ tests/
+
+      - name: Type check
+        run: uv run mypy src/lib/ src/tools/
+
+  lib:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # stable
+
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --group test --group dev
+
+      - name: Run library tests
+        run: uv run pytest -m lib --cov=src/lib --cov-report=term-missing --cov-fail-under=80
+
+  tools:
+    needs: [detect, lib]
+    if: needs.detect.outputs.changed_tools != '[]'
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        tool: ${{ fromJson(needs.detect.outputs.changed_tools) }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # stable
+
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --group test --group dev
+
+      - name: Run ${{ matrix.tool }} tests
+        env:
+          TOOL_MARKER: ${{ matrix.tool }}
+        run: uv run pytest -m "$TOOL_MARKER" --cov="src/tools/$TOOL_MARKER" --cov-report=term-missing --cov-fail-under=50
+
+  # Single status check for branch protection / automerge
+  test:
+    if: always()
+    needs: [lint, lib, tools]
+    runs-on: ubuntu-latest
+    steps:
+      - run: |
+          if [ "${{ needs.lint.result }}" != "success" ]; then
+            echo "Lint checks failed"
+            exit 1
+          fi
+          if [ "${{ needs.lib.result }}" != "success" ]; then
+            echo "Lib tests failed"
+            exit 1
+          fi
+          if [ "${{ needs.tools.result }}" != "success" ] && [ "${{ needs.tools.result }}" != "skipped" ]; then
+            echo "Tool tests failed"
+            exit 1
+          fi

buvis_gems-0.12.6/.github/workflows/update-snapshots.yml

@@ -0,0 +1,68 @@
+name: Update snapshots
+
+on:
+  workflow_dispatch:
+    inputs:
+      marker:
+        description: "pytest marker to regenerate (default: snapshot)"
+        required: false
+        default: "snapshot"
+
+permissions:
+  contents: write
+  pull-requests: write
+
+env:
+  BUVIS_SKIP_FRONTEND: "1"
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4 # stable
+
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+
+      - name: Install dependencies
+        run: uv sync --all-extras --group test --group dev
+
+      - name: Regenerate snapshot baselines
+        env:
+          BUVIS_SNAPSHOT_CANONICAL: "1"
+        run: uv run pytest -m "${{ inputs.marker }}" --snapshot-update
+
+      - name: Verify snapshots now pass
+        env:
+          BUVIS_SNAPSHOT_CANONICAL: "1"
+        run: uv run pytest -m "${{ inputs.marker }}"
+
+      - name: Open pull request with updated baselines
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          if [ -z "$(git status --porcelain tests/)" ]; then
+            echo "No snapshot changes to commit."
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          BRANCH="update-snapshots/${{ github.run_id }}"
+          git checkout -b "$BRANCH"
+          git add tests/
+          git commit -m "test: regenerate snapshot baselines in canonical env"
+          git push origin "$BRANCH"
+          gh pr create \
+            --title "test: regenerate snapshot baselines" \
+            --body "Automated regeneration via update-snapshots workflow on the canonical env (Linux + Python 3.12)." \
+            --base master \
+            --head "$BRANCH"

buvis_gems-0.12.6/.gitignore

@@ -0,0 +1,74 @@
+# Claude / Serena
+.claude
+.local
+.serena
+
+# Python bytecode
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+*.egg-info/
+*.egg
+.eggs/
+dist/
+build/
+*.whl
+*.so
+sdist/
+wheels/
+*.tar.gz
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Environment variables
+.env
+.env.*
+!.env.example
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.tox/
+.nox/
+
+# Linting / type checking
+.mypy_cache/
+.ruff_cache/
+.dmypy.json
+
+# IDEs / editors
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.project
+.settings/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Tool output
+transcoded/
+
+# Docs build
+docs/build/
+
+# Rust
+src/rust/target/
+src/rust/uv.lock
+
+# Frontend
+src/tools/bim/commands/serve/frontend/node_modules/
+src/tools/bim/commands/serve/frontend/build/
+src/tools/bim/commands/serve/frontend/.svelte-kit/
+src/tools/bim/commands/serve/static/

buvis_gems-0.12.6/.mise.toml

@@ -0,0 +1,2 @@
+[env]
+_.path = ["dev/bin"]

buvis_gems-0.12.6/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.12
+    hooks:
+      - id: ruff
+        pass_filenames: false
+        args: [--fix, "src/", "tests/"]
+      - id: ruff-format
+        pass_filenames: false
+        args: ["src/", "tests/"]
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        entry: uv run mypy src/lib/ src/tools/
+        language: system
+        types: [python]
+        pass_filenames: false
+      - id: no-framework-in-commands
+        name: no framework imports in commands/params
+        entry: >
+          bash -c 'if rg -q "from buvis\.pybase\.adapters import|import click|import textual|import fastapi"
+          src/tools/*/commands/ src/tools/*/params/ --glob "!*/serve/*";
+          then echo "ERROR: framework imports in commands/ or params/"; exit 1; fi'
+        language: system
+        pass_filenames: false
+      - id: check-tool-wiring
+        name: check tool wiring in pyproject.toml
+        entry: python dev/bin/check_tool_wiring.py
+        language: system
+        pass_filenames: false