Struct FileScope 

pub struct FileScope { /* private fields */ }

Configurable allow-list for file:// opens.

Implementations

impl FileScope

pub fn new() -> Self

Empty scope — every open is rejected. Use allow_dir to widen.

pub fn permissive() -> Self

A scope that permits everything the process can read. Equivalent to the default open_file behaviour. Useful where the registry plumbing expects a FileScope but the caller has no security policy to enforce.

pub fn allow_dir<P: AsRef<Path>>(self, dir: P) -> Self

Permit any path whose canonical form lives under dir. The directory itself is canonicalised at insertion time, so downstream resolution does not chase symlinks repeatedly.

pub fn resolve(&self, uri_str: &str) -> Result<PathBuf>

Resolve a URI against the scope, returning the canonical absolute path on success.

pub fn open(&self, uri_str: &str) -> Result<Box<dyn BytesSource>>

Open uri_str under this scope.

pub fn register_into(self, registry: &mut SourceRegistry)

Install this scope as the file:// driver of registry, replacing any prior file registration. The scope is stored in a process-global slot keyed by registry registration order; subsequent register_into calls overwrite that slot.

Trait Implementations

impl Clone for FileScope

fn clone(&self) -> FileScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileScope

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

Formats the value using the given formatter.

impl Default for FileScope

fn default() -> FileScope

Returns the “default value” for a type.