Struct QueryDatabase 

pub struct QueryDatabase<'a, Querier> { /* private fields */ }

Database to lookup queriers from their package names.

This type of database is designed for repository-unaware use cases such as:

• Local packages: Packages that have been installed into the system.
• Single repository archive.
• Merging multiple repository archives where duplications don’t exist.

Implementations

impl<'a, Querier: ShouldReuse> QueryDatabase<'a, Querier>

pub fn extend<QuerierIter>( &mut self, queriers: QuerierIter, ) -> Result<(), InsertError>

where Querier: Query<'a>, QuerierIter: IntoIterator<Item = Querier>,

Extend the database with an iterator of immutable queriers of desc files.

Old queriers which occupied the same name as some of the new queriers would be replaced.

pub fn extend_mut<QuerierIter>( &mut self, queriers: QuerierIter, ) -> Result<(), InsertError>

where Querier: QueryMut<'a>, QuerierIter: IntoIterator<Item = Querier>,

Extend the database with an iterator of mutable queriers of desc files.

Old queriers which occupied the same name as some of the new queriers would be replaced.

pub fn extend_newer<QuerierIter>( &mut self, queriers: QuerierIter, ) -> Result<(), InsertNewerError<'_>>

where Querier: Query<'a>, QuerierIter: IntoIterator<Item = Querier>,

Extend the database with an iterator of immutable queriers of desc files that don’t share the same name as an existing querier with a newer-or-equal package version.

pub fn extend_newer_mut<QuerierIter>( &mut self, queriers: QuerierIter, ) -> Result<(), InsertNewerError<'_>>

where Querier: QueryMut<'a>, QuerierIter: IntoIterator<Item = Querier>,

Extend the database with an iterator of mutable queriers of desc files that don’t share the same name as an existing querier with a newer-or-equal package version.

impl<Querier> QueryDatabase<'_, Querier>

pub fn get(&self, name: Name<'_>) -> Option<&Querier>

Get an immutable reference to a querier by package name.

pub fn get_mut(&mut self, name: Name<'_>) -> Option<&mut Querier>

Get a mutable reference to a querier by package name.

impl<'a, Querier: ShouldReuse> QueryDatabase<'a, Querier>

pub fn insert( &mut self, querier: Querier, ) -> Result<Option<Querier>, InsertError>

where Querier: Query<'a>,

Add an immutable querier of a desc file to the database.

If an older querier already occupied the same name, it will be returned inside Ok(Some(_)).

pub fn insert_mut( &mut self, querier: Querier, ) -> Result<Option<Querier>, InsertError>

where Querier: QueryMut<'a>,

Add a mutable querier of a desc file to the database.

If an older querier already occupied the same name, it will be returned inside Ok(Some(_)).

impl<'a, Querier: ShouldReuse> QueryDatabase<'a, Querier>

pub fn insert_newer( &mut self, querier: Querier, ) -> Result<InsertNewerReturn<Querier>, InsertNewerError<'a>>

where Querier: Query<'a>,

Add an immutable querier of a desc file to the database unless the entry was already occupied by a querier whose package version is not older than the provided querier.

pub fn insert_newer_mut( &mut self, querier: Querier, ) -> Result<InsertNewerReturn<Querier>, InsertNewerError<'a>>

where Querier: QueryMut<'a>,

Add a mutable querier of a desc file to the database unless the entry was already occupied by a querier whose package version is not older than the provided querier.

impl<'a, Querier> QueryDatabase<'a, Querier>

pub fn entries(&self) -> Entries<'_, 'a, Querier>

Get an iterator over all pairs of package names and immutable queriers.

pub fn entries_mut(&mut self) -> EntriesMut<'_, 'a, Querier>

Get an iterator over all pairs of package names and mutable queriers.

impl<'a, Querier: ShouldReuse> QueryDatabase<'a, Querier>

pub fn from_queriers<QuerierIter>( queriers: QuerierIter, ) -> Result<Self, InsertError>

where Querier: Query<'a>, QuerierIter: IntoIterator<Item = Querier>,

Construct a database with an iterator of immutable queriers of desc files.

If there are collisions between queriers in name, the later querier would override the earlier.

pub fn from_queriers_mut<QuerierIter>( queriers: QuerierIter, ) -> Result<Self, InsertError>

where Querier: QueryMut<'a>, QuerierIter: IntoIterator<Item = Querier>,

Construct a database with an iterator of mutable queriers of desc files.

If there are collisions between queriers in name, the later querier would override the earlier.

pub fn from_newer_queriers<QuerierIter>( queriers: QuerierIter, ) -> Result<Self, InsertNewerError<'a>>

where Querier: Query<'a>, QuerierIter: IntoIterator<Item = Querier>,

Construct a database from an iterator of immutable queriers of desc files.

If there are collisions between queriers in name, the one with newer package version would override the older.

pub fn from_newer_queriers_mut<QuerierIter>( queriers: QuerierIter, ) -> Result<Self, InsertNewerError<'a>>

where Querier: QueryMut<'a>, QuerierIter: IntoIterator<Item = Querier>,

Construct a database from an iterator of mutable queriers of desc files.

If there are collisions between queriers in name, the one with newer package version would override the older.

impl<'a, Querier> QueryDatabase<'a, Querier>

pub fn names(&self) -> Names<'_, 'a, Querier>

Get an iterator over all package names.

impl<'a, Querier> QueryDatabase<'a, Querier>

pub fn queriers(&self) -> Queriers<'_, 'a, Querier>

Get an iterator over all immutable queriers.

pub fn queriers_mut(&mut self) -> QueriersMut<'_, 'a, Querier>

Get an iterator over all mutable queriers.

impl<'a, Querier> QueryDatabase<'a, Querier>

pub fn len(&self) -> usize

The number of queriers within the database.

pub fn is_empty(&self) -> bool

Whether the database is empty.

impl<Querier> QueryDatabase<'_, Querier>

pub fn new() -> Self

Create an empty database.

pub fn with_capacity(capacity: usize) -> Self

Create an empty database with at least the specified capacity.

impl<Querier> QueryDatabase<'_, Querier>

pub fn alternative_providers<'a>( &'a self, target: DependencyName<'a>, ) -> AlternativeProviders<'a, 'a, Querier>

Get an iterator over all immutable queriers of packages which list a certain DependencyName in their provides array.

This method is prefixed with “alternative” because a package doesn’t usually list itself in its own provides, and consequently, would usually be excluded from this iterator. Beware that if it does list itself, its own name would be included.

pub fn alternative_providers_mut<'a>( &'a mut self, target: DependencyName<'a>, ) -> AlternativeProvidersMut<'a, 'a, Querier>

Get an iterator over all mutable queriers of packages which list a certain DependencyName in their provides array.

This method is prefixed with “alternative” because a package doesn’t usually list itself in its own provides, and consequently, would usually be excluded from this iterator. Beware that if it does list itself, its own name would be included.

Trait Implementations

impl<'a, Querier: Clone> Clone for QueryDatabase<'a, Querier>

fn clone(&self) -> QueryDatabase<'a, Querier>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, Querier: Debug> Debug for QueryDatabase<'a, Querier>

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

Formats the value using the given formatter.

impl<Querier> Default for QueryDatabase<'_, Querier>

fn default() -> Self

Returns the “default value” for a type.

impl<'a, Querier> IntoIterator for QueryDatabase<'a, Querier>

type IntoIter = OwnedEntries<'a, Querier>

Which kind of iterator are we turning this into?

type Item = Entry<'a, Querier>

The type of the elements being iterated over.

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.