RSPImageTag¶

class controller.models.domain.rsptag.RSPImageTag(tag, image_type, version, cycle, display_name, date)¶

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)
version (Version | None)
cycle (int | None)
display_name (str)
date (datetime | None)

Attributes Summary

`cycle`	XML schema version implemented by this image (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.
`image_type`	Type (release series) of image identified by this tag.
`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`.

Attributes Documentation

cycle: int | None = <dataclasses._MISSING_TYPE object>¶: XML schema version implemented by this image (only for T&S builds).

date: datetime | None = <dataclasses._MISSING_TYPE object>¶

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

We try to derive this from the tag string: For RSP daily or weekly tags (or experimentals in one of those formats), we can calculate this to within a day or a week, which is good enough for display purposes. Otherwise, we may be able to extract this info from the registry, but even if we can, it may be image upload time rather than creation time.

display_name: str = <dataclasses._MISSING_TYPE object>¶: Human-readable display name.

image_type: RSPImageType = <dataclasses._MISSING_TYPE object>¶: Type (release series) of image identified by this tag.

tag: str = <dataclasses._MISSING_TYPE object>¶: The tag itself, unmodified.

version: Version | None = <dataclasses._MISSING_TYPE object>¶: 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