Struct Rule

pub struct Rule { /* private fields */ }

A Rule can be used to re-write parts of a AbsolutePackageUrl.

Implementations

impl Rule

pub fn new( host_match: impl Into<String>, host_replacement: impl Into<String>, path_prefix_match: impl Into<String>, path_prefix_replacement: impl Into<String>, ) -> Result<Self, RuleParseError>

Creates a new Rule.

pub fn host_match(&self) -> &str

The exact hostname to match.

pub fn host_replacement(&self) -> &str

The new hostname to replace the matched host_match with.

pub fn path_prefix_match(&self) -> &str

The absolute path to a package or directory to match against.

pub fn path_prefix_replacement(&self) -> &str

The absolute path to a single package or a directory to replace the matched path_prefix_match with.

pub fn apply( &self, uri: &AbsolutePackageUrl, ) -> Option<Result<AbsolutePackageUrl, ParseError>>

Apply this Rule to the given AbsolutePackageUrl.

In order for a Rule to match a particular fuchsia-pkg:// URI, host must match uri’s host exactly and path must prefix match the uri’s path at a ‘/’ boundary. If path doesn’t end in a ‘/’, it must match the entire uri path.

When a Rule does match the given uri, it will replace the matched hostname and path with the given replacement strings, preserving the unmatched part of the path, the hash query parameter, and any fragment.

Trait Implementations

impl Clone for Rule

fn clone(&self) -> Rule

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Rule

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Rule

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Rule> for Rule

fn from(rule: Rule) -> Self

Converts to this type from the input type.

impl Hash for Rule

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 Rule

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

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Rule> for Rule

type Error = RuleDecodeError

The type returned in the event of a conversion error.

fn try_from(rule: Rule) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Rule

impl StructuralPartialEq for Rule