Struct StorageLocation 

pub struct StorageLocation {
    pub provider: StorageProvider,
    pub original_url: String,
    pub original_scheme: String,
    pub canonical_scheme: String,
    pub bucket_or_container: String,
    pub account: Option<String>,
    pub filesystem: Option<String>,
    pub prefix: String,
    pub endpoint_override: Option<EndpointOverride>,
    /* private fields */
}

A validated storage location with the authority components consumers need.

Fields

provider: StorageProvider

Parsed provider.

original_url: String

Original, credential-free URL.

original_scheme: String

Lowercase input scheme.

canonical_scheme: String

Provider’s canonical scheme (s3, gs, az, or file).

bucket_or_container: String

Bucket, container, or Azure filesystem.

account: Option<String>

Azure storage account from a fully qualified Hadoop-style URL.

filesystem: Option<String>

Azure filesystem/container from a fully qualified Hadoop-style URL.

prefix: String

Raw object prefix without the authority’s first /.

endpoint_override: Option<EndpointOverride>

Redacted explicit endpoint information, when attached by configuration resolution.

Implementations

impl StorageLocation

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

Parse a supported, credential-free absolute storage URL.

Paths are retained from the input rather than reserialized through url::Url, preserving repeated slashes and dot segments.

Errors

Returns a typed error for unsupported schemes, malformed authorities, embedded credentials, signed queries, or non-absolute file URLs.

pub fn with_endpoint_override( self, endpoint: &str, ) -> Result<Self, StorageLocationError>

Attach a redacted endpoint override classification.

Errors

Returns an error for credentials, queries, fragments, or non-HTTP(S) endpoints.

pub fn endpoint_class(&self) -> StorageEndpointClass

Classify the effective endpoint without exposing its hostname.

pub fn adapt( &self, consumer: StorageConsumer, ) -> Result<AdaptedStorageLocation, StorageLocationError>

Adapt this location to a downstream storage consumer.

Errors

Returns an error when the selected consumer cannot safely represent the location, such as an unqualified Azure path for Iceberg/OpenDAL.

Trait Implementations

impl Clone for StorageLocation

fn clone(&self) -> StorageLocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageLocation

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

Formats the value using the given formatter.

impl Display for StorageLocation

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

Formats the value using the given formatter.

impl Eq for StorageLocation

impl PartialEq for StorageLocation

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StorageLocation