FoundationDB Rust Client API

This is a wrapper library around the FoundationDB (Fdb) C API. It implements futures based interfaces over the Fdb future C implementations.

Prerequisites

Rust 1.39+

Install FoundationDB

Install FoundationDB on your system, see FoundationDB Local Development, or these instructions:

console $> curl -O https://www.foundationdb.org/downloads/6.1.12/ubuntu/installers/foundationdb-clients_6.1.12-1_amd64.deb $> curl -O https://www.foundationdb.org/downloads/6.1.12/ubuntu/installers/foundationdb-server_6.1.12-1_amd64.deb $> sudo dpkg -i foundationdb-clients_6.1.12-1_amd64.deb $> sudo dpkg -i foundationdb-server_6.1.12-1_amd64.deb

console $> curl -O https://www.foundationdb.org/downloads/6.1.12/macOS/installers/FoundationDB-6.1.12.pkg $> sudo installer -pkg FoundationDB-6.1.12.pkg -target /

https://www.foundationdb.org/downloads/6.1.12/windows/installers/foundationdb-6.1.12-x64.msi

Add dependencies on foundationdb-rs

toml [dependencies] foundationdb = "0.4.0" futures = "0.3"

Initialization

Due to limitations in the C API, the Client and it's associated Network can only be initialized and run once per the life of a process. Generally the foundationdb::boot function will be enough to initialize the Client. See foundationdb::default_api and foundationdb::builder for more configuration options of the Fdb Client.

Example

```rust use futures::prelude::*;

async fn async_main() -> foundationdb::FdbResult<()> { let db = foundationdb::Database::default()?;

// write a value
let trx = db.create_trx()?;
trx.set(b"hello", b"world"); // errors will be returned in the future result
trx.commit().await?;

// read a value
let trx = db.create_trx()?;
let maybe_value = trx.get(b"hello", false).await?;
let value = maybe_value.unwrap(); // unwrap the option

assert_eq!(b"world", &value.as_ref());

Ok(())

}

let network = foundationdb::boot().expect("failed to initialize Fdb"); futures::executor::blockon(asyncmain()).expect("failed to run"); // cleanly shutdown the client drop(network); ```

API stability

WARNING Until the 1.0 release of this library, the API may be in constant flux.