Struct RegistryIndex 

pub struct RegistryIndex { /* private fields */ }

A validated, sparse+-prefix-stripped sparse-index URL: https scheme, no userinfo, and (for a WorkspaceDeclared candidate) a host the live deps_core::net_policy::RegistryAccessPolicy allows.

Validated at construction so an invalid or unsafe URL (http://, a scheme other than sparse+https, a user:pass@ component, or a workspace-declared host the policy blocks) can never reach a network call — this is SSRF-adjacent input, since a workspace file controls a network destination (spec NFR-002, plan-1b §1.1-§1.2).

Implementations

impl RegistryIndex

pub fn new( raw: &str, trust: IndexTrust, policy: &RegistryAccessPolicy, ) -> Result<Self, RegistryIndexError>

Validates and wraps raw — a registry-index manifest value, a .cargo/config.toml [registries.<name>].index value, or a [source.<name>] registry value, either optionally prefixed with sparse+.

trust states whose input raw is; for IndexTrust::WorkspaceDeclared, policy’s current deps_core::net_policy::WorkspaceRegistryAccess setting is consulted — a IndexTrust::Trusted candidate is never policy-checked at all, since it is the user’s own $CARGO_HOME configuration, not something a cloned repository controls.

Errors

Returns RegistryIndexError if raw does not parse as a URL, is not https, carries a userinfo component, or (for a WorkspaceDeclared candidate) resolves to a host class the current policy blocks.

Examples

use deps_cargo::config::{IndexTrust, RegistryIndex};
use deps_core::net_policy::RegistryAccessPolicy;

let policy = RegistryAccessPolicy::default();
assert!(
    RegistryIndex::new("sparse+https://index.mycorp.dev", IndexTrust::Trusted, &policy)
        .is_ok()
);
assert!(
    RegistryIndex::new("http://index.mycorp.dev", IndexTrust::Trusted, &policy).is_err()
);
assert!(
    RegistryIndex::new(
        "https://user:pass@index.mycorp.dev",
        IndexTrust::Trusted,
        &policy
    )
    .is_err()
);

pub fn as_str(&self) -> &str

The validated URL as a string, with no trailing slash guarantee either way (callers splicing a path onto this must trim as needed — see sparse::sparse_index_url).

pub const fn trust(&self) -> IndexTrust

The IndexTrust tier this index was validated under.

Trait Implementations

impl Clone for RegistryIndex

fn clone(&self) -> RegistryIndex

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RegistryIndex

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

Formats the value using the given formatter.

impl Display for RegistryIndex

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

Formats the value using the given formatter.

impl Eq for RegistryIndex

impl Hash for RegistryIndex

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RegistryIndex

fn eq(&self, other: &RegistryIndex) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RegistryIndex