simtools-dependency-manifest#

Generate a dependency provenance manifest.

Overview#

The application writes the dependency provenance manifest for the active simtools environment. Production images use it during the image build; users can also run it to capture the installed Python packages, scientific-software build options, image references, and a canonical SHA-256 digest.

Use --development while building a development image that has the source tree but does not install simtools. In this mode, --project_file supplies the direct Python dependencies and --build_option_files supplies available CORSIKA and sim_telarray build metadata.

Output and schema#

Output	Format	Schema	Purpose
`--output_file`	JSON	`dependency_manifest.schema` 0.1.0	Canonical dependency provenance manifest.
`--output_file` with `.sha256` appended	Text	None; checksum sidecar	SHA-256 digest of the canonical manifest.

Command line arguments#

options#

–help

show this help message and exit

–output_file

Dependency manifest JSON file to write.

Default: /opt/simtools/provenance/dependency-manifest.json.

–development

Generate provenance for an image where simtools is not installed.

–project_file

Project file used to discover direct Python dependencies in development mode.

Default: pyproject.toml.

–build_option_files

Build-options YAML files to merge in development mode.

application#

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