Struct Package

Source

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

Expand description

A single unique libapt package.

Implementations§

Source §

impl<'a> Package<'a>

Source

pub fn new(cache: &'a Cache, ptr: UniquePtr<PkgIterator>) -> Package<'a>

Source

pub fn rdepends(&self) -> &HashMap<DepType, Vec<Dependency<'a>>>

Returns a Reverse Dependency Map of the package

Dependencies are in a Vec<Dependency>

The Dependency struct represents an Or Group of dependencies.

For example where we use the crate::DepType::Depends key:

use rust_apt::{new_cache, DepType};
let cache = new_cache!().unwrap();
let pkg = cache.get("apt").unwrap();
for dep in pkg.rdepends().get(&DepType::Depends).unwrap() {
   if dep.is_or() {
       for base_dep in dep.iter() {
           println!("{}", base_dep.name())
       }
   } else {
       // is_or is false so there is only one BaseDep
       println!("{}", dep.first().name())
   }
}

Source

pub fn get_version(&'a self, version_str: &str) -> Option<Version<'a>>

Return either a Version or None

§Example:

use rust_apt::new_cache;

let cache = new_cache!().unwrap();
let pkg = cache.get("apt").unwrap();

pkg.get_version("2.4.7");

Source

pub fn is_installed(&self) -> bool

True if the Package is installed.

Source

pub fn has_versions(&self) -> bool

True if the package has versions.

If a package has no versions it is considered virtual.

Source

pub fn has_provides(&self) -> bool

True if the package provides any other packages.

Source

pub fn inst_state(&self) -> PkgInstState

The installed state of this package.

Source

pub fn selected_state(&self) -> PkgSelectedState

The selected state of this package.

Source

pub fn current_state(&self) -> PkgCurrentState

The current state of this package.

Source

pub fn installed(&self) -> Option<Version<'a>>

Returns the version object of the installed version.

If there isn’t an installed version, returns None

Source

pub fn candidate(&self) -> Option<Version<'a>>

Returns the version object of the candidate.

If there isn’t a candidate, returns None

Source

pub fn install_version(&self) -> Option<Version<'a>>

Returns the install version if it exists.

§This differs from `crate::Package::installed` in the

§following ways:

If a version is marked for install this will return the version to be installed.
If an installed package is marked for removal, this will return None.

Source

pub fn versions(&self) -> impl Iterator<Item = Version<'a>>

Returns a version list starting with the newest and ending with the oldest.

Source

pub fn provides(&self) -> impl Iterator<Item = Provider<'a>>

Returns a list of providers

Source

pub fn is_upgradable(&self) -> bool

Check if the package is upgradable.

§skip_depcache:

Skipping the DepCache is unnecessary if it’s already been initialized. If you’re unsure use false

true = Increases performance by skipping the pkgDepCache.
false = Use DepCache to check if the package is upgradable

Source

pub fn is_auto_installed(&self) -> bool

Check if the package is auto installed. (Not installed by the user)

Source

pub fn is_auto_removable(&self) -> bool

Check if the package is auto removable

Source

pub fn is_now_broken(&self) -> bool

Check if the package is now broken

Source

pub fn is_inst_broken(&self) -> bool

Check if the package package installed is broken

Source

pub fn marked_install(&self) -> bool

Check if the package is marked install

Source

pub fn marked_upgrade(&self) -> bool

Check if the package is marked upgrade

Source

pub fn marked_purge(&self) -> bool

Check if the package is marked purge

Source

pub fn marked_delete(&self) -> bool

Check if the package is marked delete

Source

pub fn marked_keep(&self) -> bool

Check if the package is marked keep

Source

pub fn marked_downgrade(&self) -> bool

Check if the package is marked downgrade

Source

pub fn marked_reinstall(&self) -> bool

Check if the package is marked reinstall

Source

pub fn mark_auto(&self, mark_auto: bool) -> bool

§Mark a package as automatically installed.

§mark_auto:

true = Mark the package as automatically installed.
false = Mark the package as manually installed.

Source

pub fn mark_keep(&self) -> bool

§Mark a package for keep.

§Returns:

true if the mark was successful
false if the mark was unsuccessful

This means that the package will not be changed from its current version. This will not stop a reinstall, but will stop removal, upgrades and downgrades

We don’t believe that there is any reason to unmark packages for keep. If someone has a reason, and would like it implemented, please put in a feature request.

Source

pub fn mark_delete(&self, purge: bool) -> bool

§Mark a package for removal.

§Returns:

true if the mark was successful
false if the mark was unsuccessful

§purge:

true = Configuration files will be removed along with the package.
false = Only the package will be removed.

Source

pub fn mark_install(&self, auto_inst: bool, from_user: bool) -> bool

§Mark a package for installation.

§auto_inst:

true = Additionally mark the dependencies for this package.
false = Mark only this package.

§from_user:

true = The package will be marked manually installed.
false = The package will be unmarked automatically installed.

§Returns:

true if the mark was successful
false if the mark was unsuccessful

If a package is already installed, at the latest version, and you mark that package for install you will get true, but the package will not be altered. pkg.marked_install() will be false

Source