Struct exonum::runtime::versioning::ArtifactReq

#[non_exhaustive]pub struct ArtifactReq {
    pub name: String,
    pub version: VersionReq,
}

Requirement on an artifact. Can be matched against artifact identifiers.

Examples

// Requirements can be parsed from a string.
let req: ArtifactReq = "some.Service@^1.3.0".parse()?;

let valid_artifact = ArtifactId::new(
    RuntimeIdentifier::Rust as u32,
    "some.Service".to_owned(),
    "1.5.7".parse()?,
)?;
assert!(req.try_match(&valid_artifact).is_ok());

// This artifact is outdated.
let mut outdated_artifact = valid_artifact.clone();
outdated_artifact.version = "1.2.0".parse()?;
assert!(req.try_match(&outdated_artifact).is_err());

// This artifact is too new.
let mut novel_artifact = valid_artifact.clone();
novel_artifact.version = "2.0.0".parse()?;
assert!(req.try_match(&novel_artifact).is_err());

// This artifact has wrong name.
let mut other_artifact = valid_artifact.clone();
other_artifact.name = "other.Service".to_owned();
assert!(req.try_match(&novel_artifact).is_err());

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

Artifact name.

version: VersionReq

Allowed artifact versions.

Methods

impl ArtifactReq

pub fn new(name: impl Into<String>, version: VersionReq) -> Self

Creates a new artifact requirement.

pub fn try_match(&self, artifact: &ArtifactId) -> Result<(), ArtifactReqError>

Tries to match this requirement against the provided artifact.

Trait Implementations

impl Clone for ArtifactReq

fn clone(&self) -> ArtifactReq

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactReq

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

Formats the value using the given formatter.

impl Display for ArtifactReq

fn fmt(&self, formatter: &mut Formatter) -> Result

Formats the value using the given formatter.

impl FromStr for ArtifactReq

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq<ArtifactReq> for ArtifactReq

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for ArtifactReq