Struct InstalledPackage

pub struct InstalledPackage {
    name: Name,
    version: FullVersion,
    architecture: Architecture,
}

Information on an installed package in an environment

Tracks the Name, FullVersion and an Architecture of a package in an environment.

Examples

use std::str::FromStr;

use alpm_types::{Architecture, FullVersion, InstalledPackage, Name};
assert_eq!(
    InstalledPackage::from_str("foo-bar-1:1.0.0-1-any")?,
    InstalledPackage::new(
        Name::new("foo-bar")?,
        FullVersion::from_str("1:1.0.0-1")?,
        Architecture::Any
    )
);
assert_eq!(
    InstalledPackage::from_str("foo-bar-1.0.0-1-any")?,
    InstalledPackage::new(
        Name::new("foo-bar")?,
        FullVersion::from_str("1.0.0-1")?,
        Architecture::Any
    )
);

Fields

name: Name

version: FullVersion

architecture: Architecture

Implementations

impl InstalledPackage

pub fn new(name: Name, version: FullVersion, architecture: Architecture) -> Self

Creates a new InstalledPackage.

Examples

use std::str::FromStr;

use alpm_types::InstalledPackage;

assert_eq!(
    "example-1:1.0.0-1-x86_64",
    InstalledPackage::new("example".parse()?, "1:1.0.0-1".parse()?, "x86_64".parse()?)
        .to_string()
);

pub fn name(&self) -> &Name

Returns a reference to the Name.

Examples

use std::str::FromStr;

use alpm_types::{InstalledPackage, Name};

let file_name =
    InstalledPackage::new("example".parse()?, "1:1.0.0-1".parse()?, "x86_64".parse()?);

assert_eq!(file_name.name(), &Name::new("example")?);

pub fn version(&self) -> &FullVersion

Returns a reference to the FullVersion.

Examples

use std::str::FromStr;

use alpm_types::{FullVersion, InstalledPackage};

let file_name =
    InstalledPackage::new("example".parse()?, "1:1.0.0-1".parse()?, "x86_64".parse()?);

assert_eq!(file_name.version(), &FullVersion::from_str("1:1.0.0-1")?);

pub fn architecture(&self) -> Architecture

Returns the Architecture.

Examples

use std::str::FromStr;

use alpm_types::{Architecture, InstalledPackage};

let file_name =
    InstalledPackage::new("example".parse()?, "1:1.0.0-1".parse()?, "x86_64".parse()?);

assert_eq!(file_name.architecture(), Architecture::X86_64);

pub fn parser(input: &mut &str) -> ModalResult<Self>

Recognizes an InstalledPackage in a string slice.

Relies on [winnow] to parse input and recognize the Name, FullVersion, and Architecture components.

Errors

Returns an error if

• the Name component can not be recognized,
• the FullVersion component can not be recognized,
• or the Architecture component can not be recognized.

Examples

use alpm_types::InstalledPackage;
use winnow::Parser;

let name = "example-package-1:1.0.0-1-x86_64";
assert_eq!(name, InstalledPackage::parser.parse(name)?.to_string());

Trait Implementations

impl Clone for InstalledPackage

fn clone(&self) -> InstalledPackage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstalledPackage

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

Formats the value using the given formatter.

impl Display for InstalledPackage

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

Formats the value using the given formatter.

impl From<PackageFileName> for InstalledPackage

fn from(value: PackageFileName) -> Self

Creates a InstalledPackage from a PackageFileName.

impl FromStr for InstalledPackage

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

Creates an InstalledPackage from a string slice.

Delegates to InstalledPackage::parser.

Errors

Returns an error if InstalledPackage::parser fails.

Examples

use std::str::FromStr;

use alpm_types::InstalledPackage;

let filename = "example-package-1:1.0.0-1-x86_64";
assert_eq!(filename, InstalledPackage::from_str(filename)?.to_string());

type Err = Error

The associated error which can be returned from parsing.

impl Ord for InstalledPackage

fn cmp(&self, other: &InstalledPackage) -> 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 InstalledPackage

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

fn partial_cmp(&self, other: &InstalledPackage) -> 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 InstalledPackage

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 InstalledPackage

impl StructuralPartialEq for InstalledPackage