Struct FileUrl 

pub struct FileUrl(/* private fields */);

A cross-platform handle to a file the user chose in a native open/save picker.

Internally a single locator string. On desktop and iOS it is an absolute filesystem path; on Android it may be a content:// URI, since the Storage Access Framework does not expose real filesystem paths. That is why Day uses a bespoke type rather than std::path::PathBuf (which cannot represent a content:// URI) or a bare String (no type-safety / helpers): a FileUrl is the lossless union with ergonomic accessors.

Files returned from open_file are always readable via FileUrl::read_to_string / FileUrl::read: backends copy a picked file into app storage first where the platform requires it, so the local path works everywhere.

Implementations

impl FileUrl

pub fn new(locator: impl Into<String>) -> Self

Wrap a locator string (a filesystem path or a URI). Usually produced by the pickers.

pub fn as_str(&self) -> &str

The raw locator: a filesystem path, or a content://-style URI on Android.

pub fn local_path(&self) -> Option<PathBuf>

The locator as a filesystem path: Some for local paths (and file:// URLs), None for opaque URIs such as Android’s content://.

pub fn bookmark(&self, read_only: bool) -> Result<Vec<u8>>

Persistable macOS security-scoped bookmark for a file the user has authorized. Store the opaque bytes in app-private storage, not the path. Other platforms return Unsupported. read_only prevents a bookmark from requesting write access.

pub fn resolve_bookmark(bytes: &[u8]) -> Result<FileAccess>

Resolve a saved macOS bookmark and hold its security scope until the returned guard is dropped. Keep the guard alive across all I/O, including asynchronous operations.

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

The last path component, for display (e.g. notes.txt). Best-effort for opaque URIs.

pub fn read(&self) -> Result<Vec<u8>>

Read the file’s bytes. Local paths only; opaque URIs return an Unsupported error.

pub async fn read_limited(&self, limit: usize) -> Result<Vec<u8>>

Read at most limit bytes without blocking the UI. Native reads run on a worker; browser-picked bytes are already in memory. Oversized input returns InvalidData. Apple security-scoped access is held for the read and released on every exit path.

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

Read the file as UTF-8 text.

Trait Implementations

impl Clone for FileUrl

fn clone(&self) -> FileUrl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileUrl

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

Formats the value using the given formatter.

impl Display for FileUrl

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

Formats the value using the given formatter.

impl Eq for FileUrl

impl Hash for FileUrl

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

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FileUrl