meshwire 0.5.0__tar.gz

meshwire-0.5.0/.editorconfig

@@ -0,0 +1,24 @@
+# EditorConfig helps maintain consistent coding styles
+# https://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.py]
+max_line_length = 100
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{json,yaml,yml,toml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

meshwire-0.5.0/.git-blame-ignore-revs

@@ -0,0 +1,2 @@
+# Repo-wide ruff format. GitHub and `git blame --ignore-revs-file` skip it.
+de1429cf354857f08fca8225585b762500b82241

meshwire-0.5.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,77 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting! Please fill out the details below.
+  - type: input
+    id: blender-version
+    attributes:
+      label: Blender Version
+      description: "e.g., 4.2.19 LTS, 5.0"
+      placeholder: "4.2.19"
+    validations:
+      required: true
+  - type: input
+    id: mcp-version
+    attributes:
+      label: MCP Server Version
+      description: "e.g., 0.2.0"
+      placeholder: "0.2.0"
+    validations:
+      required: true
+  - type: input
+    id: tool-name
+    attributes:
+      label: Tool Name
+      description: "Which MCP tool is affected? e.g., blender_object_create"
+      placeholder: "blender_"
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened? What did you expect to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Minimal steps to reproduce the issue
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: textarea
+    id: error
+    attributes:
+      label: Error Output
+      description: Paste any error messages or logs
+      render: shell
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - macOS
+        - Linux
+    validations:
+      required: true
+  - type: dropdown
+    id: mcp-client
+    attributes:
+      label: MCP Client
+      options:
+        - Claude Desktop
+        - Claude Code
+        - Cursor
+        - VS Code + Continue
+        - Other
+    validations:
+      required: true

meshwire-0.5.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,54 @@
+name: Feature Request
+description: Suggest a new tool or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement! Please describe what you'd like.
+  - type: dropdown
+    id: category
+    attributes:
+      label: Tool Category
+      description: Which area does this feature relate to?
+      options:
+        - Scene / Object Management
+        - Modeling / Mesh Editing
+        - Materials / Shaders
+        - Sculpting
+        - Rigging / Armature
+        - Animation
+        - Rendering
+        - Baking
+        - Geometry Nodes
+        - Physics Simulation
+        - Export / Import
+        - AI Generation Pipeline
+        - MSFS Content Creation
+        - Livery System
+        - Measurement / Validation
+        - Collections / System
+        - Annotations
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe the feature or tool you'd like to see
+    validations:
+      required: true
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: How would you use this? What workflow does it enable?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any workarounds you've tried (e.g., using execute_script)

meshwire-0.5.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,31 @@
+## Summary
+
+Brief description of what this PR does.
+
+## Changes
+
+-
+
+## Tool Changes
+
+- [ ] New tools added (update tool count in test_server.py)
+- [ ] Existing tools modified
+- [ ] Handler registrations added in `addon/blender_mcp_addon/handlers/`
+- [ ] Handler implementations added
+
+## Testing
+
+- [ ] `pytest tests/ --ignore=tests/blender_integration_test.py` passes
+- [ ] Truth harness baselines updated if any tool result class changed (see CONTRIBUTING.md)
+- [ ] `ruff check .` passes
+- [ ] Tested with Blender (version: )
+- [ ] Tested via MCP client (client: )
+
+## Checklist
+
+- [ ] Tool definitions use `"type": "number"` (not `"integer"`) for numeric params
+- [ ] Handler returns `{"success": True, ...}` or `{"error": "..."}`
+- [ ] README updated if new tools added
+- [ ] CHANGELOG updated
+
+- [ ] I have read and agree to [CLA.md](../CLA.md) for this contribution.

meshwire-0.5.0/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 2
+    groups:
+      python-minor-patch:
+        update-types: [minor, patch]
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 2
+    groups:
+      actions-minor-patch:
+        update-types: [minor, patch]

meshwire-0.5.0/.github/workflows/blender.yml

@@ -0,0 +1,206 @@
+name: Blender harness
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  schedule:
+    - cron: "17 4 * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: blender-${{ github.event_name }}-${{ github.event_name == 'pull_request' && github.ref || github.run_id }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+env:
+  BLENDER_DEPS: >-
+    xvfb xauth libgl1 libegl1 libglx-mesa0 libgl1-mesa-dri libxi6 libxxf86vm1
+    libxfixes3 libxrender1 libxkbcommon0 libsm6 libice6 libxkbcommon-x11-0 libdbus-1-3
+
+jobs:
+  # Gated: an unrecorded behavior change on a supported Blender fails the run.
+  gated:
+    name: Blender ${{ matrix.version }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 45
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - version: "4.5.15"
+            series: "4.5"
+          - version: "5.2.3"
+            series: "5.2"
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Install system libraries
+        run: |
+          sudo apt-get update
+          # shellcheck disable=SC2086
+          sudo apt-get install -y --no-install-recommends $BLENDER_DEPS
+
+      # Only the tarball is cached. fetch_blender.py re-checks its sha256 on
+      # every use, so a poisoned cache entry is rejected.
+      - name: Cache Blender tarball
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/.cache/meshwire/*.tar.xz
+          key: blender-${{ matrix.version }}-${{ hashFiles('scripts/fetch_blender.py') }}
+
+      - name: Install test dependencies
+        run: uv sync --locked --extra dev --python 3.12
+
+      - name: Fetch Blender
+        id: fetch
+        run: |
+          set -e
+          bin="$(uv run --locked --python 3.12 python scripts/fetch_blender.py ${{ matrix.version }} --dest "$RUNNER_TEMP/blender")"
+          test -x "$bin"
+          echo "bin=$bin" >> "$GITHUB_OUTPUT"
+
+      - name: Run harness driver
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+        run: >-
+          xvfb-run -a uv run --locked --python 3.12 python -m tests.harness.driver
+          --blender "$BLENDER_BIN"
+          --out "$RUNNER_TEMP/runs/driver-${{ matrix.series }}"
+          --check-baseline tests/harness/baselines/blender-${{ matrix.series }}.json
+
+      # The release attaches this ZIP, so test the built ZIP and not the source tree: validate it,
+      # install it into a fresh Blender user folder, enable bl_ext.user_default.meshwire, start its
+      # server, then run the full handshake and ping with the real client.
+      - name: Test the built extension ZIP
+        timeout-minutes: 10
+        if: ${{ !cancelled() && steps.fetch.outcome == 'success' }}
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+          PYTHONPATH: src
+        run: |
+          set -e
+          uv run --locked --python 3.12 python scripts/package_addon.py --output "$RUNNER_TEMP/meshwire-addon.zip"
+          uv run --locked --python 3.12 python scripts/smoke_extension.py \
+            --blender "$BLENDER_BIN" \
+            --zip "$RUNNER_TEMP/meshwire-addon.zip" \
+            --work "$RUNNER_TEMP/extension-smoke-${{ matrix.series }}"
+
+      # Runs even when the driver step failed so one failure does not hide the
+      # other. The failed driver step still fails the job.
+      - name: Run socket lane
+        if: ${{ !cancelled() && steps.fetch.outcome == 'success' }}
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+        run: >-
+          xvfb-run -a uv run --locked --python 3.12 python -m tests.harness.socket_lane
+          --blender "$BLENDER_BIN"
+          --out "$RUNNER_TEMP/runs/socket-${{ matrix.series }}"
+          --check-baseline tests/harness/baselines/socket-lane.json
+
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: harness-${{ matrix.version }}
+          path: |
+            ${{ runner.temp }}/runs
+            !${{ runner.temp }}/runs/**/*.blend
+            !${{ runner.temp }}/runs/**/*.blend1
+            !${{ runner.temp }}/runs/**/tmp/**
+          if-no-files-found: ignore
+          retention-days: 14
+
+  # Best effort: every series other than 4.5 and 5.2 runs nightly. Late in a full
+  # run, 4.2 and 4.3 sometimes segfault inside Blender, on a different heavy case
+  # each time, and the case passes alone. --retry-crashes reruns each crash alone
+  # and names it as a session crash when it passes. The gated jobs never pass it.
+  # Results never gate anything and nothing may depend on this job.
+  nightly:
+    name: Blender ${{ matrix.version }} (best effort)
+    if: ${{ github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 60
+    continue-on-error: true
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - {version: "4.2.23", series: "4.2"}
+          - {version: "4.3.2", series: "4.3"}
+          - {version: "4.4.3", series: "4.4"}
+          - {version: "5.0.1", series: "5.0"}
+          - {version: "5.1.2", series: "5.1"}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Install system libraries
+        run: |
+          sudo apt-get update
+          # shellcheck disable=SC2086
+          sudo apt-get install -y --no-install-recommends $BLENDER_DEPS
+
+      - name: Cache Blender tarball
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/.cache/meshwire/*.tar.xz
+          key: blender-${{ matrix.version }}-${{ hashFiles('scripts/fetch_blender.py') }}
+
+      - name: Install test dependencies
+        run: uv sync --locked --extra dev --python 3.12
+
+      - name: Fetch Blender
+        id: fetch
+        run: |
+          set -e
+          bin="$(uv run --locked --python 3.12 python scripts/fetch_blender.py ${{ matrix.version }} --dest "$RUNNER_TEMP/blender")"
+          test -x "$bin"
+          echo "bin=$bin" >> "$GITHUB_OUTPUT"
+
+      - name: Run harness driver
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+        run: >-
+          xvfb-run -a uv run --locked --python 3.12 python -m tests.harness.driver
+          --blender "$BLENDER_BIN"
+          --out "$RUNNER_TEMP/runs/driver-${{ matrix.series }}"
+          --check-baseline tests/harness/baselines/blender-${{ matrix.series }}.json
+          --retry-crashes
+
+      # Runs even when the driver step failed so one failure does not hide the
+      # other. Best effort like the driver step: a failing check shows in the
+      # log and gates nothing.
+      - name: Run socket lane
+        if: ${{ !cancelled() && steps.fetch.outcome == 'success' }}
+        continue-on-error: true
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+        run: >-
+          xvfb-run -a uv run --locked --python 3.12 python -m tests.harness.socket_lane
+          --blender "$BLENDER_BIN"
+          --out "$RUNNER_TEMP/runs/socket-${{ matrix.series }}"
+          --check-baseline tests/harness/baselines/socket-lane.json
+
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: harness-${{ matrix.version }}
+          path: |
+            ${{ runner.temp }}/runs
+            !${{ runner.temp }}/runs/**/*.blend
+            !${{ runner.temp }}/runs/**/*.blend1
+            !${{ runner.temp }}/runs/**/tmp/**
+          if-no-files-found: ignore
+          retention-days: 14

meshwire-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,97 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.event_name }}-${{ github.event_name == 'pull_request' && github.ref || github.run_id }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Run Ruff
+        run: uv run --locked --extra dev --python 3.11 ruff check .
+
+      - name: Check formatting
+        run: uv run --locked --extra dev --python 3.11 ruff format --check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Install dependencies
+        run: uv sync --locked --extra dev --python ${{ matrix.python-version }}
+
+      - name: Run unit tests
+        run: uv run --locked --extra dev --python ${{ matrix.python-version }} pytest tests/ --ignore=tests/blender_integration_test.py -v
+
+  # The socket, token and instance-file code behaves differently per platform (Windows
+  # binds exclusively and has no POSIX modes; macOS has its own rules for overlapping binds).
+  test-platforms:
+    name: test (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Install dependencies
+        run: uv sync --locked --extra dev --python 3.12
+
+      - name: Run platform tests
+        run: uv run --locked --extra dev --python 3.12 pytest tests/test_wire.py tests/test_instances.py tests/test_socket_server.py -v
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Build package
+        run: uv build --build-constraint build-constraints.txt --require-hashes
+
+      - name: Build addon ZIP
+        run: uv run --locked --python 3.11 python scripts/package_addon.py
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: dist
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist/*.zip

meshwire-0.5.0/.github/workflows/codeql.yml

@@ -0,0 +1,33 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "31 5 * * 1"
+
+permissions:
+  contents: read
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    permissions:
+      contents: read
+      security-events: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: github/codeql-action/init@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
+        with:
+          languages: python
+          build-mode: none
+
+      - uses: github/codeql-action/analyze@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
+        with:
+          category: "/language:python"

meshwire-0.5.0/.github/workflows/release.yml

@@ -0,0 +1,135 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: "0.13.6"
+
+      # PyPI never lets a version be reused, so catch mistakes here. This check and the version
+      # check below are not a security boundary, because a tagged commit can edit this file. The
+      # repository's tag ruleset and the pypi environment's tag policy restrict publishing.
+      - name: Refuse a tag that is not on main
+        run: git merge-base --is-ancestor "$GITHUB_SHA" origin/main
+
+      # No unlocked code runs from here to the upload: uv.lock pins dependencies with hashes,
+      # build-constraints.txt does the same for the build backend, and --no-build rules out any
+      # dependency's own build step. Keep it that way, because this job produces what gets published.
+      - name: Install locked dependencies
+        run: uv sync --locked --no-install-project --no-build --extra dev --python 3.12
+
+      - name: Run tests
+        env:
+          PYTHONPATH: src
+        run: .venv/bin/python -m pytest tests/ --ignore=tests/blender_integration_test.py -q
+
+      - name: Build package
+        run: uv build --build-constraint build-constraints.txt --require-hashes
+
+      - name: Refuse a tag that does not match the package version
+        run: test -f "dist/meshwire-${GITHUB_REF_NAME#v}-py3-none-any.whl"
+
+      - name: Run the built wheel
+        run: |
+          uv pip install --no-deps "dist/meshwire-${GITHUB_REF_NAME#v}-py3-none-any.whl"
+          actual="$(.venv/bin/meshwire --version)"
+          test "$actual" = "meshwire ${GITHUB_REF_NAME#v}"
+
+      # Built outside dist/: the PyPI action uploads everything in that folder.
+      - name: Build addon ZIP
+        run: |
+          mkdir addon-zip
+          .venv/bin/python scripts/package_addon.py
+          mv dist/*.zip addon-zip/
+          base="${GITHUB_REF_NAME#v}"
+          base="$(printf '%s' "$base" | sed -E 's/(a|b|rc)[0-9]+$//')"
+          test -f "addon-zip/meshwire-addon-${base}.zip"
+
+      - name: Upload package
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+      - name: Upload addon ZIP
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: addon-zip
+          path: addon-zip/
+          if-no-files-found: error
+
+  publish:
+    needs: build
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    environment:
+      name: pypi
+      url: https://pypi.org/p/meshwire
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
+
+  github-release:
+    needs: publish
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    permissions:
+      contents: write
+    steps:
+      # First, because checkout cleans the workspace. Only the changelog is needed.
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          sparse-checkout: |
+            CHANGELOG.md
+            scripts/changelog_section.py
+          sparse-checkout-cone-mode: false
+
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: dist
+          path: dist
+
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: addon-zip
+          path: addon-zip
+
+      - name: Create the GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          flags=""
+          case "$GITHUB_REF_NAME" in
+            *a*|*b*|*rc*) flags="--prerelease" ;;
+          esac
+          # The release notes open with this version's CHANGELOG section; the generated list of
+          # pull requests follows it.
+          python3 scripts/changelog_section.py "${GITHUB_REF_NAME#v}" < CHANGELOG.md > notes.md
+          gh release create "$GITHUB_REF_NAME" --verify-tag --generate-notes --notes-file notes.md \
+            $flags dist/* addon-zip/*