Enum Href 

pub enum Href {
    Url(Url),
    String(String),
}

An href.

Variants

Url(Url)

A url href.

This can have a file: scheme.

String(String)

A string href.

This is expected to have / delimiters. Windows-style \ delimiters are not supported.

Implementations

impl Href

pub fn absolute(&self, base: &Href) -> Result<Href>

Convert this href into an absolute href using the given base.

Examples

use stac::Href;

let href = Href::from("./a/b.json").absolute(&"/c/d/e.json".into()).unwrap();
assert_eq!(href, "/c/d/a/b.json");

pub fn relative(&self, base: &Href) -> Result<Href>

Convert this href into an relative href using to the given base.

Examples

use stac::Href;

let href = Href::from("/a/b/c.json").relative(&"/a/d.json".into()).unwrap();
assert_eq!(href, "./b/c.json");

pub fn is_absolute(&self) -> bool

Returns true if this href is absolute.

Urls are always absolute. Strings are absolute if they start with a /.

pub fn as_str(&self) -> &str

Returns this href as a str.

pub fn realize(self) -> RealizedHref

If the url scheme is file, convert it to a path string.

Trait Implementations

impl Clone for Href

fn clone(&self) -> Href

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Href

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Href

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Href

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

Formats the value using the given formatter.

impl From<&Path> for Href

fn from(value: &Path) -> Self

Converts to this type from the input type.

impl From<&str> for Href

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<PathBuf> for Href

fn from(value: PathBuf) -> Self

Converts to this type from the input type.

impl From<String> for Href

fn from(value: String) -> Self

Converts to this type from the input type.

impl From<Url> for Href

fn from(value: Url) -> Self

Converts to this type from the input type.

impl PartialEq<&str> for Href

fn eq(&self, other: &&str) -> 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 PartialEq for Href

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Href> for Url

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Href) -> Result<Self>

Performs the conversion.

impl StructuralPartialEq for Href