Struct Scan 

pub struct Scan { /* private fields */ }

Package dependency scanner.

Discovers all dependencies for a set of packages and resolves them into a buildable set with proper ordering.

Usage

1. Create a Scan with Scan::new
2. Add packages to scan with Scan::add
3. Run the scan with Scan::start
4. Resolve dependencies with Scan::resolve

Example

let config = Config::load(None, false)?;
let db_path = config.logdir().join("bob").join("bob.db");
let db = Database::open(&db_path)?;
let mut scan = Scan::new(&config);

scan.add(&PkgPath::new("mail/mutt")?);
let ctx = RunContext::new(Arc::new(AtomicBool::new(false)));
scan.start(&ctx, &db)?;

let result = scan.resolve(&db)?;
println!("Found {} buildable packages", result.buildable.len());

Implementations

impl Scan

pub fn new(config: &Config) -> Scan

pub fn add(&mut self, pkgpath: &PkgPath)

pub fn is_full_tree(&self) -> bool

Returns true if this is a full tree scan.

pub fn set_full_scan_complete(&mut self)

Mark that a previous full tree scan completed successfully.

pub fn init_from_db(&mut self, db: &Database) -> Result<(usize, usize)>

Initialize scan from database, checking what’s already scanned. Returns (cached_count, pending_deps_count) where pending_deps_count is the number of dependencies discovered but not yet scanned (from interrupted scans).

pub fn start(&mut self, ctx: &RunContext, db: &Database) -> Result<bool>

pub fn scan_errors(&self) -> impl Iterator<Item = &str>

Returns scan failures as formatted error strings.

pub fn scan_failures(&self) -> &[(PkgPath, String)]

Returns scan failures with pkgpath information.

pub fn scan_pkgpath(&self, pkgpath: &PkgPath) -> Result<Vec<ScanIndex>>

Scan a single PKGPATH, returning a Vec of ScanIndex results, as multi-version packages may return multiple results.

pub fn resolve(&mut self, db: &Database) -> Result<ScanResult>

Resolve the list of scanned packages, by ensuring all of the Depend patterns in all_depends match a found package, and that there are no circular dependencies. The best match for each is stored in the depends for the package in question.

Return a ScanResult containing buildable packages and skipped packages.

Also stores resolved dependencies in the database for fast reverse lookups.

Trait Implementations

impl Debug for Scan

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Scan

fn default() -> Scan

Returns the “default value” for a type.