Skip to main content

GlobPattern

Struct GlobPattern 

Source
pub struct GlobPattern { /* private fields */ }
Expand description

One GOPRIVATE/GONOPROXY-style glob pattern (FR-007).

Matched against a module path per Go’s own GlobsMatchPath + path.Match semantics (go help goprivate): only the pattern’s own number of /-separated elements is compared against the module path’s leading elements, then matched with shell-glob syntax (*, ?, [...]/[^...]) that never crosses a /.

Compiles its pattern once at construction into a token sequence, matched by the iterative tokens_match rather than naive recursive backtracking — a naive backtracking implementation is exponential (O(2^n)) on an adversarial pattern like many consecutive *s against a non-matching text (spec 034 perf review finding: 15 stars took ~19s, 20 timed out); the token/iterative-pointer approach used here is O(pattern length * matched text length), the same bound the classic “wildcard matching” two-pointer algorithm gives.

Implementations§

Source§

impl GlobPattern

Source

pub fn new(raw: &str) -> Self

Wraps and compiles raw — no validation surfaced to the caller, matching path.Match’s own behavior (a malformed or oversized pattern simply never matches, per Self::tokens’s doc). Rejection paths log a tracing::warn!: an oversized pattern (spec 034 follow-up F6, issue #559) here, and a malformed pattern (unterminated [ character class, issue #568) inside compile_glob — both invalidate the whole pattern. A reversed [lo-hi] range (issue #570) also logs a tracing::warn! inside compile_glob, but — matching Go’s own path.Match — does not invalidate the pattern; see Self::tokens’s doc. Unlike a malformed GOPROXY hop, a GOPRIVATE pattern that never matches fails open on confidentiality (the module it should have hidden from the public proxy routes there instead), so these cases must be visible rather than silent.

Source

pub fn matches(&self, module_path: &str) -> bool

Whether module_path matches this pattern (FR-008).

§Examples
use deps_go::config::GlobPattern;

let pattern = GlobPattern::new("git.mycorp.example/*");
assert!(pattern.matches("git.mycorp.example/internal/auth"));
assert!(!pattern.matches("github.com/other/repo"));

Trait Implementations§

Source§

impl Clone for GlobPattern

Source§

fn clone(&self) -> GlobPattern

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for GlobPattern

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for GlobPattern

Source§

impl PartialEq for GlobPattern

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

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

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

impl StructuralPartialEq for GlobPattern

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more