Enum AddSource 

pub enum AddSource {
    File(PathBuf),
    Bytes(Bytes),
    Stream(StreamSource),
}

Source of content for a CommitOperation::Add operation.

Use File for content already on disk, especially large files: the path is stored, but file contents are read when the commit runs and are streamed where possible. Use Bytes for small in-memory content; the buffer is owned by the operation and may be cloned for LFS/xet uploads.

AddSource::File is not a snapshot: the file must still exist, unchanged, when HFRepository::create_commit runs.

Variants

File(PathBuf)

Available on non-target_family=wasm only.

Read file contents from this local path at commit time.

Bytes(Bytes)

In-memory contents used as the file body. Stored as bytes::Bytes so the internal .clone() calls along the upload path are cheap refcount bumps rather than full memory copies.

Stream(StreamSource)

Lazily-read byte stream of known total length. Lets the upload pipeline process a source whose total size exceeds available memory: only one chunk is held in flight at any time. See StreamSource for the factory contract (must be re-readable to satisfy the sample, hash, and upload passes).

Implementations

impl AddSource

pub fn file(path: impl Into<PathBuf>) -> Self

Available on non-target_family=wasm only.

Construct an AddSource::File from a local file path.

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

Construct an AddSource::Bytes from in-memory contents.

bytes accepts any type that converts to bytes::Bytes: Vec<u8> is taken by value with no copy (via Bytes::from), &'static [u8] / &'static str are wrapped without copying, and an existing Bytes passes through unchanged.

pub fn stream(source: StreamSource) -> Self

Construct an AddSource::Stream from a StreamSource.

The total length must be known up-front and the factory must produce identical bytes on every open() — see StreamSource::new.

Trait Implementations

impl Clone for AddSource

fn clone(&self) -> AddSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AddSource

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

Formats the value using the given formatter.