omniverse-usd-profiles 1.10.22

NVIDIA OpenUSD Profiles

Omniverse USD Profiles

A framework for defining and managing OpenUSD asset profiles, capabilities, and requirements. This library provides tools for parsing profile specifications from Markdown, generating Python code, and integrating with Sphinx documentation.

Features

• Profile definitions — Define capabilities, features, and requirements in structured Markdown
• Code generation — Generate Python enums and dataclasses from profile specifications
• Sphinx integration — Custom directives and roles for rendering profile documentation
• Validation support — Generate validation rules from requirement specifications
• Extensible — Modular architecture for custom profile components

Installation

Install from PyPI:

pip install omniverse-usd-profiles

Basic Usage

Code Generation

Generate Python code from profile specifications:

python -m omni.usd_profiles.codegen --docs-root path/to/specs --destination-dir path/to/output --namespace mypackage.profiles

Sphinx Integration

Add to your Sphinx conf.py:

extensions = [
    "omni.usd_profiles.sphinx.ext",
]

Use directives in your documentation:

```{requirements-table}
geometry/mesh-valid
geometry/mesh-normals
```

```{features-table}
geometry/feature-mesh
```

Use roles for inline tags and compatibility badges:

{tag}`performance` - Display a tag badge
{compatibility}`omniverse` - Display a compatibility badge

Documentation

• Full Documentation

Requirements

• Python 3.10 or later
• Jinja2 3.1.5 or later
• Sphinx 7.2.6 or later

License

Apache-2.0