simtools-dependency-versions#

Export the validated simtools dependency version catalog.

Overview#

The application reads the dependency catalog from the root-level dependency_versions.yml file. It validates the catalog and exports the declared Python version, component releases, optional revisions or digests, archive checksums, and image-build matrices.

Use --format github-output in GitHub Actions or local image-build scripts. Use --format env to emit catalog-managed runtime values as dotenv/GitHub Environment assignments; local paths and credentials are not emitted. Use --format summary for a compact view of the values that will be passed to Docker. The catalog represents intended build inputs; use simtools-dependency-manifest to inspect the versions actually present in an image.

Output formats and schemas#

Format	Schema	Purpose
`catalog`	`dependency_versions.schema` 0.1.0	Validated catalog as formatted JSON.
`summary`	None; derived JSON object	Stable scalar values for image builds.
`env`	None; dotenv/GitHub Environment assignments	Catalog-managed runtime values.
`github-output`	None; GitHub Actions key-value assignments	Build scalars and JSON-encoded matrices.
`python-requirements`	None; pip requirement lines	Direct Python requirements, optionally including named extras.

Command line arguments#

options#

–help

show this help message and exit

–pyproject

Explicit project file (the repository is searched when omitted).

–format

Output format.

Default: catalog. Choices: catalog, env, github-output, python-requirements, summary.

–extras

Optional dependency groups to include with python-requirements.

–update_source_revisions

JSON file with resolved build-source revisions to write to the catalog.

application#

–show_options: Print available values for a supported option and exit.