Struct Package

pub struct Package {
    pub version: String,
    pub git_commit_hash: Option<String>,
    pub target: BTreeMap<String, Artefact>,
}

A single package installable from this release channel.

Building a package for a particular target produces an artefact, but every artefact should be built from the same source.

Fields

version: String

A human-readable version-number for this package.

This should be a SemVer version number of the form X.Y.Z, followed by a space, an open-parenthesis, a Git commit ID truncated to 9 digits, a space, the date of that commit in YYYY-MM-DD format, and a close-parenthesis:

1.2.3 (a1b2c3d4e 2018-02-26)

git_commit_hash: Option<String>

The complete Git commit ID of this version of this package.

May not be present if the commit ID is not known, or this package’s source is not stored in a Git repository.

target: BTreeMap<String, Artefact>

A mapping from target names to Artefacts of this package built for that target.

A target name (sometimes “target triplet”, although there’s not always three parts) is a name that identifies a particular hardware and software platform, such as x86_64-unknown-linux-gnu (for modern Linux PCs) or i686-pc-windows-msvc (for 32-bit Windows with the Visual C++ compiler). Software built for a particular target usually won’t work on a different target, so if you’re looking for a particular package you’ll want to get the artefact for the platform you’re using.

The special target name * (an asterisk) is used for packages that are the same on every concievable platform, like rust-src which contains the Rust source code.

Implementations

impl Package

pub fn new(version: String) -> Package

Create a new, empty Package whose version is set to the given value.

By convention, version is in the format X.Y.Z (HHHHHHH YYYY-MM-DD) where X.Y.Z is a SemVer version string, HHHHHHH is the abbreviated commit ID of the source repository at that version, and YYYY-MM-DD is the date when that version was released.

let pkg = rust_release_channel::Package::new(
    "1.2.3 (abc1234 2018-02-26)".into()
);

Trait Implementations

impl Clone for Package

fn clone(&self) -> Package

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Package

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Package

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Package

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

Formats the value using the given formatter.

impl Hash for Package

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Package

fn cmp(&self, other: &Package) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Package

fn eq(&self, other: &Package) -> 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 PartialOrd for Package

fn partial_cmp(&self, other: &Package) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Package

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Package

impl StructuralPartialEq for Package