Skip to content
WeftKitBeta
Modules/WeftKitFile
S3MinIO

WeftKitFile

File & Object Storage

Content-addressable file storage with deduplication, streaming I/O, metadata indexes, MIME detection, thumbnail generation, and S3-compatible API.

~50 μs

64-byte download latency

Content-AddressableDeduplicationStreaming I/OMIME DetectionThumbnails
Features

Key Features

What makes WeftKitFile stand out.

Content-Addressable Storage

Files identified by SHA-256 content hash. Automatic deduplication — identical files stored exactly once.

Streaming I/O

Zero-copy streaming with async I/O. Multi-part uploads with parallel chunk transfer. Range requests for partial downloads.

Metadata Indexes

Rich metadata indexing: filename, MIME type, size, timestamps, tags, custom attributes. Query files like a database.

MIME Detection

Content-based MIME type detection (not just filename). Automatic categorization of images, videos, documents, archives.

Thumbnail Generation

On-demand thumbnail generation for images and video frames. Configurable size presets. WebP output for web delivery.

S3-Compatible API

Full S3 REST API compatibility. Existing S3 clients work without modification. Presigned URLs for secure temporary access.

Performance

Performance Targets

Real numbers from Criterion benchmarks on reference hardware.

Streaming throughput> 1 GB/sec sequential I/O
Metadata query< 10 ms for 10M files
Memory footprint~16 MB base
Compatibility

Wire Protocol

WeftKitFile supports the S3 REST API protocol. Your existing tools just work.

AWS CLIboto3MinIO clientrclone
Code Example

Get Started in Seconds

Add WeftKitFile to your Rust project and start querying.

filestore.rs
rust
use weftkitfile::prelude::*;

// Open or create a database
let db = Database::open("my_app.db")?;

// Use the module API
let result = db.query("SELECT * FROM users WHERE active = true")?;

for row in result.rows() {
    println!("{:?}", row);
}
Use Cases

Where to Use It

1

Embedded media storage for mobile apps

2

Document management systems

3

Edge CDN origin storage