simready.package

Standalone Python library for packaging SimReady USD assets with pre- and post-validation. Orchestrates the pre-validate → build → post-validate pipeline in a single package() call and writes a com.nvidia.simready.packaging.json package definition.

Installation

pip install simready-package

# Publishing via WRAPP also requires:
pip install "simready-package[publish]"

Quick start

import asyncio
import simready.package as sp

packager = sp.Packager(config_path="/workspace/project_config.toml")

result = asyncio.run(packager.package(
    sp.PackageSpec(
        name="crate_01",
        version="1.0.0",
        license_id="LicenseRef-NvidiaProprietary",
        source="/workspace/props/crate_01",
        root_usds=["crate_01.usd"],
    )
))

print(f"Package ready: {result.created.pkg_def_url}")

Key concepts

Two modes

Pre- and post-validation

package() runs pre-validation against the Package-Candidate profile before building, and post-validation against the Package profile after building. Both profiles are defined in SimReady foundations — no profile override is needed or expected for standard packaging.

package() raises ValidationFailed when any feature fails (unless the phase is skipped via skip_pre_validation / skip_post_validation).

Profile and rule registration

Outside a Kit environment, pass rules and profiles to the Packager constructor:

# From a project_config.toml (reads [validate] section)
packager = sp.Packager(config_path="/workspace/project_config.toml")

# Or from explicit paths
packager = sp.Packager(
    rules_and_requirements_paths=["nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities"],
    features_paths=["nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features"],
    profiles_paths=["nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/profiles"],
)

Inside Kit, omni.simready.validators registers profiles automatically and the constructor can be called with no arguments.

Python API

Packager

packager = sp.Packager(
    *,
    config_path=None,                    # path to project_config.toml
    rules_and_requirements_paths=None,   # override individual paths
    features_paths=None,
    profiles_paths=None,
)

# Full pipeline
result = await packager.package(spec)            # -> PackageResult

# Pre-validation only
result = await packager.pre_validate(source, *, root_usds=None)   # -> PreValidationResult

# Post-validation only
result = await packager.post_validate(package_def, *)             # -> PostValidationResult

PackageSpec

PackageResult

CreatedPackage

CLI

# Local packaging
simready-package \
  --name crate_01 --version 1.0.0 \
  --license LicenseRef-NvidiaProprietary \
  --project-config /workspace/project_config.toml \
  --root-usd crate_01.usd \
  /workspace/props/crate_01

# Publish to WRAPP (validation mandatory)
simready-package \
  --name crate_01 --version 1.0.0 \
  --license LicenseRef-NvidiaProprietary \
  --repo omniverse://nucleus.company.com/packages \
  --project-config /workspace/project_config.toml \
  --root-usd crate_01.usd \
  /workspace/props/crate_01

# Pre-validate only (no package build)
simready-package \
  --project-config /workspace/project_config.toml \
  --pre-validate-only \
  /workspace/props/crate_01

# Local packaging, skip validation
simready-package \
  --name crate_01 --version 1.0.0 \
  --license LicenseRef-NvidiaProprietary \
  --skip-pre-validation --skip-post-validation \
  /workspace/props/crate_01

Exit code: 0 = success, 1 = validation failed or error.

License

Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. SPDX-License-Identifier: Apache-2.0