Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

47 lines (29 sloc) 1.531 kB

We have the hovercraft. It is fast and it skims just above the surface.

There is much to be added to the hovercraft, but it already flies.

Welcome to Hovercraft

An easy direct Erlang CouchDB library.

Use this to abstract CouchDB behind a simple Erlang function call. Currently supports the database and document APIs, with views on the way.

Basic Usage

Hovercraft master is only compatible with CouchDB trunk. If the tests fail, make sure you are running on the latest latest CouchDB.

There is a 0.11 branch which is compatible with CouchDB 0.11. Use it when appropriate.

The easiest way to try Hovercraft is to put the hovercraft directory inside the CouchDB trunk directory and then launch CouchDB like this:

erlc hovercraft/*erl && make dev && ERL_LIBS="hovercraft" utils/run -i

This will open an interactive session. To run the tests, call hovercraft:test/0 like this:

1> hovercraft_test:all().
[info] [<0.30.0>] Starting tests in <<"hovercraft-test">>
ok

Speed of Light

To run the speed of light test, run hovercraft:lightning/0 like this:

2> hovercraft_test:lightning().
Inserted 100000 docs in 14.967256 seconds with batch size of 1000. (6681.251393040915 docs/sec)
ok

To try different tunings, you can call hovercraft:lightning/1 with custom batch sizes. The docs in the speed of light test are small, feel free to edit the source code to try larger docs.

Credits

Released at #CouchHack '09 Apache 2.0 License Copyright 2009 J. Chris Anderson jchris@couch.io

Jump to Line
Something went wrong with that request. Please try again.