Struct MultiQueryDatabase 

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

Database to lookup queriers from their package names and repositories.

This type of database is designed for repository-aware use cases. For example: Multiple repositories whose packages may have duplicated names.

Implementations

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

pub fn extend<PairIter>( &mut self, pairs: PairIter, ) -> Result<(), InsertError<'_>>

where Querier: Query<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Extend the database with an iterator of tuples of a RepositoryName and an immutable querier of a desc file.

Old queriers which occupied the same pair of repository and name would be replaced.

pub fn extend_mut<PairIter>( &mut self, pairs: PairIter, ) -> Result<(), InsertError<'_>>

where Querier: QueryMut<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Extend the database with an iterator of tuples of a RepositoryName and a mutable querier of a desc file.

Old queriers which occupied the same pair of repository and name would be replaced.

pub fn extend_newer<PairIter>( &mut self, pairs: PairIter, ) -> Result<(), InsertError<'_>>

where Querier: Query<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Extend the database with an iterator of tuples of a RepositoryName and an immutable querier of a desc file.

An item from the iterator would replace an existing entry which occupied the same pair of repository and name if the iterator’s item has newer version than that of the existing entry.

pub fn extend_newer_mut<PairIter>( &mut self, pairs: PairIter, ) -> Result<(), InsertError<'_>>

where Querier: QueryMut<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Extend the database with an iterator of tuples of a RepositoryName and a mutable querier of a desc file.

An item from the iterator would replace an existing entry which occupied the same pair of repository and name if the iterator’s item has newer version than that of the existing entry.

impl<'a, Querier> MultiQueryDatabase<'a, Querier>

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

Get an immutable reference to a set of queriers of packages from different repositories by package name.

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

Get a mutable reference to a set of queriers of packages from different repositories by package name.

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

pub fn insert( &mut self, repository: RepositoryName<'a>, querier: Querier, ) -> Result<Option<Attached<Querier, ParsedVersion<'a>>>, InsertError<'a>>

where Querier: Query<'a>,

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

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

pub fn insert_mut( &mut self, repository: RepositoryName<'a>, querier: Querier, ) -> Result<Option<Attached<Querier, ParsedVersion<'a>>>, InsertError<'a>>

where Querier: QueryMut<'a>,

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

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

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

pub fn insert_newer( &mut self, repository: RepositoryName<'a>, querier: Querier, ) -> Result<InsertNewerReturn<'a, Querier>, InsertError<'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, repository: RepositoryName<'a>, querier: Querier, ) -> Result<InsertNewerReturn<'a, Querier>, InsertError<'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> MultiQueryDatabase<'a, Querier>

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

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

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

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

pub fn latest_entries(&self) -> LatestEntries<'_, 'a, Querier>

Get an iterator over all pairs of package names and immutable queriers of the latest versions of each package.

pub fn latest_entries_mut(&mut self) -> LatestEntriesMut<'_, 'a, Querier>

Get an iterator over all pairs of package names and mutable queriers of the latest versions of each package.

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

pub fn from_queriers<PairIter>(pairs: PairIter) -> Result<Self, InsertError<'a>>

where Querier: Query<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Construct a database with an iterator of tuples of a RepositoryName and an immutable querier of a desc file.

If there are collisions between pairs of repository and name, the later pair would override the earlier.

pub fn from_queriers_mut<PairIter>( pairs: PairIter, ) -> Result<Self, InsertError<'a>>

where Querier: QueryMut<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Construct a database with an iterator of tuples of a RepositoryName and a mutable querier of a desc file.

If there are collisions between pairs of repository and name, the later pair would override the earlier.

pub fn from_newer_queriers<PairIter>( pairs: PairIter, ) -> Result<Self, InsertError<'a>>

where Querier: Query<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Construct a database with an iterator of tuples of a RepositoryName and an immutable querier of a desc file.

If there are collisions between pairs of repository and name, the one with newer package version would override the older.

pub fn from_newer_queriers_mut<PairIter>( pairs: PairIter, ) -> Result<Self, InsertError<'a>>

where Querier: QueryMut<'a>, PairIter: IntoIterator<Item = (RepositoryName<'a>, Querier)>,

Construct a database with an iterator of tuples of a RepositoryName and a mutable querier of a desc file.

If there are collisions between pairs of repository and name, the one with newer package version would override the older.

impl<'a, Querier> MultiQueryDatabase<'a, Querier>

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

Get an iterator over all package names.

impl<'a, Querier> MultiQueryDatabase<'a, Querier>

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

Get an iterator over all immutable queriers.

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

Get an iterator over all mutable queriers.

pub fn latest_queriers(&self) -> LatestQueriers<'_, 'a, Querier>

Get an iterator over all immutable queriers of the latest versions of each package.

pub fn latest_queriers_mut(&mut self) -> LatestQueriersMut<'_, 'a, Querier>

Get an iterator over all mutable queriers of the latest versions of each package.

impl<Querier> MultiQueryDatabase<'_, Querier>

pub fn latest(&self) -> MultiQueryDatabaseLatest<&Self>

Combine the different repositories into a database view of immutable queriers that lookup the latest versions of packages.

pub fn latest_mut(&mut self) -> MultiQueryDatabaseLatest<&mut Self>

Combine the different repositories into a database view of mutable queriers that lookup the latest versions of packages.

impl<Querier> MultiQueryDatabase<'_, Querier>

pub fn len(&self) -> usize

The number of package names within the database.

pub fn is_empty(&self) -> bool

Whether the database is empty.

impl<Querier> MultiQueryDatabase<'_, 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<'query, Querier> MultiQueryDatabase<'query, Querier>

pub fn alternative_providers<'r, 'name>( &'r self, target: DependencyName<'name>, ) -> AlternativeProviders<'r, 'query, 'name, 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<'r, 'name>( &'r mut self, target: DependencyName<'name>, ) -> AlternativeProvidersMut<'r, 'query, 'name, 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 MultiQueryDatabase<'a, Querier>

fn clone(&self) -> MultiQueryDatabase<'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 MultiQueryDatabase<'a, Querier>

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

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

type IntoIter = MultiOwnedEntries<'a, Querier>

Which kind of iterator are we turning this into?

type Item = (Name<'a>, MultiQuerier<'a, Querier>)

The type of the elements being iterated over.

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.