Struct PackageManager 

pub struct PackageManager { /* private fields */ }

Package manager

Implementations

impl PackageManager

pub fn new() -> Self

pub fn signature_policy(&self) -> &SignaturePolicy

Get a reference to the current signature policy.

pub fn set_signature_policy(&mut self, policy: SignaturePolicy)

Replace the signature policy.

pub fn trusted_keys_mut(&mut self) -> &mut TrustedKeyRing

Get a mutable reference to the trusted key ring.

pub fn add_repository(&mut self, repo: Repository)

Add a repository

pub fn install(&mut self, name: String, version_req: String) -> PkgResult<()>

Install a package by name and version.

Uses the default SignaturePolicy – signatures are required and force_unsigned is false.

pub fn install_with_options( &mut self, name: String, version_req: String, options: InstallOptions, ) -> PkgResult<()>

Install a package with explicit install options.

When options.force_unsigned is true, a failed signature verification produces a warning instead of a hard error. A hash mismatch (if expected_hash is provided) always fails regardless.

pub fn remove(&mut self, package_id: &PackageId) -> PkgResult<()>

Remove an installed package

pub fn remove_preserving_configs( &mut self, package_id: &PackageId, ) -> PkgResult<()>

Remove a package, preserving user-modified config files.

Config files that the user has edited are saved with a .bak suffix instead of being deleted.

pub fn remove_orphans(&mut self) -> PkgResult<Vec<PackageId>>

Find and remove orphan packages (packages with no reverse dependencies).

Returns the list of removed package names.

pub fn list_installed(&self) -> Vec<(PackageId, Version)>

List installed packages

pub fn is_installed(&self, package_id: &PackageId) -> bool

Check if package is installed

pub fn get_metadata(&self, package_id: &PackageId) -> Option<&PackageMetadata>

Get installed package metadata

pub fn update(&mut self) -> PkgResult<()>

Update package lists from repositories

pub fn begin_transaction(&mut self) -> PkgResult<()>

Begin an atomic transaction.

All install/remove operations after this call are staged and only applied when commit_transaction() is called. If any operation fails or rollback_transaction() is called, the package state reverts to the snapshot taken here.

pub fn commit_transaction(&mut self) -> PkgResult<()>

Commit the current transaction, persisting state to the database.

pub fn rollback_transaction(&mut self) -> PkgResult<()>

Roll back the current transaction, restoring the pre-transaction state.

pub fn upgrade(&mut self, package_id: &str) -> PkgResult<()>

Upgrade a single installed package to the latest available version.

pub fn upgrade_all(&mut self) -> PkgResult<usize>

Upgrade all installed packages to their latest available versions.

pub fn search(&self, query: &str) -> Vec<(PackageId, Version)>

Search available packages by name substring.

pub fn get_package_info(&self, package_id: &str) -> Option<PackageMetadata>

Get detailed information about a package (installed or available).

pub fn file_manifest(&self) -> &FileManifest

Get a reference to the file manifest.

pub fn file_manifest_mut(&mut self) -> &mut FileManifest

Get a mutable reference to the file manifest.

pub fn database(&self) -> &PackageDatabase

Get a reference to the persistent database.

pub fn database_mut(&mut self) -> &mut PackageDatabase

Get a mutable reference to the persistent database.

Trait Implementations

impl Default for PackageManager

fn default() -> Self

Returns the “default value” for a type.