Trait cargo::core::source::Source [−][src]
Something that finds and downloads remote packages based on names and versions.
Required methods
fn source_id(&self) -> SourceId
[src]
Returns the SourceId
corresponding to this source.
fn supports_checksums(&self) -> bool
[src]
Returns whether or not this source will return summaries with checksums listed.
fn requires_precise(&self) -> bool
[src]
Returns whether or not this source will return summaries with
the precise
field in the source id listed.
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
Attempts to find the packages that match a dependency request.
fn fuzzy_query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
Attempts to find the packages that are close to a dependency request.
Each source gets to define what close
means for it.
Path/Git sources may return all dependencies that are at that URI,
whereas an Index
source may return dependencies that have the same canonicalization.
fn update(&mut self) -> CargoResult<()>
[src]
Performs any network operations required to get the entire list of all names,
versions and dependencies of packages managed by the Source
.
fn download(&mut self, package: PackageId) -> CargoResult<MaybePackage>
[src]
Fetches the full package for each name and version specified.
fn finish_download(
&mut self,
package: PackageId,
contents: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
package: PackageId,
contents: Vec<u8>
) -> CargoResult<Package>
fn fingerprint(&self, pkg: &Package) -> CargoResult<String>
[src]
Generates a unique string which represents the fingerprint of the current state of the source.
This fingerprint is used to determine the “fresheness” of the source later on. It must be guaranteed that the fingerprint of a source is constant if and only if the output product will remain constant.
The pkg
argument is the package which this fingerprint should only be
interested in for when this source may contain multiple packages.
fn describe(&self) -> String
[src]
Describes this source in a human readable fashion, used for display in resolver error messages currently.
fn add_to_yanked_whitelist(&mut self, pkgs: &[PackageId])
[src]
Add a number of crates that should be whitelisted for showing up during queries, even if they are yanked. Currently only applies to registry sources.
fn is_yanked(&mut self, _pkg: PackageId) -> CargoResult<bool>
[src]
Query if a package is yanked. Only registry sources can mark packages as yanked. This ignores the yanked whitelist.
Provided methods
fn replaced_source_id(&self) -> SourceId
[src]
Returns the replaced SourceId
corresponding to this source.
fn query_vec(&mut self, dep: &Dependency) -> CargoResult<Vec<Summary>>
[src]
fn download_now(
self: Box<Self>,
package: PackageId,
config: &Config
) -> CargoResult<Package> where
Self: Sized,
[src]
self: Box<Self>,
package: PackageId,
config: &Config
) -> CargoResult<Package> where
Self: Sized,
fn verify(&self, _pkg: PackageId) -> CargoResult<()>
[src]
If this source supports it, verifies the source of the package specified.
Note that the source may also have performed other checksum-based
verification during the download
step, but this is intended to be run
just before a crate is compiled so it may perform more expensive checks
which may not be cacheable.
fn is_replaced(&self) -> bool
[src]
Returns whether a source is being replaced by another here.
Implementations on Foreign Types
impl<'a, T: Source + ?Sized + 'a> Source for Box<T>
[src]
fn source_id(&self) -> SourceId
[src]
Forwards to Source::source_id
.
fn replaced_source_id(&self) -> SourceId
[src]
Forwards to Source::replaced_source_id
.
fn supports_checksums(&self) -> bool
[src]
Forwards to Source::supports_checksums
.
fn requires_precise(&self) -> bool
[src]
Forwards to Source::requires_precise
.
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
Forwards to Source::query
.
fn fuzzy_query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
Forwards to Source::query
.
fn update(&mut self) -> CargoResult<()>
[src]
Forwards to Source::update
.
fn download(&mut self, id: PackageId) -> CargoResult<MaybePackage>
[src]
Forwards to Source::download
.
fn finish_download(
&mut self,
id: PackageId,
data: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
id: PackageId,
data: Vec<u8>
) -> CargoResult<Package>
fn fingerprint(&self, pkg: &Package) -> CargoResult<String>
[src]
Forwards to Source::fingerprint
.
fn verify(&self, pkg: PackageId) -> CargoResult<()>
[src]
Forwards to Source::verify
.
fn describe(&self) -> String
[src]
fn is_replaced(&self) -> bool
[src]
fn add_to_yanked_whitelist(&mut self, pkgs: &[PackageId])
[src]
fn is_yanked(&mut self, pkg: PackageId) -> CargoResult<bool>
[src]
impl<'a, T: Source + ?Sized + 'a> Source for &'a mut T
[src]
fn source_id(&self) -> SourceId
[src]
fn replaced_source_id(&self) -> SourceId
[src]
fn supports_checksums(&self) -> bool
[src]
fn requires_precise(&self) -> bool
[src]
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn fuzzy_query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn update(&mut self) -> CargoResult<()>
[src]
fn download(&mut self, id: PackageId) -> CargoResult<MaybePackage>
[src]
fn finish_download(
&mut self,
id: PackageId,
data: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
id: PackageId,
data: Vec<u8>
) -> CargoResult<Package>
fn fingerprint(&self, pkg: &Package) -> CargoResult<String>
[src]
fn verify(&self, pkg: PackageId) -> CargoResult<()>
[src]
fn describe(&self) -> String
[src]
fn is_replaced(&self) -> bool
[src]
fn add_to_yanked_whitelist(&mut self, pkgs: &[PackageId])
[src]
fn is_yanked(&mut self, pkg: PackageId) -> CargoResult<bool>
[src]
Implementors
impl<'cfg> Source for DirectorySource<'cfg>
[src]
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn fuzzy_query(
&mut self,
_dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
_dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn supports_checksums(&self) -> bool
[src]
fn requires_precise(&self) -> bool
[src]
fn source_id(&self) -> SourceId
[src]
fn update(&mut self) -> CargoResult<()>
[src]
fn download(&mut self, id: PackageId) -> CargoResult<MaybePackage>
[src]
fn finish_download(
&mut self,
_id: PackageId,
_data: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
_id: PackageId,
_data: Vec<u8>
) -> CargoResult<Package>
fn fingerprint(&self, pkg: &Package) -> CargoResult<String>
[src]
fn verify(&self, id: PackageId) -> CargoResult<()>
[src]
fn describe(&self) -> String
[src]
fn add_to_yanked_whitelist(&mut self, _pkgs: &[PackageId])
[src]
fn is_yanked(&mut self, _pkg: PackageId) -> CargoResult<bool>
[src]
impl<'cfg> Source for GitSource<'cfg>
[src]
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn fuzzy_query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn supports_checksums(&self) -> bool
[src]
fn requires_precise(&self) -> bool
[src]
fn source_id(&self) -> SourceId
[src]
fn update(&mut self) -> CargoResult<()>
[src]
fn download(&mut self, id: PackageId) -> CargoResult<MaybePackage>
[src]
fn finish_download(
&mut self,
_id: PackageId,
_data: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
_id: PackageId,
_data: Vec<u8>
) -> CargoResult<Package>
fn fingerprint(&self, _pkg: &Package) -> CargoResult<String>
[src]
fn describe(&self) -> String
[src]
fn add_to_yanked_whitelist(&mut self, _pkgs: &[PackageId])
[src]
fn is_yanked(&mut self, _pkg: PackageId) -> CargoResult<bool>
[src]
impl<'cfg> Source for PathSource<'cfg>
[src]
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn fuzzy_query(
&mut self,
_dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
_dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn supports_checksums(&self) -> bool
[src]
fn requires_precise(&self) -> bool
[src]
fn source_id(&self) -> SourceId
[src]
fn update(&mut self) -> CargoResult<()>
[src]
fn download(&mut self, id: PackageId) -> CargoResult<MaybePackage>
[src]
fn finish_download(
&mut self,
_id: PackageId,
_data: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
_id: PackageId,
_data: Vec<u8>
) -> CargoResult<Package>
fn fingerprint(&self, pkg: &Package) -> CargoResult<String>
[src]
fn describe(&self) -> String
[src]
fn add_to_yanked_whitelist(&mut self, _pkgs: &[PackageId])
[src]
fn is_yanked(&mut self, _pkg: PackageId) -> CargoResult<bool>
[src]
impl<'cfg> Source for RegistrySource<'cfg>
[src]
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn fuzzy_query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn supports_checksums(&self) -> bool
[src]
fn requires_precise(&self) -> bool
[src]
fn source_id(&self) -> SourceId
[src]
fn update(&mut self) -> CargoResult<()>
[src]
fn download(&mut self, package: PackageId) -> CargoResult<MaybePackage>
[src]
fn finish_download(
&mut self,
package: PackageId,
data: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
package: PackageId,
data: Vec<u8>
) -> CargoResult<Package>
fn fingerprint(&self, pkg: &Package) -> CargoResult<String>
[src]
fn describe(&self) -> String
[src]
fn add_to_yanked_whitelist(&mut self, pkgs: &[PackageId])
[src]
fn is_yanked(&mut self, pkg: PackageId) -> CargoResult<bool>
[src]
impl<'cfg> Source for ReplacedSource<'cfg>
[src]
fn source_id(&self) -> SourceId
[src]
fn replaced_source_id(&self) -> SourceId
[src]
fn supports_checksums(&self) -> bool
[src]
fn requires_precise(&self) -> bool
[src]
fn query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn fuzzy_query(
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
[src]
&mut self,
dep: &Dependency,
f: &mut dyn FnMut(Summary)
) -> CargoResult<()>
fn update(&mut self) -> CargoResult<()>
[src]
fn download(&mut self, id: PackageId) -> CargoResult<MaybePackage>
[src]
fn finish_download(
&mut self,
id: PackageId,
data: Vec<u8>
) -> CargoResult<Package>
[src]
&mut self,
id: PackageId,
data: Vec<u8>
) -> CargoResult<Package>