Struct BlobFile 

pub struct BlobFile { /* private fields */ }

A file-like object that represents a blob in a dataset

Implementations

impl BlobFile

pub fn new_inline( object_store: Arc<ObjectStore>, path: Path, position: u64, size: u64, ) -> Self

Create an inline blob reader backed by a data file.

This constructor assumes the caller has already resolved multi-base routing (base-aware object store and file path). It does not inspect dataset metadata.

Parameters

• object_store - The store that owns path; reads are issued against this store.
• path - Full path to the data file containing inline blob bytes.
• position - Byte offset of the blob payload inside the data file.
• size - Blob payload length in bytes.

pub fn new_dedicated( object_store: Arc<ObjectStore>, path: Path, size: u64, ) -> Self

Create a dedicated blob reader backed by a sidecar .blob file.

Dedicated blobs occupy an entire sidecar file, so the logical read starts at offset 0 and spans size bytes.

Parameters

• object_store - The store that owns path; reads are issued against this store.
• path - Full path to the dedicated sidecar blob file.
• size - Total byte length to expose from the sidecar file.

pub fn new_packed( object_store: Arc<ObjectStore>, path: Path, position: u64, size: u64, ) -> Self

Create a packed blob reader for a slice inside a shared sidecar .blob file.

Packed blobs share one sidecar file; this constructor exposes only the [position, position + size) range that belongs to a single row.

Parameters

• object_store - The store that owns path; reads are issued against this store.
• path - Full path to the packed sidecar blob file.
• position - Start offset of this blob within the packed sidecar.
• size - Blob payload length in bytes.

pub fn new_external( object_store: Arc<ObjectStore>, path: Path, uri: String, position: u64, size: u64, ) -> Self

Create an external blob reader backed by a caller-resolved object location.

External blobs are identified by a URI in metadata, but actual reads happen against a concrete store/path pair resolved by the caller. This keeps URI resolution (which may be async) outside of the constructor.

Parameters

• object_store - The resolved store used to open and read path.
• path - The resolved object path that contains external blob bytes.
• uri - The original URI recorded in blob metadata for round-tripping.
• position - Start offset of the blob payload in the external object.
• size - Number of bytes exposed from position.

pub async fn close(&self) -> Result<()>

Close the blob file, releasing any associated resources

pub async fn is_closed(&self) -> bool

Returns true if the blob file is closed

pub async fn read_range(&self, range: Range<u64>) -> Result<Bytes>

Read a byte range relative to the beginning of this blob without changing the cursor.

The provided range is interpreted in blob-local coordinates, not object coordinates. Empty ranges are allowed. This method is intended for random access callers that want deterministic range semantics instead of the stateful file-like cursor used by Self::read and Self::read_up_to.

pub async fn read_ranges(&self, ranges: &[Range<u64>]) -> Result<Vec<Bytes>>

Read multiple ranges relative to the beginning of this blob without changing the cursor.

Empty ranges are allowed and yield empty buffers. The result order always matches the input order, even though the underlying physical requests may be reordered, coalesced, or split for efficiency.

pub async fn read(&self) -> Result<Bytes>

Read the entire blob file from the current cursor position to the end of the file

After this call the cursor will be pointing to the end of the file.

pub async fn read_up_to(&self, len: usize) -> Result<Bytes>

Read up to len bytes from the current cursor position

After this call the cursor will be pointing to the end of the read data.

pub async fn seek(&self, new_cursor: u64) -> Result<()>

Seek to a new cursor position in the file

pub async fn tell(&self) -> Result<u64>

Return the current cursor position in the file

pub fn size(&self) -> u64

Return the size of the blob file in bytes

pub fn position(&self) -> u64

pub fn data_path(&self) -> &Path

pub fn kind(&self) -> BlobKind

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

Trait Implementations

impl Debug for BlobFile

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

Formats the value using the given formatter.