pub struct SourceId { /* private fields */ }
Expand description
Unique identifier for a source of packages.
Implementations
Parses a source URL and returns the corresponding ID.
Example
use cargo::core::SourceId;
SourceId::from_url("git+https://github.com/alexcrichton/\
libssh2-static-sys#80e71a3021618eb05\
656c58fb7c5ef5f12bc747f");
A view of the SourceId
that can be Display
ed as a URL.
Creates a SourceId
from a filesystem path.
path
: an absolute path.
Creates a SourceId
from a Git reference.
Creates a SourceId from a remote registry URL when the registry name
cannot be determined, e.g. a user passes --index
directly from CLI.
Use SourceId::for_alt_registry
if a name can provided, which
generates better messages for cargo.
Creates a SourceId
from a remote registry URL with given name.
Creates a SourceId from a local registry path.
Creates a SourceId
from a directory path.
Returns the SourceId
corresponding to the main repository.
This is the main cargo registry by default, but it can be overridden in
a .cargo/config.toml
.
Gets the SourceId
associated with given name of the remote regsitry.
Gets the canonical URL of this source, used for internal comparison purposes.
Returns the local path if this is a path dependency.
Returns true
if this source is from a registry (either local or not).
Returns true
if this source is a “remote” registry.
“remote” may also mean a file URL to a git index, so it is not
necessarily “remote”. This just means it is not local-registry
.
Creates an implementation of Source
corresponding to this ID.
Gets the Git reference if this is a git source, otherwise None
.
Creates a new SourceId
from this source with the given precise
.
Returns true
if the remote registry is the standard https://crates.io.
Hashes self
.
For paths, remove the workspace prefix so the same source will give the same hash in different locations.
Trait Implementations
Deserialize this value from the given Serde deserializer. Read more
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
Auto Trait Implementations
impl RefUnwindSafe for SourceId
impl UnwindSafe for SourceId
Blanket Implementations
Mutably borrows from an owned value. Read more