Struct cargo::sources::path::PathSource

pub struct PathSource<'cfg> { /* fields omitted */ }

Methods

impl<'cfg> PathSource<'cfg>

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

Invoked with an absolute path to a directory that contains a Cargo.toml.

This source will only return the package at precisely the path specified, and it will be an error if there's not a package at path.

fn new_recursive(
    root: &Path,
    id: &SourceId,
    config: &'cfg Config
) -> PathSource<'cfg>

Creates a new source which is walked recursively to discover packages.

This is similar to the new method except that instead of requiring a valid package to be present at root the folder is walked entirely to crawl for packages.

Note that this should be used with care and likely shouldn't be chosen by default!

fn root_package(&mut self) -> CargoResult<Package>

fn read_packages(&self) -> CargoResult<Vec<Package>>

fn list_files(&self, pkg: &Package) -> CargoResult<Vec<PathBuf>>

List all files relevant to building this package inside this source.

This function will use the appropriate methods to determine the set of files underneath this source's directory which are relevant for building pkg.

The basic assumption of this method is that all files in the directory are relevant for building this package, but it also contains logic to use other methods like .gitignore to filter the list of files.

Trait Implementations

impl<'cfg> Debug for PathSource<'cfg>

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

Formats the value using the given formatter.

impl<'cfg> Registry for PathSource<'cfg>

fn query(&mut self, dep: &Dependency) -> CargoResult<Vec<Summary>>

Attempt to find the packages that match a dependency request.

fn supports_checksums(&self) -> bool

Returns whether or not this registry will return summaries with checksums listed.

impl<'cfg> Source for PathSource<'cfg>

fn source_id(&self) -> &SourceId

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

The update method 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, id: &PackageId) -> CargoResult<Package>

The download method fetches the full package for each name and version specified.

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

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

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

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