Struct rust_apt::package::Version

pub struct Version<'a> { /* private fields */ }

A struct representing a version of an apt Package

Implementations

impl<'a> Version<'a>

pub fn parent(&self) -> Package<'_>

Return the version’s parent package.

pub fn arch(&self) -> String

The architecture of the version.

pub fn version(&self) -> String

The version string of the version. “1.4.10”

pub fn section(&self) -> String

The section of the version as shown in apt show.

pub fn provides_list(&self) -> Vec<(String, Option<String>)>

The list of packages that this package provides for.

The first item in the returned tuple is the package name of the provided package. The second is the version, if it has been specified. I.e. if Provides: rustc was in a control file, you’d get ("rustc", None). If you had Provides: rustc (= 1.5) on the other hand, you’d get ("rustc", Some("1.5")).

If you need to see what packages provide this version’s parent package, use Package::rev_provides_list instead.

pub fn priority_str(&self) -> String

The priority string as shown in apt show.

pub fn source_name(&self) -> String

The name of the source package the version was built from.

pub fn source_version(&self) -> String

The version of the source package.

pub fn priority(&self) -> i32

The priority of the package as shown in apt policy.

pub fn size(&self) -> u64

The size of the .deb file.

pub fn installed_size(&self) -> u64

The uncompressed size of the .deb file.

pub fn id(&self) -> u32

The ID of the version.

pub fn downloadable(&self) -> bool

If the version is able to be downloaded.

pub fn is_installed(&self) -> bool

Check if the version is installed

pub fn set_candidate(&self)

Set this version as the candidate.

pub fn depends_map(&self) -> &HashMap<String, Vec<Dependency>>

Returns a reference to the Dependency Map owned by the Version

let keys = [
   "Depends",
   "PreDepends",
   "Suggests",
   "Recommends",
   "Conflicts",
   "Replaces",
   "Obsoletes",
   "Breaks",
   "Enhances",
];

Dependencies are in a Vec<Dependency>

The Dependency struct represents an Or Group of dependencies. The base deps are located in Dependency.base_deps

For example where we use the "Depends" key:

use rust_apt::cache::Cache;
let cache = Cache::new();
let version = cache.get("apt").unwrap().candidate().unwrap();
for dep in version.depends_map().get("Depends").unwrap() {
   if dep.is_or() {
       for base_dep in &dep.base_deps {
           println!("{}", base_dep.name())
       }
   } else {
       // is_or is false so there is only one BaseDep
       println!("{}", dep.first().name())
   }
}

pub fn get_depends(&self, key: &str) -> Option<&Vec<Dependency>>

Returns a reference Vector, if it exists, for the given key.

See the doc for depends_map() for more information.

pub fn enhances(&self) -> Option<&Vec<Dependency>>

Returns a Reference Vector, if it exists, for “Enhances”.

pub fn dependencies(&self) -> Option<Vec<&Dependency>>

Returns a Reference Vector, if it exists, for “Depends” and “PreDepends”.

pub fn recommends(&self) -> Option<&Vec<Dependency>>

Returns a Reference Vector, if it exists, for “Recommends”.

pub fn suggests(&self) -> Option<&Vec<Dependency>>

Returns a Reference Vector, if it exists, for “suggests”.

pub fn description(&self) -> String

Get the translated long description

pub fn summary(&self) -> String

Get the translated short description

pub fn sha256(&self) -> Option<String>

Get the sha256 hash. If there isn’t one returns None This is equivalent to version.hash("sha256")

pub fn sha512(&self) -> Option<String>

Get the sha512 hash. If there isn’t one returns None This is equivalent to version.hash("sha512")

pub fn hash(&self, hash_type: &str) -> Option<String>

Get the hash specified. If there isn’t one returns None version.hash("md5sum")

pub fn package_files(&self) -> impl Iterator<Item = PackageFile> + '_

Returns an iterator of PackageFiles (Origins) for the version

pub fn uris(&self) -> impl Iterator<Item = String> + '_

Returns an iterator of URIs for the version

Trait Implementations

impl<'a> Debug for Version<'a>

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

Formats the value using the given formatter.

impl<'a> Display for Version<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq<Version<'a>> for Version<'a>

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

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

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

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

impl<'a> PartialOrd<Version<'a>> for Version<'a>

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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