MyCouch 6.0.0

MyCouch.CouchDB client

MyCouch is a simple async CouchDB client building on top of the async HTTP client and uses JSON.Net to provide flexible serialization behaviour. It tries to keep the domain language of CouchDB and lets you work with requests and responses but also provides you with an alternative simplifying async API. MyCouch lets you work with raw JSON and/or entities/POCOS without requiring any implementation of interfaces or base-classes etc.

Install-Package MyCouch -Version 6.0.0
dotnet add package MyCouch --version 6.0.0
paket add MyCouch --version 6.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Quick sample - using Requests and Responses

using(var client = new MyCouchClient("http://localhost:5984/", "mydb"))
{
    //POST with server generated id
    await client.Documents.PostAsync("{\"name\":\"Daniel\"}");

	//POST with client generated id - possible but wrong
    await client.Documents.PostAsync("{\"_id":\"someId", \"name\":\"Daniel\"}");

    //PUT for client generated id
    await client.Documents.PutAsync("someId", "{\"name\":\"Daniel\"}");

    //PUT for updates
    await client.Documents.PutAsync("someId", "docRevision", "{\"name\":\"Daniel Wertheim\"}");

	//PUT for updates with _rev in JSON
    await client.Documents.PutAsync("someId", "{\"_rev\": \"docRevision\", \"name\":\"Daniel Wertheim\"}");

    //Using entities
    var me = new Person {Id = "SomeId", Name = "Daniel"};
    await client.Entities.PutAsync(me);

    //Using anonymous entities
    await client.Entities.PostAsync(new { Name = "Daniel" });
}
using(var client = new MyCouchServerClient("http://localhost:5984"))
{
    var r = await client.Replicator.ReplicateAsync(id, source, target);
}

Quick sample - using MyCouchStore

using(var store = new MyCouchStore("http://localhost:5984", "mydb"))
{
    var mySomething = await store.StoreAsync(new Something("foo", "bar", 42));

    var retrieved = await store.GetByIdAsync(mySomething.Id);

    var deleted = await store.DeleteAsync(mySomething.Id, mySomething.Rev);

    //... ... and so on... ...
}

Quick sample - using Requests and Responses

using(var client = new MyCouchClient("http://localhost:5984/", "mydb"))
{
    //POST with server generated id
    await client.Documents.PostAsync("{\"name\":\"Daniel\"}");

	//POST with client generated id - possible but wrong
    await client.Documents.PostAsync("{\"_id":\"someId", \"name\":\"Daniel\"}");

    //PUT for client generated id
    await client.Documents.PutAsync("someId", "{\"name\":\"Daniel\"}");

    //PUT for updates
    await client.Documents.PutAsync("someId", "docRevision", "{\"name\":\"Daniel Wertheim\"}");

	//PUT for updates with _rev in JSON
    await client.Documents.PutAsync("someId", "{\"_rev\": \"docRevision\", \"name\":\"Daniel Wertheim\"}");

    //Using entities
    var me = new Person {Id = "SomeId", Name = "Daniel"};
    await client.Entities.PutAsync(me);

    //Using anonymous entities
    await client.Entities.PostAsync(new { Name = "Daniel" });
}
using(var client = new MyCouchServerClient("http://localhost:5984"))
{
    var r = await client.Replicator.ReplicateAsync(id, source, target);
}

Quick sample - using MyCouchStore

using(var store = new MyCouchStore("http://localhost:5984", "mydb"))
{
    var mySomething = await store.StoreAsync(new Something("foo", "bar", 42));

    var retrieved = await store.GetByIdAsync(mySomething.Id);

    var deleted = await store.DeleteAsync(mySomething.Id, mySomething.Rev);

    //... ... and so on... ...
}

Release Notes

https://github.com/danielwertheim/mycouch/wiki/release-notes

Version History

Version Downloads Last updated
6.0.0 10,564 4/29/2018
5.1.1 1,911 3/19/2018
5.1.0 249 3/16/2018
5.0.3 4,916 11/19/2017
5.0.3-pre19 131 11/19/2017
5.0.3-pre18 128 11/19/2017
5.0.2 1,020 10/4/2017
5.0.1 4,624 6/29/2017
5.0.1-pre9 215 5/18/2017
5.0.0-pre5 603 4/2/2017
4.0.0 10,803 11/25/2015
4.0.0-rc6 322 11/15/2015
4.0.0-rc5 276 11/14/2015
4.0.0-rc4 285 11/9/2015
4.0.0-rc3 283 11/8/2015
4.0.0-rc2 278 11/8/2015
4.0.0-rc1 344 10/13/2015
3.2.0 5,322 5/1/2015
3.1.1 436 4/24/2015
3.1.0 4,426 2/18/2015
3.0.0 1,213 12/29/2014
2.6.0 1,334 10/21/2014
2.5.0 326 10/14/2014
2.4.2 278 10/11/2014
2.4.1 399 9/18/2014
2.4.0 432 9/6/2014
2.3.0 288 9/1/2014
2.2.2 322 8/26/2014
2.2.1 583 6/18/2014
2.2.0 263 6/17/2014
2.1.1 279 6/16/2014
2.1.0 267 6/15/2014
2.0.0 2,046 5/18/2014
1.0.0 545 4/16/2014