Struct ContractIdentity 

pub struct ContractIdentity { /* private fields */ }

Available on crate feature deployment only.

Three-key identity stamped on every deployment artefact.

Construct via ContractIdentity::new when both inputs are known up front (typical for the push step that has the registry digest), or via ContractIdentity::detect to auto-resolve source_commit from CI env or local git when only image_ref is in hand.

Implementations

impl ContractIdentity

pub fn new( source_commit: impl Into<String>, image_ref: impl Into<String>, ) -> Result<Self, IdentityError>

Construct from explicit inputs.

source_commit must be 40-char lowercase hex (no sha256: prefix – it’s a git SHA, not a content hash). image_ref must be non-empty and include an explicit registry host (no implicit docker.io).

Errors

Returns IdentityError::InvalidSourceCommit or IdentityError::InvalidImageRef when validation fails.

pub fn detect(image_ref: impl Into<String>) -> Result<Self, IdentityError>

Auto-detect source_commit from the CI env (GITHUB_SHA) or git rev-parse HEAD and combine with the caller-supplied image_ref.

image_ref always comes from the caller because it derives from the contract (<image_registry>/<app_name>:<tag>) and the detection layer has no business reading the contract.

Errors

Returns IdentityError::DetectFailed when neither source works, or IdentityError::InvalidImageRef when the caller-supplied ref fails validation.

pub fn version(&self) -> &'static str

Schema version literal ("v1" in this build).

pub fn source_commit(&self) -> &str

40-char lowercase hex git SHA of the consumer app’s HEAD.

pub fn image_ref(&self) -> &str

Intended pull reference for the container image.

pub fn as_dockerfile_labels(&self) -> String

Render as three Dockerfile LABEL lines, in canonical order (version, source-commit, image-ref). No trailing newline; the caller is responsible for any separator.

pub fn as_yaml_annotations(&self, indent: usize) -> String

Render as three YAML annotation lines, indented by indent spaces. Suitable for inclusion under metadata.annotations: (ArgoCD Application) or top-level annotations: (Helm Chart.yaml). No trailing newline.

Trait Implementations

impl Clone for ContractIdentity

fn clone(&self) -> ContractIdentity

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContractIdentity

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ContractIdentity

impl PartialEq for ContractIdentity

fn eq(&self, other: &ContractIdentity) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ContractIdentity