fieldpilot-urdf 0.1.0__tar.gz

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

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: test py${{ matrix.python-version }}${{ matrix.xacro && format(' · xacro {0}', matrix.xacro) || '' }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        # `xacro` is the most fragile dependency (importer.py patches its
+        # internals), so guard the lowest supported pin (the floor of the
+        # `xacro>=2.1` requirement) on one job in addition to latest.
+        include:
+          - python-version: "3.12"
+            xacro: "2.1.0"
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # graphviz `dot` so the viz renderer tests actually run (they skip otherwise)
+      - name: Install graphviz
+        run: sudo apt-get update && sudo apt-get install -y graphviz
+
+      - name: Install package (with all extras + dev)
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Pin xacro (matrix override)
+        if: ${{ matrix.xacro }}
+        run: pip install "xacro==${{ matrix.xacro }}"
+
+      - name: Show resolved versions
+        run: pip show xacro numpy scipy networkx pydantic | grep -E "^(Name|Version)"
+
+      - name: Run tests
+        run: pytest -q
+
+  build:
+    name: build & check distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+      - name: Validate metadata
+        run: twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*

fieldpilot_urdf-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,56 @@
+name: Publish to PyPI
+
+# Publishes on an annotated tag like `v0.1.0`. Uses PyPI Trusted Publishing
+# (OIDC) — NO API token is stored in the repo. One-time setup on PyPI:
+# add a pending publisher for project `fieldpilot-urdf`, owner `DuQuatre`,
+# repo `fieldpilot-urdf`, workflow `publish.yml`, environment `pypi`.
+# See RELEASING.md.
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    name: build & check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Guard — tag must match project version
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          VER="$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          echo "tag=$TAG  pyproject=$VER"
+          if [ "$TAG" != "$VER" ]; then
+            echo "::error::tag v$TAG does not match pyproject version $VER"; exit 1
+          fi
+
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+      - name: Validate metadata
+        run: twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    name: publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi          # configure this environment + the trusted publisher on PyPI
+    permissions:
+      id-token: write          # OIDC — required for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

fieldpilot_urdf-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+
+# Test / tooling
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

fieldpilot_urdf-0.1.0/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to `fieldpilot-urdf` are documented here. Format follows
+[Keep a Changelog](https://keepachangelog.com/), and the project aims to adhere
+to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] — 2026-06-13
+
+First public release: the open robotics core of FieldPilot, extracted into a
+standalone, pure-Python, pip-installable package (AGPL-3.0).
+
+### Added
+- **Import** any ROS robot from an HTTPS URL — `import_urdf` expands `xacro`,
+  `$(find)`, and `<xacro:include>` in-process (no ROS, no build).
+- **Parse** URDF ⇄ Pydantic model — `from_xml`, `from_file`, `to_xml`.
+- **Kinematics** — forward kinematics (`forward_kinematics`) and numerical,
+  joint-limit-aware inverse kinematics (`solve_ik`).
+- **Self-collision** — AABB + optional mesh-aware detection
+  (`detect_self_collisions`; meshes via the `[mesh]` extra).
+- **Workspace / trajectory** sampling — `sample_workspace`, `check_trajectory`.
+- **Validation** — 8 symbolic lint rules R001–R008 (`run_all`, `summary`).
+- **Auto-repair** — deterministic fixes for the repairable rules (`repair`).
+- **Symbolic fault diagnosis** — the pure two-tier hypothesis-and-test loop
+  (`diagnose`, `Symptom`, `Hypothesis`, `Verdict`).
+- **Visualisation** — kinematic-tree and 3D-pose renderers
+  (`fieldpilot_urdf.viz`, via the `[viz]` extra).
+- **Local registry** — file-based robot storage (`save_robot`, `load_robot`, …).
+- Security: `import_urdf` ships SSRF defences (HTTPS-only, host allowlist,
+  5 MB cap, timeout, redirect re-validation) — see `SECURITY.md`.
+- CI across Python 3.10–3.13 (plus an older-`xacro` guard); 144 tests.
+
+### Notes
+- Configuration env vars use the `FIELDPILOT_URDF_*` namespace; the legacy
+  `MECHDIAG_*` names are still read as a deprecated fallback.
+- The LLM robot chat, the natural-language fault-diagnosis front-end, the
+  spare-parts BOM, and multi-tenant hosting are **not** part of this package —
+  they live in FieldPilot SaaS.
+
+[0.1.0]: https://github.com/DuQuatre/fieldpilot-urdf/releases/tag/v0.1.0