Struct HttpBackend 

pub struct HttpBackend { /* private fields */ }

A read-only storage backend using HTTP/HTTPS.

This backend is designed for accessing publicly hosted datasets over HTTP/HTTPS. It supports range requests for efficient partial reads when the server supports them.

Limitations

• Read-only: put and delete operations will return errors
• list is not supported (HTTP doesn’t have directory listings)

Example

use alimentar::backend::{HttpBackend, StorageBackend};

let backend = HttpBackend::new("https://huggingface.co/datasets").unwrap();
let data = backend.get("squad/train.parquet").unwrap();

Implementations

impl HttpBackend

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

Creates a new HTTP backend with the given base URL.

Arguments

• base_url - Base URL for all requests. Keys will be appended to this.

Errors

Returns an error if the HTTP client cannot be created.

pub fn with_timeout( base_url: impl Into<String>, timeout_secs: u64, ) -> Result<Self>

Creates a new HTTP backend with custom client configuration.

Arguments

• base_url - Base URL for all requests
• timeout_secs - Request timeout in seconds

Errors

Returns an error if the HTTP client cannot be created.

pub fn base_url(&self) -> &str

Returns the base URL.

Trait Implementations

impl Debug for HttpBackend

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

Formats the value using the given formatter.

impl StorageBackend for HttpBackend

fn list(&self, _prefix: &str) -> Result<Vec<String>>

Lists all keys with the given prefix.

fn get(&self, key: &str) -> Result<Bytes>

Reads data from the given key.

fn put(&self, key: &str, _data: Bytes) -> Result<()>

Writes data to the given key.

fn delete(&self, key: &str) -> Result<()>

Deletes the given key.

fn exists(&self, key: &str) -> Result<bool>

Checks if the given key exists.

fn size(&self, key: &str) -> Result<u64>

Returns the size of the data at the given key in bytes.