Enum guppy::graph::ExternalSource
source · [−]#[non_exhaustive]
pub enum ExternalSource<'g> {
Registry(&'g str),
Git {
repository: &'g str,
req: GitReq<'g>,
resolved: &'g str,
},
}
Expand description
More information about an external source.
This provides information about whether an external dependency is a Git dependency or fetched from a registry.
Returned by PackageSource::parse_external
.
Variants (Non-exhaustive)
This enum is marked as non-exhaustive
Registry(&'g str)
This is a registry source, e.g. "registry+https://github.com/rust-lang/crates.io-index"
.
The associated data is the part of the string after the initial "registry+"
.
Examples
use guppy::graph::ExternalSource;
let source = "registry+https://github.com/rust-lang/crates.io-index";
let parsed = ExternalSource::new(source).expect("this source is understood by guppy");
assert_eq!(
parsed,
ExternalSource::Registry("https://github.com/rust-lang/crates.io-index"),
);
Git
Fields
repository: &'g str
The repository for this Git source. For the above example, this would be
"https://github.com/rust-lang/cargo.git"
.
req: GitReq<'g>
The revision requested in Cargo.toml
. This may be a tag, a branch or a specific
revision (commit hash).
For the above example, req
would be GitSource::Branch("main")
.
resolved: &'g str
The resolved revision, as specified in Cargo.lock
.
For the above example, resolved_hash
would be "0227f048fcb7c798026ede6cc20c92befc84c3a4"
.
This is always a commit hash, and if req
is GitReq::Rev
then it is expected
to be the same hash. (However, this is not verified by guppy.)
This is a Git source.
An example of a Git source string is "git+https://github.com/rust-lang/cargo.git?branch=main#0227f048fcb7c798026ede6cc20c92befc84c3a4"
.
In this case, the Cargo.toml
would have contained:
cargo = { git = "https://github.com/rust-lang/cargo.git", branch = "main" }
and the Cargo.lock
would have contained:
[[package]]
name = "cargo"
version = "0.46.0"
source = "git+https://github.com/rust-lang/cargo.git?branch=main#0227f048fcb7c798026ede6cc20c92befc84c3a4
dependencies = [ ... ]
For more, see Specifying dependencies from git
repositories
in the Cargo book.
Examples
use guppy::graph::{ExternalSource, GitReq};
// A branch source.
let source = "git+https://github.com/rust-lang/cargo.git?branch=main#0227f048fcb7c798026ede6cc20c92befc84c3a4";
let parsed = ExternalSource::new(source).expect("this source is understood by guppy");
assert_eq!(
parsed,
ExternalSource::Git {
repository: "https://github.com/rust-lang/cargo.git",
req: GitReq::Branch("main"),
resolved: "0227f048fcb7c798026ede6cc20c92befc84c3a4",
}
);
// A tag source.
let source = "git+https://github.com/rust-lang/cargo.git?tag=v0.46.0#0227f048fcb7c798026ede6cc20c92befc84c3a4";
let parsed = ExternalSource::new(source).expect("this source is understood by guppy");
assert_eq!(
parsed,
ExternalSource::Git {
repository: "https://github.com/rust-lang/cargo.git",
req: GitReq::Tag("v0.46.0"),
resolved: "0227f048fcb7c798026ede6cc20c92befc84c3a4",
}
);
// A revision source.
let source = "git+https://github.com/rust-lang/cargo.git?rev=0227f048fcb7c798026ede6cc20c92befc84c3a4#0227f048fcb7c798026ede6cc20c92befc84c3a4";
let parsed = ExternalSource::new(source).expect("this source is understood by guppy");
assert_eq!(
parsed,
ExternalSource::Git {
repository: "https://github.com/rust-lang/cargo.git",
req: GitReq::Rev("0227f048fcb7c798026ede6cc20c92befc84c3a4"),
resolved: "0227f048fcb7c798026ede6cc20c92befc84c3a4",
}
);
// A default source.
let source = "git+https://github.com/gyscos/zstd-rs.git#bc874a57298bdb500cdb5aeac5f23878b6480d0b";
let parsed = ExternalSource::new(source).expect("this source is understood by guppy");
assert_eq!(
parsed,
ExternalSource::Git {
repository: "https://github.com/gyscos/zstd-rs.git",
req: GitReq::Default,
resolved: "bc874a57298bdb500cdb5aeac5f23878b6480d0b",
}
);
Implementations
sourceimpl<'g> ExternalSource<'g>
impl<'g> ExternalSource<'g>
sourcepub const REGISTRY_PLUS: &'static str
pub const REGISTRY_PLUS: &'static str
The string "registry+"
.
Used for matching with the Registry
variant.
sourcepub const BRANCH_EQ: &'static str
pub const BRANCH_EQ: &'static str
The string "?branch="
.
Used for matching with the Git
variant.
sourcepub const CRATES_IO_URL: &'static str
pub const CRATES_IO_URL: &'static str
The URL for the crates.io
registry.
This lacks the leading "registry+
“ that’s part of the PackageSource
.
Trait Implementations
sourceimpl<'g> Clone for ExternalSource<'g>
impl<'g> Clone for ExternalSource<'g>
sourcefn clone(&self) -> ExternalSource<'g>
fn clone(&self) -> ExternalSource<'g>
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl<'g> Debug for ExternalSource<'g>
impl<'g> Debug for ExternalSource<'g>
sourceimpl<'g> Display for ExternalSource<'g>
impl<'g> Display for ExternalSource<'g>
The Display
implementation for ExternalSource
returns the string it was constructed from.
Examples
use guppy::graph::{ExternalSource, GitReq};
let source = ExternalSource::Git {
repository: "https://github.com/rust-lang/cargo.git",
req: GitReq::Branch("main"),
resolved: "0227f048fcb7c798026ede6cc20c92befc84c3a4",
};
assert_eq!(
format!("{}", source),
"git+https://github.com/rust-lang/cargo.git?branch=main#0227f048fcb7c798026ede6cc20c92befc84c3a4",
);
sourceimpl<'g> Hash for ExternalSource<'g>
impl<'g> Hash for ExternalSource<'g>
sourceimpl<'g> PartialEq<ExternalSource<'g>> for ExternalSource<'g>
impl<'g> PartialEq<ExternalSource<'g>> for ExternalSource<'g>
sourcefn eq(&self, other: &ExternalSource<'g>) -> bool
fn eq(&self, other: &ExternalSource<'g>) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &ExternalSource<'g>) -> bool
fn ne(&self, other: &ExternalSource<'g>) -> bool
This method tests for !=
.
impl<'g> Copy for ExternalSource<'g>
impl<'g> Eq for ExternalSource<'g>
impl<'g> StructuralEq for ExternalSource<'g>
impl<'g> StructuralPartialEq for ExternalSource<'g>
Auto Trait Implementations
impl<'g> RefUnwindSafe for ExternalSource<'g>
impl<'g> Send for ExternalSource<'g>
impl<'g> Sync for ExternalSource<'g>
impl<'g> Unpin for ExternalSource<'g>
impl<'g> UnwindSafe for ExternalSource<'g>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<Q, K> Equivalent<K> for Q where
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Q where
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
Compare self to key
and return true
if they are equal.
impl<T> Pointable for T
impl<T> Pointable for T
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more