pub struct DirectorySource<'cfg> {
    source_id: SourceId,
    root: PathBuf,
    packages: HashMap<PackageId, (Package, Checksum)>,
    config: &'cfg Config,
    updated: bool,
}
Expand description

DirectorySource contains a number of crates on the file system. It was designed for representing vendored dependencies for cargo vendor.

DirectorySource at this moment is just a root directory containing other directories, which contain the source files of packages. Assumptions would be made to determine if a directory should be included as a package of a directory source’s:

  • Ignore directories starting with dot . (tend to be hidden).
  • Only when a Cargo.toml exists in a directory will it be included as a package. DirectorySource at this time only looks at one level of directories and never went deeper.
  • There must be a Checksum file .cargo-checksum.json file at the same level of Cargo.toml to ensure the integrity when a directory source was created (usually by cargo vendor). A failure to find or parse a single checksum results in a denial of loading any package in this source.
  • Otherwise, there is no other restrction of the name of directories. At this moment, it is cargo vendor that defines the layout and the name of each directory.

The file tree of a directory source may look like:

[source root]
├── a-valid-crate/
│  ├── src/
│  ├── .cargo-checksum.json
│  └── Cargo.toml
├── .ignored-a-dot-crate/
│  ├── src/
│  ├── .cargo-checksum.json
│  └── Cargo.toml
├── skipped-no-manifest/
│  ├── src/
│  └── .cargo-checksum.json
└── no-checksum-so-fails-the-entire-source-reading/
   └── Cargo.toml

Fields§

§source_id: SourceId

The unique identifier of this source.

§root: PathBuf

The root path of this source.

§packages: HashMap<PackageId, (Package, Checksum)>

Packages that this sources has discovered.

§config: &'cfg Config§updated: bool

Implementations§

source§

impl<'cfg> DirectorySource<'cfg>

source

pub fn new( path: &Path, id: SourceId, config: &'cfg Config ) -> DirectorySource<'cfg>

Trait Implementations§

source§

impl<'cfg> Debug for DirectorySource<'cfg>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'cfg> Source for DirectorySource<'cfg>

source§

fn query( &mut self, dep: &Dependency, kind: QueryKind, f: &mut dyn FnMut(Summary) ) -> Poll<CargoResult<()>>

Attempts to find the packages that match a dependency request. Read more
source§

fn supports_checksums(&self) -> bool

Returns whether or not this source will return Summary items with checksums listed.
source§

fn requires_precise(&self) -> bool

Returns whether or not this source will return Summary items with the precise field in the SourceId listed.
source§

fn source_id(&self) -> SourceId

Returns the SourceId corresponding to this source.
source§

fn block_until_ready(&mut self) -> CargoResult<()>

Block until all outstanding Poll::Pending requests are Poll::Ready. Read more
source§

fn download(&mut self, id: PackageId) -> CargoResult<MaybePackage>

Starts the process to fetch a Package for the given PackageId. Read more
source§

fn finish_download( &mut self, _id: PackageId, _data: Vec<u8> ) -> CargoResult<Package>

Gives the source the downloaded .crate file. Read more
source§

fn fingerprint(&self, pkg: &Package) -> CargoResult<String>

Generates a unique string which represents the fingerprint of the current state of the source. Read more
source§

fn verify(&self, id: PackageId) -> CargoResult<()>

If this source supports it, verifies the source of the package specified. Read more
source§

fn describe(&self) -> String

Describes this source in a human readable fashion, used for display in resolver error messages currently.
source§

fn add_to_yanked_whitelist(&mut self, _pkgs: &[PackageId])

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.
source§

fn is_yanked(&mut self, _pkg: PackageId) -> Poll<CargoResult<bool>>

Query if a package is yanked. Only registry sources can mark packages as yanked. This ignores the yanked whitelist.
source§

fn invalidate_cache(&mut self)

Ensure that the source is fully up-to-date for the current session on the next query.
source§

fn set_quiet(&mut self, _quiet: bool)

If quiet, the source should not display any progress or status messages.
source§

fn replaced_source_id(&self) -> SourceId

Returns the replaced SourceId corresponding to this source.
source§

fn query_vec( &mut self, dep: &Dependency, kind: QueryKind ) -> Poll<CargoResult<Vec<Summary>>>

Gathers the result from Source::query as a list of Summary items when they become available.
source§

fn download_now( self: Box<Self>, package: PackageId, config: &Config ) -> CargoResult<Package>where Self: Sized,

Convenience method used to immediately fetch a Package for the given PackageId. Read more
source§

fn is_replaced(&self) -> bool

Returns whether a source is being replaced by another here.

Auto Trait Implementations§

§

impl<'cfg> !RefUnwindSafe for DirectorySource<'cfg>

§

impl<'cfg> !Send for DirectorySource<'cfg>

§

impl<'cfg> !Sync for DirectorySource<'cfg>

§

impl<'cfg> Unpin for DirectorySource<'cfg>

§

impl<'cfg> !UnwindSafe for DirectorySource<'cfg>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 96 bytes