Enum FileLocation 

pub enum FileLocation {
    RelativeUrl(SmallString, SmallString),
    AbsoluteUrl(UrlString),
}

While a registry file is generally a remote URL, it can also be a file if it comes from a directory flat indexes.

Variants

RelativeUrl(SmallString, SmallString)

URL relative to the base URL.

AbsoluteUrl(UrlString)

Absolute URL.

Implementations

impl FileLocation

pub fn new(url: SmallString, base: &SmallString) -> Self

Parse a relative or absolute URL on a page with a base URL.

This follows the HTML semantics where a link on a page is resolved relative to the URL of that page.

pub fn raw_filename(&self) -> &str

Returns the final raw URL path component after removing any query or fragment.

The filename is not percent-decoded.

pub fn to_url(&self) -> Result<DisplaySafeUrl, ToUrlError>

Convert this location to a URL.

A relative URL has its base joined to the path. An absolute URL is parsed as-is. And a path location is turned into a URL via the file protocol.

Errors

This returns an error if any of the URL parsing fails, or if, for example, the location is a path and the path isn’t valid UTF-8. (Because URLs must be valid UTF-8.)

Trait Implementations

impl Archive for FileLocation

where SmallString: Archive, UrlString: Archive,

type Archived = ArchivedFileLocation

The archived representation of this type.

type Resolver = FileLocationResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve( &self, resolver: <Self as Archive>::Resolver, out: Place<<Self as Archive>::Archived>, )

Creates the archived version of this value at the given position and writes it to the given output.

const COPY_OPTIMIZATION: CopyOptimization<Self> = _

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize.

impl Clone for FileLocation

fn clone(&self) -> FileLocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileLocation

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

Formats the value using the given formatter.

impl<__D: Fallible + ?Sized> Deserialize<FileLocation, __D> for Archived<FileLocation>

where SmallString: Archive, <SmallString as Archive>::Archived: Deserialize<SmallString, __D>, UrlString: Archive, <UrlString as Archive>::Archived: Deserialize<UrlString, __D>,

fn deserialize( &self, deserializer: &mut __D, ) -> Result<FileLocation, <__D as Fallible>::Error>

Deserializes using the given deserializer

impl Display for FileLocation

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

Formats the value using the given formatter.

impl Eq for FileLocation

impl Hash for FileLocation

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 Identifier for FileLocation

fn distribution_id(&self) -> DistributionId

Return a unique resource identifier for the distribution, like a SHA-256 hash of the distribution’s contents.

fn resource_id(&self) -> ResourceId

Return a unique resource identifier for the underlying resource backing the distribution.

impl PartialEq for FileLocation

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

Equality operator ==.

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

Inequality operator !=.

impl<__S: Fallible + ?Sized> Serialize<__S> for FileLocation

where SmallString: Serialize<__S>, UrlString: Serialize<__S>,

fn serialize( &self, serializer: &mut __S, ) -> Result<<Self as Archive>::Resolver, <__S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.

impl StructuralPartialEq for FileLocation