Struct LocalStoragePolicy 

pub struct LocalStoragePolicy { /* private fields */ }

An allowlist of host filesystem roots that may back file:// storage locations.

Construct via LocalStoragePolicy::new; an empty policy denies all local storage. Held on the server handler and reached by request handlers through ProvidesLocalStoragePolicy.

Implementations

impl LocalStoragePolicy

pub fn new<I, P>(roots: I) -> Result<Self>

where I: IntoIterator<Item = P>, P: AsRef<Path>,

Build a policy from configured root paths.

Each root is canonicalized (resolving symlinks and ..) so later prefix checks compare against a stable, real path. A root that does not exist or cannot be canonicalized is a configuration error — surfacing it at startup is preferable to silently denying every local location later.

pub fn deny_all() -> Self

A deny-all policy (no allowed roots). The default for a server with no local_storage configuration.

pub fn check(&self, location: &StorageLocationUrl) -> Result<()>

Authorize a storage location.

Cloud schemes pass through untouched. A file:// location is accepted only when its host path — with .. rejected and . collapsed — sits at or beneath an allowed root. With no allowed roots, every file:// location is rejected.

Trait Implementations

impl Clone for LocalStoragePolicy

fn clone(&self) -> LocalStoragePolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalStoragePolicy

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

Formats the value using the given formatter.

impl Default for LocalStoragePolicy

fn default() -> LocalStoragePolicy

Returns the “default value” for a type.