feat(utils): upstream a few common functions

Author: fosskers

alpm-utils/src/alpm.rs

@@ -1,16 +1,18 @@
 use crate::depends::satisfies_ver;
-use alpm::{Alpm, Depend, Package, Result};
+use crate::DbListExt;
+use alpm::{Alpm, Depend, Package, PackageReason, Result, SigLevel};
+use std::path::Path;
 
 /// Extension methods to the [`Alpm`] type.
 pub trait AlpmExt {
     /// Try to find a [`Package`] that satisfies a given dependency.
-    fn find_local_satisfier<S>(&self, pkg: S) -> Result<Option<Package>>
+    fn find_local_satisfier<S>(&self, pkg: S) -> Result<Option<Package<'_>>>
     where
         S: Into<String>;
 }
 
 impl AlpmExt for Alpm {
-    fn find_local_satisfier<S>(&self, pkg: S) -> Result<Option<Package>>
+    fn find_local_satisfier<S>(&self, pkg: S) -> Result<Option<Package<'_>>>
     where
         S: Into<String>,
     {
@@ -26,3 +28,43 @@ impl AlpmExt for Alpm {
         Ok(localdb.pkgs().find_satisfier(pkg))
     }
 }
+
+/// All orphaned packages.
+///
+/// An orphan is a package that was installed as a dependency, but whose parent
+/// package is no longer installed.
+pub fn orphans(alpm: &Alpm) -> impl Iterator<Item = Package<'_>> {
+    alpm.localdb().pkgs().into_iter().filter(|p| {
+        p.reason() == PackageReason::Depend
+            && p.required_by().is_empty()
+            && p.optional_for().is_empty()
+    })
+}
+
+/// All official packages.
+pub fn officials(alpm: &Alpm) -> impl Iterator<Item = Package<'_>> {
+    let syncs = alpm.syncdbs();
+
+    alpm.localdb()
+        .pkgs()
+        .into_iter()
+        .filter_map(move |p| syncs.pkg(p.name()).ok())
+}
+
+/// All foreign packages as an `Iterator`.
+pub fn foreigns(alpm: &Alpm) -> impl Iterator<Item = Package<'_>> {
+    let syncs = alpm.syncdbs();
+
+    alpm.localdb()
+        .pkgs()
+        .into_iter()
+        .filter(move |p| syncs.pkg(p.name()).is_err())
+}
+
+/// Does the given `Path` point to a valid tarball that can can loaded by ALPM?
+pub fn is_valid_package(alpm: &Alpm, path: &Path) -> bool {
+    match path.to_str() {
+        None => false,
+        Some(p) => path.exists() && alpm.pkg_load(p, true, SigLevel::USE_DEFAULT).is_ok(),
+    }
+}