Enum FileSource 

pub enum FileSource {
    Path(PathBuf),
    Url(String),
    Bytes(Bytes),
    Temp(TempFile),
}

A reference to file content that can be read. Does NOT load content eagerly — all reads are lazy/streamed.

Serialization notes:

• Temp serializes as Path (temp file’s path).
• Bytes serializes as a byte array.
• Deserialized Temp becomes Path (temp ownership is not restored).

Variants

Path(PathBuf)

Local filesystem path.

Url(String)

Remote URL (will be streamed on read, not eagerly downloaded).

Bytes(Bytes)

In-memory bytes (for small files or test fixtures).

Temp(TempFile)

Managed temporary file (auto-deleted on drop).

Implementations

impl FileSource

pub fn from_path(p: impl Into<PathBuf>) -> Self

Create a source from a local file path.

pub fn from_url(url: impl Into<String>) -> Self

Create a source from a remote URL.

pub fn from_bytes(b: impl Into<Bytes>) -> Self

Create a source from in-memory bytes.

pub async fn reader(&self) -> AppResult<Box<dyn AsyncRead + Send + Unpin>>

Open an async reader over this source.

pub async fn stream( &self, ) -> AppResult<impl Stream<Item = AppResult<Bytes>> + '_>

Open a byte stream over this source.

pub async fn read_all(&self) -> AppResult<Bytes>

Read entire content into memory (use only for small files).

pub async fn size(&self) -> AppResult<Option<u64>>

Size in bytes (may require a stat call).

pub async fn to_local_path(&self) -> AppResult<ResolvedPath>

Resolve to a local file path. Downloads to temp if source is URL/Bytes.

pub fn extension(&self) -> Option<&str>

File extension (from path or URL), if detectable.

Trait Implementations

impl Clone for FileSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileSource

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileSource

fn deserialize<D: Deserializer<'de>>(de: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Serialize for FileSource

fn serialize<S: Serializer>(&self, ser: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.