Crate aur_fetch

aur-fetch

aur-fetch is a crate that manages downloading and diffing packages downloading from the AUR. This process is split up into many different steps to give maximum control of how diffs are handled and to ensure packages are never merged until the user has confirmed they have read them.

Note: This crate only deals with fetching packages. It assumes the list of packages you pass to it are pkgbases and therefore can not work with split packages. To deal with split packages the AUR RPC must be used to get the pkgbase from a pkgname.

Examples

Printing - Diffs

use aur_fetch::Handle;


let pkgs = vec!["discord", "spotify", "pacman-git"];

// Create our handle
let fetch = Handle::new()?;

// Clone/Fetch the packages.
let fetched = fetch.download(&pkgs).await?;

// Merge changes
fetch.merge(&fetched)?;

// Only diff packages that have not been reviewed
let to_diff = fetch.unseen(&pkgs)?;

// Print each diff
for (diff, pkg) in fetch.diff(&to_diff, true)?.iter().zip(pkgs.iter()) {
    println!("{}:", pkg);
    println!("{}", diff.trim());
}

Diff View

use aur_fetch::Handle;
use std::process::Command;


let pkgs = vec!["discord", "spotify", "pacman-git"];

// Create our handle
let fetch = Handle::new()?;

// Clone/Fetch the packages.
let fetched = fetch.download(&pkgs).await?;

// Merge the changes.
fetch.merge(&fetched)?;

// Save diffs to cache.
fetch.save_diffs(&fetched)?;

// Make a view of the new files so we can easily see them in the file browser
let dir = fetch.make_view(&pkgs, &fetched)?;
Command::new("vifm").arg(dir.path()).spawn()?.wait()?;

Using a Callback

use aur_fetch::Handle;


let pkgs = vec!["discord", "spotify", "pacman-git"];

// Create our handle
let fetch = Handle::new()?;

// Clone/Fetch the packages.
let feteched = fetch.download(&pkgs).await?;

// Download the packages, printing downloads as they complete.
let fetched = fetch.download_cb(&pkgs, |cb| {
    println!("Downloaded ({:0pad$}/{:0pad$}): {}", cb.n, pkgs.len(), cb.pkg, pad = 3);
}).await?;

// Merge the changes.
// In a real tool you would ask for user conformation before this
// As long as the changes are not merged this process can always be restarted and the diffs
// perserved
fetch.merge(&fetched)?;

Structs

Callback	Callback called whenever a download completes.
CommandFailed	Info for a command that exited non 0.
Handle	Handle to the current configuration.

Enums

Error

The error type for this crate.

Type Definitions

Result

Result type for this crate;