ArchiveInfo

pydantic model lsst.images.serialization.ArchiveInfo

Basic identifying information about an on-disk archive.

Read from a file’s headers/metadata without deserializing pixel data.

Parameters:

data (Any)

Fields:

• format_version (int | None)

• schema_name (str)

• schema_url (str)

• schema_version (str)

field format_version: int | None [Required]

Container layout version (FITS FMTVER / NDF FORMAT_VERSION); None for formats with no separate container version (JSON).

field schema_name: str [Required]

Schema name parsed from schema_url.

field schema_url: str [Required]

Canonical schema URL of the top-level tree.

field schema_version: str [Required]

Schema version parsed from schema_url.

classmethod from_schema_url(schema_url, *, format_version)

Build an ArchiveInfo by parsing a schema URL of the form https://{host}/.../schemas/{name}-{version}.

The URL is parsed with ResourcePath and must be an http(s) URL whose final directory is schemas, so a DATAMODL header written by an unrelated tool cannot steer reads toward an arbitrary schema. The host is not restricted: external packages mint schema URLs under their own documentation sites via ArchiveTree.SCHEMA_URL_BASE.

Parameters:

• schema_url (str) – Schema URL to parse for the schema name and version.

• format_version (int | None) – Container layout version, or None for formats with no separate container version.

Return type:

ArchiveInfo