Enum DataLocation 

pub enum DataLocation {
    Url(Url),
    Path(PathBuf),
    Blob(Blob),
}

Re‑exports reader/writer traits, converters, and auxiliary types. A flexible location of data used across I/O code.

Examples

Creating from strings:

use versatiles_container::DataLocation;
let a = DataLocation::try_from("https://example.org/x.png").unwrap();
let b = DataLocation::try_from("./data/x.png").unwrap();
assert!(matches!(a, DataLocation::Url(_)));
assert!(matches!(b, DataLocation::Path(_)));

Resolving against a base:

let base = DataLocation::try_from("/tiles/").unwrap();
let mut tgt = DataLocation::try_from("z/x/y.mvt").unwrap();
tgt.resolve(&base).unwrap();
assert_eq!(tgt.to_string().replace('\\', "/"), "/tiles/z/x/y.mvt");

Variants

Url(Url)

An absolute URL with scheme.

Path(PathBuf)

An absolute file path or a relative path/url.

Blob(Blob)

In-memory blob data.

Implementations

impl DataLocation

pub fn as_path(&self) -> Result<&Path>

Borrow the underlying filesystem path.

Returns an error if this value is a URL or Blob.

Useful when the caller expects a path-only input and wants a clear error otherwise.

pub fn to_path_buf(&self) -> Result<PathBuf>

Clone the underlying filesystem path as a PathBuf.

Returns an error if this value is a URL or Blob.

pub fn as_url(&self) -> Result<&Url>

Borrow the underlying URL.

Returns an error if this value is a Path or Blob. Useful when the caller expects a URL-only input and wants a clear error otherwise.

pub fn resolve(&mut self, base: &DataLocation) -> Result<()>

Resolve this value against base in-place.

Rules:

• If self is already a URL, it remains unchanged.
• If base is a URL and self is a relative path, self becomes a URL via base.join().
• If both are paths, they are joined and normalized (handling . and ..).

Returns an error only when URL joining fails or inputs are invalid.

pub fn resolved(&self, base: &DataLocation) -> Result<Self>

Return a new DataLocation resolved against base, leaving self unchanged.

This is the non-mutating counterpart of resolve.

pub fn filename(&self) -> Result<String>

Return the last path segment (e.g., file.tar.gz).

For URLs, the segment is derived from the URL path. For filesystem paths, it is the filename component. Errors if the source has no terminal segment.

pub fn name(&self) -> Result<String>

Return the filename without its last extension.

"/a/file.tar.gz" -> "file.tar", "/a/README" -> "README".

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

Return the filename’s last extension (without the dot).

For files, this is the last suffix after a dot (e.g. "/a/file.tar.gz" -> "gz"). For directories (both URLs ending in / and filesystem directories), this returns "directory". If no extension is present on a non-directory path, this returns an error.

pub fn cwd() -> Result<Self>

Create a DataLocation representing the current working directory.

pub fn parse_with_stdin<R: Read>(input: &str, stdin: R) -> Result<Self>

Parse a DataLocation from a string, reading from stdin if input is "-".

pub fn parse(input: &str) -> Result<Self>

Parse a DataLocation from a string.

Trait Implementations

impl Clone for DataLocation

fn clone(&self) -> DataLocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataLocation

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

Formats the value using the given formatter.

impl Display for DataLocation

Display as a plain URL string for Url, as a path using Path::display() for Path, and as <blob len=N> for in-memory Blob values.

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

Formats the value using the given formatter.

impl From<&DataLocation> for DataLocation

fn from(u: &DataLocation) -> Self

Converts to this type from the input type.

impl From<&Path> for DataLocation

fn from(p: &Path) -> Self

Converts to this type from the input type.

impl From<&PathBuf> for DataLocation

fn from(p: &PathBuf) -> Self

Converts to this type from the input type.

impl From<Blob> for DataLocation

fn from(b: Blob) -> Self

Converts to this type from the input type.

impl From<PathBuf> for DataLocation

fn from(p: PathBuf) -> Self

Converts to this type from the input type.

impl From<Url> for DataLocation

fn from(u: Url) -> Self

Converts to this type from the input type.

impl PartialEq for DataLocation

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DataLocation

impl TryFrom<&String> for DataLocation

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: &String) -> Result<Self>

Performs the conversion.

impl TryFrom<&str> for DataLocation

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Self>

Performs the conversion.

impl TryFrom<DataLocation> for DataSource

type Error = Error

The type returned in the event of a conversion error.

fn try_from(location: DataLocation) -> Result<Self>

Performs the conversion.

impl TryFrom<String> for DataLocation

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Self>

Performs the conversion.