Struct GitlabHost 

pub struct GitlabHost { /* private fields */ }

A validated GitLab instance host.

https-only, no userinfo, not a loopback/link-local/private/cloud-metadata address (per the live RegistryAccessPolicy), and round-tripped through URL parsing so a structurally-injected value (gitlab.com?x, gitlab.com/x) cannot smuggle extra URL components past validation.

Both the verified host and its ASCII-serialized origin are computed once at construction — the origin is needed repeatedly (the token-host comparison, the pinned-transport trusted_origin argument, and the auth_id digest), and re-deriving it per call is how normalization bugs enter.

Implementations

impl GitlabHost

pub fn parse( raw: &str, policy: &RegistryAccessPolicy, ) -> Result<Self, IndexUrlError>

Validates raw as a GitLab instance host.

format!("https://{raw}") will happily absorb a raw containing :, ?, #, @ or / — gitlab.com?x parses to a clean https://gitlab.com origin while the caller still believes the host is gitlab.com?x. This rejects any raw containing those characters before formatting, and asserts the parsed URL’s host matches raw (lowercased) afterwards, closing that gap.

Errors

Returns IndexUrlError when raw contains a URL-structural character, fails to parse, is not https-eligible, carries userinfo, round-trips to a different host, or resolves to a deps_core::net_policy::HostClass the current policy blocks.

Examples

use deps_core::net_policy::{RegistryAccessPolicy, WorkspaceRegistryAccess};
use deps_gitlab_ci::host::GitlabHost;

let policy = RegistryAccessPolicy::new(WorkspaceRegistryAccess::PublicOnly);
let host = GitlabHost::parse("gitlab.com", &policy).unwrap();
assert_eq!(host.host(), "gitlab.com");
assert_eq!(host.origin(), "https://gitlab.com");

assert!(GitlabHost::parse("gitlab.com/evil", &policy).is_err());
assert!(GitlabHost::parse("169.254.169.254", &policy).is_err());

pub fn host(&self) -> &str

The verified, lowercased host string (no scheme, no path).

pub fn origin(&self) -> &str

The normalized, ASCII-serialized origin (https://{host}), computed once at construction.

Trait Implementations

impl Clone for GitlabHost

fn clone(&self) -> GitlabHost

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GitlabHost

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

Formats the value using the given formatter.

impl Eq for GitlabHost

impl Hash for GitlabHost

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 GitlabHost

fn eq(&self, other: &GitlabHost) -> 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 GitlabHost