chesterfield

An ergonomic, strongly typed CouchDB client in Rust.

This library includes both synchronous and asynchronous APIs for the programmer who wants to have it all.

Couldn't find a decent, maintained CouchDB client in Rust. Also I wanted async. So i rolled my own.

This is still in active development, in the sense that I add things when I need them, and fix bugs when they affect me directly. Would be thrilled to have a couple more sets of eyes and keyboards chipping away at this. climb aboard.

Synchronous

```rust use chesterfield::{Error, sync::Client, GetResponse}; use serde::Deserialize;

// use your own concrete types

[derive(Deserialize)]

struct MyConcreteStruct {}

let client = Client::new("https://localhost:5984").unwrap(); let database = client.database("items").unwrap(); let docid = "someunique_id";

match database .get(docid) .send() .map(GetResponse::::intoinner) { Ok(my_struct) => (), // do something with struct Err(e) => println!("{}", e), }

```

Asynchronous ("ooh fancy")

```rust use chesterfield::{Error, r#async::Client, GetResponse}; use serde::Deserialize; use tokio::prelude::Future;

[derive(Deserialize)]

struct MyConcreteStruct {}

let client = Client::new("https://localhost:5984").unwrap(); let database = client.database("items").unwrap(); let docid = "someuniqueid".tostring();

let fut = database .get(docid) .send() .map(GetResponse::intoinner) .map(| document: MyConcreteStruct | { // do something with your struct }) .map_err(|e| println!("{}", e));

tokio::run(fut);

```

Building

bash cargo build

"oh my gosh so easy!"

Running Tests

bash cargo test

"sham-wow!"

Viewing Documentation

bash cargo doc --open

"kersplash!"

Contributing

bash cargo contribute

"bullseye!"

Current version: 0.0.0

License: Apache-2.0