Struct LocalRegistrySource 

pub struct LocalRegistrySource {
    root: PathBuf,
}

A Source backed by a directory tree laid out like a registry: <root>/<namespace>/<name>/<version>.webc, or <root>/<name>/<version>.webc for un-namespaced packages.

Queries are answered from the layout alone: a named query lists the queried package’s directory and picks versions off the file names, so only the webcs that match the version constraint are ever opened. A large tree costs no more than the packages actually resolved.

Fields

root: PathBuf

Implementations

impl LocalRegistrySource

pub fn new(root: impl Into<PathBuf>) -> Result<Self, Error>

fn query_named( &self, named: &NamedPackageIdent, query: &PackageSource, ) -> Result<Vec<PackageSummary>, QueryError>

fn query_hash( &self, hash: &PackageHash, query: &PackageSource, ) -> Result<Vec<PackageSummary>, QueryError>

fn find_by_hash( &self, hash: &PackageHash, ) -> Result<Option<PackageSummary>, Error>

Walk the tree for a webc with this hash, stopping at the first match. This is the one query shape the layout can’t index. The .sha256 sidecars rule files in or out without opening them, so they are all consulted first; only if none matched are the sidecar-less webcs hashed.

Trait Implementations

impl Clone for LocalRegistrySource

fn clone(&self) -> LocalRegistrySource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LocalRegistrySource

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

Formats the value using the given formatter.

impl PartialEq for LocalRegistrySource

fn eq(&self, other: &LocalRegistrySource) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Source for LocalRegistrySource

fn query<'life0, 'life1, 'async_trait>( &'life0 self, package: &'life1 PackageSource, ) -> Pin<Box<dyn Future<Output = Result<Vec<PackageSummary>, QueryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Ask this source which packages would satisfy a particular Dependency constraint.

fn latest<'life0, 'life1, 'async_trait>( &'life0 self, pkg: &'life1 PackageSource, ) -> Pin<Box<dyn Future<Output = Result<PackageSummary, QueryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run Source::query() and get the PackageSummary for the latest version.

impl Eq for LocalRegistrySource

impl StructuralPartialEq for LocalRegistrySource