Enum PolicyGate 

pub enum PolicyGate<'a> {
    Skip,
    Enforce(&'a RegistryAccessPolicy),
}

Whether validate_index_url must check a candidate’s host against a live RegistryAccessPolicy.

An explicit enum, not Option/bool: a trusted-provenance candidate (e.g. deps-cargo’s $CARGO_HOME-sourced IndexTrust::Trusted) skipping the policy check entirely is a security-relevant decision each call site must make visibly, not something that can be expressed by a None a reader might mistake for “no policy configured yet”.

Examples

use deps_core::net_policy::{PolicyGate, RegistryAccessPolicy, WorkspaceRegistryAccess, validate_index_url};

let policy = RegistryAccessPolicy::new(WorkspaceRegistryAccess::Off);
assert!(
    validate_index_url("https://index.mycorp.dev", "https://index.mycorp.dev", "cargo", PolicyGate::Skip)
        .is_ok()
);
assert!(
    validate_index_url(
        "https://index.mycorp.dev",
        "https://index.mycorp.dev",
        "cargo",
        PolicyGate::Enforce(&policy)
    )
    .is_err()
);

Variants

Skip

Skip the policy check entirely — the candidate’s provenance is already trusted (e.g. the user’s own $CARGO_HOME configuration), not something a cloned repository controls.

Enforce(&'a RegistryAccessPolicy)

Check the candidate’s host against policy — the candidate’s provenance is a workspace file, which an opened repository fully controls.

Trait Implementations

impl<'a> Clone for PolicyGate<'a>

fn clone(&self) -> PolicyGate<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for PolicyGate<'a>

impl<'a> Debug for PolicyGate<'a>

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

Formats the value using the given formatter.