Crate remi_gridfs

Source
Expand description

Official and maintained remi-rs crate for support of MongoDB GridFS

v0.10.0 | 📜 Documentation
Crate FeaturesDescriptionEnabled by default?
export-cratesExports all the used MongoDB crates as a module called mongodbYes.
unstableTap into unstable features from remi_gridfs and the remi crate.No.
tracingEnables the use of tracing::instrument and emit events for actions by the crate.No.
serdeEnables the use of serde in StorageConfigNo.
logEmits log records for actions by the crateNo.

§Example

// Cargo.toml:
//
// [dependencies]
// remi = "^0"
// remi-gridfs = { version = "^0", features = ["export-crates"] }
// tokio = { version = "^1", features = ["full"] }

use remi_gridfs::{StorageService, StorageConfig, mongodb};
use remi::{StorageService as _, UploadRequest};

#[tokio::main]
async fn main() {
    let storage = StorageService::from_conn_string("mongodb://localhost:27017", StorageConfig {
        bucket: "my-bucket".into(),

        ..Default::default()
    }).await.unwrap();

    // Initialize the container. This will:
    //
    // * create the `my-bucket` GridFS bucket if it doesn't exist
    storage.init().await.unwrap();

    // Now we can upload files to GridFS.

    // We define a `UploadRequest`, which will set the content type to `text/plain` and set the
    // contents of `weow.txt` to `weow fluff`.
    let upload = UploadRequest::default()
        .with_content_type(Some("text/plain"))
        .with_data("weow fluff");

    // Let's upload it!
    storage.upload("weow.txt", upload).await.unwrap();

    // Let's check if it exists! This `assert!` will panic if it failed
    // to upload.
    assert!(storage.exists("weow.txt").await.unwrap());
}

Re-exports§

Structs§