mujoco-usd-converter 0.1.0__tar.gz

mujoco_usd_converter-0.1.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @andrewkaufman @LouRohanNV

mujoco_usd_converter-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,92 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023-2025 The Newton Developers
+# SPDX-License-Identifier: Apache-2.0
+
+name: Bug Report
+description: File a bug report
+labels: ["bug"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version of mujoco-usd-converter are you running?
+      placeholder: "example: v1.0.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: installation_method
+    attributes:
+      label: Did you install official release artifacts or build from source?
+      options:
+        - Official release artifacts
+        - Built from Source
+    validations:
+      required: true
+
+  - type: dropdown
+    id: modifications
+    attributes:
+      label: Did you modify the sdist, whl, or source code (including the pyproject.toml or uv.lock)?
+      options:
+        - "No"
+        - "Yes"
+    validations:
+      required: true
+
+  - type: input
+    id: py_version
+    attributes:
+      label: Python Version
+      description: What version of Python are you using?
+    validations:
+      required: true
+
+  - type: input
+    id: platform
+    attributes:
+      label: Operating System
+      description: What Operating System / Platform are you using?
+      placeholder: "example: Ubuntu 22.04 Linux x86_64"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug.
+      description: Also tell us, what did you expect to happen?
+      placeholder: XYZ occurred, I expected QRS results
+    validations:
+      required: true
+
+  - type: textarea
+    id: mvr
+    attributes:
+      label: Minimum reproducible example
+      description: Please supply a minimum reproducible example here
+      render: python
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please paste relevant error and log output here
+      render: shell
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/newton-physics/mujoco-usd-converter/blob/HEAD/CODE_OF_CONDUCT.md)
+      options:
+        - label: I agree to follow mujoco-usd-converter Code of Conduct
+          required: true
+        - label: I have searched the [open issues](https://github.com/newton-physics/mujoco-usd-converter/issues) and have found no duplicates
+          required: true

mujoco_usd_converter-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+# GitHub info on config.yml
+# https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser
+# Set to 'false' if you only want the templates to be used.
+blank_issues_enabled: false
+
+# When using discussions instead of Question issue templates,
+# link that below to have it show up in the 'Submit Issue' page
+contact_links:
+  - name: Ask a Question
+    url: https://github.com/newton-physics/mujoco-usd-converter/discussions
+    about: Please ask any questions here.

mujoco_usd_converter-0.1.0/.github/ISSUE_TEMPLATE/documentation_request.yml

@@ -0,0 +1,38 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023-2025 The Newton Developers
+# SPDX-License-Identifier: Apache-2.0
+
+name: Documentation
+description: Request changes or additions to documentation
+labels: ["documentation"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to improve our documentation!
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Describe the changes or additions to documentation
+      placeholder: A code snippet mentions function foo(args) but I cannot find any documentation on it.
+    validations:
+      required: true
+
+  - type: textarea
+    id: search_locs
+    attributes:
+      label: Where have you looked?
+      placeholder: |
+       https://github.com/newton-physics/mujoco-usd-converter/blob/main/README.md
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/newton-physics/mujoco-usd-converter/blob/HEAD/CODE_OF_CONDUCT.md)
+      options:
+        - label: I agree to follow mujoco-usd-converter Code of Conduct
+          required: true
+        - label: I have searched the [open issues](https://github.com/newton-physics/mujoco-usd-converter/issues) and have found no duplicates
+          required: true

mujoco_usd_converter-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,51 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023-2025 The Newton Developers
+# SPDX-License-Identifier: Apache-2.0
+
+name: Feature Request
+description: Request new or improved functionality or changes to existing functionality
+labels: ["enhancement"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this feature request!
+
+  - type: dropdown
+    id: new_or_improvement
+    attributes:
+      label: Is this a new feature, an improvement, or a change to existing functionality?
+      options:
+        - New Feature
+        - Improvement
+        - Change
+    validations:
+      required: true
+
+  - type: textarea
+    id: Feature_Description
+    attributes:
+      label: Feature Description
+      description: Please provide clear description of the feature you request
+      placeholder: >
+        For new feature request, consider using the following format to describe the feature from the end-user perspective:
+          As a <persona>, I <want to>, <so that>.
+    validations:
+      required: true
+
+  - type: textarea
+    id: misc
+    attributes:
+      label: Additional context or alternatives
+      description: Add any other context, code examples, references to existing implementations, or alternatives you have considered
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/newton-physics/mujoco-usd-converter/blob/HEAD/CODE_OF_CONDUCT.md)
+      options:
+        - label: I agree to follow mujoco-usd-converter Code of Conduct
+          required: true
+        - label: I have searched the [open issues](https://github.com/newton-physics/mujoco-usd-converter/issues) and have found no duplicates
+          required: true

mujoco_usd_converter-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## Description
+<!-- Set a descriptive pull request title. -->
+<!-- Provide a standalone description of changes in this PR. -->
+<!-- Reference any issues relevant to this PR. -->
+
+## Checklist
+- [ ] I am familiar with the [Contributing Guidelines](https://github.com/newton-physics/mujoco-usd-converter/blob/HEAD/CONTRIBUTING.md).

mujoco_usd_converter-0.1.0/.github/actions/bootstrap/action.yml

@@ -0,0 +1,29 @@
+name: 'Bootstrap'
+description: 'Bootstrap the repository'
+inputs:
+  python-version:
+    description: 'Python version to use'
+    required: false
+    default: '3.11'
+  enable-uv-cache:
+    description: 'Enable uv cache'
+    required: false
+    default: 'true'
+  cache-dependency-glob:
+    description: 'Glob pattern for cache dependencies'
+    required: false
+    default: 'uv.lock'
+
+runs:
+  using: "composite"
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867  # v7.1.6
+      with:
+        enable-cache: ${{ inputs.enable-uv-cache }}
+        cache-dependency-glob: ${{ inputs.cache-dependency-glob }}

mujoco_usd_converter-0.1.0/.github/codecov.yml

@@ -0,0 +1,10 @@
+coverage:
+  status:
+    project: off
+    patch: off
+
+comment:
+  layout: "diff, flags, files"
+
+fixes:
+  - "/var/snap/amazon-ssm-agent/[0-9]+/::"

mujoco_usd_converter-0.1.0/.github/workflows/benchmark.yml

@@ -0,0 +1,69 @@
+name: Benchmark
+
+on:
+  pull_request:
+    types: [labeled]
+  workflow_dispatch:  # Manual trigger from Actions tab
+
+permissions:
+  contents: read
+  pull-requests: write  # Required to comment on PRs
+
+jobs:
+  benchmark:
+    # Run if: labeled with 'benchmark' OR manual trigger
+    if: |
+      (github.event_name == 'pull_request' && contains(github.event.label.name, 'benchmark')) ||
+      github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.3.1
+
+      - name: Bootstrap
+        uses: ./.github/actions/bootstrap
+
+      - name: Run benchmarks
+        run: uv run --group dev poe benchmark
+
+      - name: Upload benchmark results
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+        with:
+          name: mujoco-usd-converter-benchmarks-${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || format('{0}', github.ref_name) }}
+          path: benchmarks/*.*
+
+      - name: Comment PR with results
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@f28e40c7f34bde8b3046d885e986cb6290c5673b  # v7.1.0
+        with:
+          script: |
+            // Wait a bit for artifacts to be fully uploaded
+            await new Promise(resolve => setTimeout(resolve, 5000));
+
+            // Get artifacts from this workflow run
+            const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              run_id: context.runId
+            });
+
+            // Find the benchmark-results artifact (with PR number)
+            const artifactName = `benchmark-results-pr-${context.issue.number}`;
+            const benchmarkArtifact = artifacts.data.artifacts.find(a => a.name === artifactName);
+
+            let comment = `## Benchmark Results\n\n`;
+
+            if (benchmarkArtifact) {
+              const artifactUrl = `${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}/artifacts/${benchmarkArtifact.id}`;
+              comment += `[Download benchmark results](${artifactUrl})\n\n`;
+            } else {
+              const runUrl = `${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`;
+              comment += `[View workflow run](${runUrl})\n\n`;
+            }
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: comment
+            });

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

@@ -0,0 +1,180 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+    tags: [ '*' ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:  # Manual trigger from Actions tab
+
+permissions:
+  contents: read
+  pull-requests: write  # Required to comment on PRs
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.3.1
+
+      - name: Bootstrap
+        uses: ./.github/actions/bootstrap
+
+      - name: Check uv lock file
+        run: uv lock --check
+
+      - name: Run linting
+        run: uv run --group dev poe lint
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.3.1
+
+      - name: Bootstrap
+        uses: ./.github/actions/bootstrap
+
+      - name: Update README
+        run: uv run --group dev poe update-readme
+
+      - name: Build package
+        run: uv build
+
+      - name: Restore README
+        run: git restore README.md
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+        with:
+          name: mujoco-usd-converter-dist-${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || format('{0}', github.ref_name) }}
+          path: dist/
+
+  test:
+    needs: build
+    strategy:
+      matrix:
+        os:
+          [
+            ubuntu-latest,
+            ubuntu-24.04-arm,
+            windows-latest,
+          ]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.3.1
+
+      - name: Bootstrap
+        uses: ./.github/actions/bootstrap
+
+      - name: Download artifacts
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+        with:
+          name: mujoco-usd-converter-dist-${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || format('{0}', github.ref_name) }}
+          path: dist/
+
+      - name: Run tests
+        run: uv run --group dev poe test-ci
+
+      - name: Upload report artifacts
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+        with:
+          name: mujoco-usd-converter-coverage-${{ matrix.os }}-${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || format('{0}', github.ref_name) }}
+          include-hidden-files: true
+          path: |
+            ${{ github.workspace }}/.coverage.xml
+            ${{ github.workspace }}/.results.xml
+
+      - name: Upload test results to Codecov
+        if: ${{ !cancelled() }}
+        uses: codecov/test-results-action@0fa95f0e1eeaafde2c782583b36b28ad0d8c77d3  # v1.2.1
+        with:
+          files: ${{ github.workspace }}/.results.xml
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de  # v5.5.2
+        with:
+          files: ${{ github.workspace }}/.coverage.xml
+          flags: unittests
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  test-package:
+    needs: build
+    strategy:
+      matrix:
+        os:
+          [
+            ubuntu-latest,
+            ubuntu-24.04-arm,
+            windows-latest,
+          ]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.3.1
+
+      - name: Bootstrap
+        uses: ./.github/actions/bootstrap
+        with:
+          enable-uv-cache: 'false'
+
+      - name: Download artifacts
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+        with:
+          name: mujoco-usd-converter-dist-${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || format('{0}', github.ref_name) }}
+          path: dist/
+
+      - name: Test wheel installation (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          # Create a fresh virtual environment to test the wheel
+          uv venv /tmp/wheel_test_env
+          source /tmp/wheel_test_env/bin/activate
+
+          # Install the wheel directly using uv
+          uv pip install --index-strategy unsafe-best-match dist/*.whl
+
+          # Test conversion
+          mkdir -p /tmp/test_outputs
+          mujoco_usd_converter tests/data/geoms.xml /tmp/test_outputs/geoms_output
+
+      - name: Test wheel installation (Windows)
+        if: runner.os == 'Windows'
+        shell: powershell
+        run: |
+          # Create a fresh virtual environment to test the wheel
+          uv venv wheel_test_env
+          wheel_test_env\Scripts\activate.ps1
+
+          # Find and install the wheel file
+          $wheelFile = Get-ChildItem -Path "dist" -Filter "*.whl" | Select-Object -First 1
+          uv pip install --index-strategy unsafe-best-match $wheelFile.FullName
+
+          # Test conversion
+          New-Item -ItemType Directory -Force -Path test_outputs
+          mujoco_usd_converter tests/data/geoms.xml test_outputs\geoms_output
+
+  deploy:
+    if: startsWith(github.ref, 'refs/tags/')
+    needs:
+      - build
+      - test
+      - test-package
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mujoco-usd-converter
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheel and source tarball
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+        with:
+          name: mujoco-usd-converter-dist-${{ github.ref_name }}
+          path: dist/
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc

mujoco_usd_converter-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+# build environment
+.*venv
+.coverage
+.coverage.xml
+.results.xml
+
+# editor files
+.vscode/launch.json
+
+# generated files
+*.pyc
+tests/output/*
+benchmarks/*
+
+# installation artifacts
+dist
+mujoco_usd_converter/plugins/mjcPhysics

mujoco_usd_converter-0.1.0/.vscode/settings.json

@@ -0,0 +1,16 @@
+{
+    "editor.rulers": [150],
+    "files.trimTrailingWhitespace": true,
+    "files.trimFinalNewlines": true,
+    "diffEditor.ignoreTrimWhitespace": false,
+    "python.analysis.extraPaths": [
+        ".venv/lib/python3.10/site-packages",
+        ".venv/Lib/site-packages",
+    ],
+    "python.languageServer": "Pylance",
+    "isort.args": ["--profile", "black"],
+    "flake8.args": [
+        "--max-line-length=150",
+        "--ignore=F405"
+    ]
+}