22 releases
0.11.3 | Nov 15, 2024 |
---|---|
0.11.2 | Nov 21, 2022 |
0.11.0 | Jul 9, 2022 |
0.10.0 | Sep 21, 2021 |
0.1.0 | Mar 22, 2019 |
#451 in Unix APIs
16,586 downloads per month
Used in paru
30KB
669 lines
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::Fetch;
let pkgs = vec!["discord", "spotify", "pacman-git"];
// Create our handle
let fetch = Fetch::new()?;
// Clone/Fetch the packages.
let fetched = fetch.download(&pkgs)?;
// 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::Fetch;
use std::process::Command;
let pkgs = vec!["discord", "spotify", "pacman-git"];
// Create our handle
let fetch = Fetch::new()?;
// Clone/Fetch the packages.
let fetched = fetch.download(&pkgs)?;
// 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( "/tmp/aur_view", &pkgs, &fetched)?;
Command::new("vifm").arg("/tmp/aur_view").spawn()?.wait()?;
Using a Callback
use aur_fetch::Fetch;
let pkgs = vec!["discord", "spotify", "pacman-git"];
// Create our handle
let fetch = Fetch::new()?;
// Clone/Fetch the packages.
let feteched = fetch.download(&pkgs)?;
// 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);
})?;
// 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)?;
Dependencies
~2.2–3.5MB
~58K SLoC