RSPImageTag

class nublado.controller.models.domain.rsptag.RSPImageTag(*, tag, image_type, display_name, base=None, version=None, cycle=None, cycle_build=None, rsp_build=None, architecture=None, extra=None, date=None)

Bases: object

A sortable image tag for a Rubin Science Platform image.

This class encodes the tag conventions documented in SQR-059. These conventions are specific to the Rubin Science Platform.

Parameters:

• tag (str)

• image_type (RSPImageType)

• display_name (str)

• base (Optional[str], default: None)

• version (Optional[Version], default: None)

• cycle (Optional[int], default: None)

• cycle_build (Optional[int], default: None)

• rsp_build (Optional[int], default: None)

• architecture (Optional[str], default: None)

• extra (Optional[str], default: None)

• date (Optional[datetime], default: None)

Attributes Summary

architecture	Architecture of image, if specified.
base	Base tag name for unknown and alias tags.
cycle	XML schema version implemented by this image (only for T&S builds).
cycle_build	XML schema build number (only for T&S builds).
date	When the image was created, or as close as we can get to that.
display_name	Human-readable display name.
extra	Additional information about the image.
image_type	Type (release series) of image identified by this tag.
rsp_build	Version number of the RSP build machinery.
tag	The tag itself, unmodified.
version	Version information as a semantic version.

Methods Summary

alias(tag)	Create an alias tag.
from_str(tag)	Parse a tag into an RSPImageTag.
to_dict()	Serialize to a dictionary representation.

Attributes Documentation

architecture: Optional[str] = None

Architecture of image, if specified.

base: Optional[str] = None

Base tag name for unknown and alias tags.

cycle: Optional[int] = None

XML schema version implemented by this image (only for T&S builds).

cycle_build: Optional[int] = None

XML schema build number (only for T&S builds).

date: Optional[datetime] = None

When the image was created, or as close as we can get to that.

For daily or weekly tags, this can be calculated within a day or week, which is good enough for filtering purposes. Other images are not handled for now, since the upload time is not necessarily when the image was created.

display_name: str = <dataclasses._MISSING_TYPE object>

Human-readable display name.

extra: Optional[str] = None

Additional information about the image.

image_type: RSPImageType = <dataclasses._MISSING_TYPE object>

Type (release series) of image identified by this tag.

rsp_build: Optional[int] = None

Version number of the RSP build machinery.

tag: str = <dataclasses._MISSING_TYPE object>

The tag itself, unmodified.

version: Optional[Version] = None

Version information as a semantic version.

Methods Documentation

classmethod alias(tag)

Create an alias tag.

Parameters:

tag (str) – Name of the alias tag.

Returns:

The corresponding RSPImageTag.

Return type:

RSPImageTag

classmethod from_str(tag)

Parse a tag into an RSPImageTag.

Parameters:

tag (str) – The tag.

Returns:

The corresponding RSPImageTag object.

Return type:

RSPImageTag

to_dict()

Serialize to a dictionary representation.

This method is used primarily for easy testing to allow comparisons with expected JSON output files.

Return type:

dict[str, Any]