Actix-storage


Crates.io version docs.rs docs actions status Codecov Crates.io


Actix storage is a simple wrapper around some key-value storages to provide basic operations without knowing the backend in advance.

Install

Actix-storage is meant to be used alongside one the implementor crates, ex:

```toml

Cargo.toml

[dependencies] actix-storage = "0.1" actix-storage-hashmap = "0.1" ```

Usage

After you picked an implementor:

```rust use actixstorage::{Storage, Format}; use actixstoragehashmap::HashMapActor; use actixweb::{App, HttpServer};

[actix_web::main]

async fn main() -> std::io::Result<()> { // Intialize the implementor according to its docs let store = HashMapActor::start_default();

// Give it to the Storage struct let storage = Storage::build().expiry_store(store).finish();

// Or if it doesn't support expiring functionality // it will give errors if those methods are called let storage = Storage::build().store(store).finish();

// It is also possible to feed a seprate expiry, // as long as it works on the same storage backend let storage = Storage::build().expiry(expiry).finish();

// It is also possible to add a format to directly // set and get values using serde. let storage = Storage::build().store(expiry).format(Format::Json).finish();

// Store it with .data let server = HttpServer::new(move || { App::new() .data(storage.clone()) }); server.bind("localhost:5000")?.run().await } ```

And later in your handlers

```rust async fn index(storage: web::Data) -> Result{ storage.setbytes("key", "value").await; let val = storage.getbytes("key").await?.unwrapordefault();

// Ot if you defined a serde format let number: i32 = 5 storage.set("number", number); let x: i32 = storage.get("number");

Ok(std::str::fromutf8(&val) .maperr(|err| error::ErrorInternalServerError("Storage error"))?.to_string()) } ```

Implementations

actix-storage-hashmap docs.rs docs

actix-storage-dashmap docs.rs docs

actix-storage-sled docs.rs docs

actix-storage-redis docs.rs docs

Why?

It can be usefull when:

  1. You don't know what kind of storage you'll want.
  2. You can't afford the long time compilation of some dbs while developing
  3. You're writing a general purpose library and you want to let the user decide

Why not?

If you really care about every drop of your application performance then actix-storage may not be for you, as it uses dynamic dispatching internally.

Examples

There are bunch of examples in the examples folder, very basic ones thought, but it will give you the idea.

License

This project is licensed under either of

at your option.