rskit-storage

File I/O, local storage, temp files, MIME detection, and the shared storage backend registry.

Capabilities

• FileSource — unified reference to local path, URL, bytes, or temp file
• FileSink / FileWriter — buffered output destinations
• FileMeta, FileKind — metadata and broad category detection (Video, Audio, Image, …)
• detect_mime / detect_kind — magic-byte + extension fallback
• FileStore trait with a local filesystem backend
• StorageRegistry for explicit, config-driven backend selection
• local backend keys and write targets are confined under the configured root and reject .., absolute path escapes, and symlink traversal before creating parent directories
• TempFile / TempDir — RAII-managed temporaries (auto-deleted on drop)
• Async streaming reads and file transfers

Cloud backends live in opt-in adapter crates:

• rskit-storage-s3 for Amazon S3 and S3-compatible stores
• rskit-storage-gcs for Google Cloud Storage

Adapter crates register through an application-owned StorageRegistry; importing an adapter crate has no side effects.

Usage

[dependencies]
rskit-storage = "0.2.0-alpha.3"

use rskit_storage::{FileSource, detect_kind, FileKind, TempFile};
use rskit_errors::AppResult;

async fn example() -> AppResult<()> {
    let src = FileSource::from_path("photo.jpg");
    let kind = detect_kind(&src).await?;
    assert!(matches!(kind, FileKind::Image));

    let tmp = TempFile::new("upload", ".jpg")?;
    println!("temp path: {:?}", tmp.path());
    // tmp is deleted when dropped
    Ok(())
}

Backend registry

use rskit_storage::{
    LocalStoreConfig, StorageConfig, StorageRegistry, register_local,
};

# async fn example() -> rskit_errors::AppResult<()> {
let mut registry = StorageRegistry::new();
register_local(&mut registry)?;

let store = registry
    .build(&StorageConfig {
        backend: "local".into(),
        local: LocalStoreConfig {
            root_dir: "data".into(),
            auto_create: true,
        },
    })
    .await?;
# Ok(())
# }

See Also

Main repository README