Struct ambient_std::asset_url::AbsAssetUrl

pub struct AbsAssetUrl(pub Url);

This is a thin wrapper around Url, which is guaranteed to always be an absolute url (including when pointing to a local file).

It’s got a custom Debug implementation which just prints the url, which makes it useful in asset keys

Tuple Fields

0: Url

Implementations

impl AbsAssetUrl

pub fn parse(url: impl AsRef<str>) -> Result<Self>

This will also resolve relative local paths

pub fn from_file_path(path: impl AsRef<Path>) -> Self

pub fn from_directory_path(path: impl AsRef<Path>) -> Self

pub fn from_asset_key(key: impl AsRef<str>) -> Result<Self, ParseError>

pub fn relative_cache_path(&self) -> String

pub fn absolute_cache_path(&self, assets: &AssetCache) -> PathBuf

pub fn extension(&self) -> Option<String>

This is always lowercase

pub fn extension_is(&self, extension: impl AsRef<str>) -> bool

This is always lowercase

pub fn add_extension(&self, extension: &str) -> Self

Appends the extension: test.png -> test.png.hello

pub fn file_stem(&self) -> Option<&str>

pub fn to_file_path(&self) -> Result<Option<PathBuf>>

pub fn resolve( &self, url_or_relative_path: impl AsRef<str> ) -> Result<Self, ParseError>

pub fn push(&self, path: impl AsRef<str>) -> Result<Self, ParseError>

This appends [path] to the current path, with a / joining them

pub fn join(&self, path: impl AsRef<str>) -> Result<Self, ParseError>

This joins the current url with a relative path. See https://docs.rs/url/latest/url/struct.Url.html#method.join for details how it works

pub fn path(&self) -> RelativePathBuf

Returns the decoded path

pub fn set_path(&mut self, path: impl AsRef<str>)

pub fn relative_path(&self, path: impl AsRef<RelativePath>) -> RelativePathBuf

pub fn is_directory(&self) -> bool

pub fn as_directory(&self) -> Self

Ensures that this url ends with /, which is interpreted as a “directory” by the Url package

pub fn as_file(&self) -> Self

Ensures that this url doesn’t end with /, which is interpreted as a “directory” by the Url package

pub fn last_dir_name(&self) -> Option<&str>

For a/b/c.png this returns b

pub fn to_download_url(&self, assets: &AssetCache) -> Result<Self, ParseError>

pub async fn download_bytes(&self, assets: &AssetCache) -> Result<Vec<u8>>

pub async fn download_string(&self, assets: &AssetCache) -> Result<String>

pub async fn download_json<T: 'static + Send + DeserializeOwned>( &self, assets: &AssetCache ) -> Result<T>

pub async fn download_toml<T: DeserializeOwned>( &self, assets: &AssetCache ) -> Result<T>

Trait Implementations

impl Clone for AbsAssetUrl

fn clone(&self) -> AbsAssetUrl

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AbsAssetUrl

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AbsAssetUrl

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for AbsAssetUrl

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

Formats the value using the given formatter.

impl From<AbsAssetUrl> for AssetUrl

fn from(value: AbsAssetUrl) -> Self

Converts to this type from the input type.

impl From<AbsAssetUrl> for String

fn from(value: AbsAssetUrl) -> Self

Converts to this type from the input type.

impl<T: GetAssetType> From<AbsAssetUrl> for TypedAssetUrl<T>

fn from(value: AbsAssetUrl) -> Self

Converts to this type from the input type.

impl From<PathBuf> for AbsAssetUrl

fn from(value: PathBuf) -> Self

Converts to this type from the input type.

impl Hash for AbsAssetUrl

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<AbsAssetUrl> for AbsAssetUrl

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AbsAssetUrl

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

Serialize this value into the given Serde serializer.

impl SyncAssetKey<AbsAssetUrl> for ContentBaseUrlKey

fn load(&self, assets: AssetCache) -> AbsAssetUrl

impl SyncAssetKey<AbsAssetUrl> for ServerBaseUrlKey

fn load(&self, _assets: AssetCache) -> AbsAssetUrl

impl Eq for AbsAssetUrl

impl StructuralEq for AbsAssetUrl

impl StructuralPartialEq for AbsAssetUrl