Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jchris/hovercraft

An easy direct Erlang CouchDB library.
https://github.com/jchris/hovercraft

Last synced: 12 days ago
JSON representation

An easy direct Erlang CouchDB library.

Host: GitHub
URL: https://github.com/jchris/hovercraft
Owner: jchris
Created: 2009-04-22T00:25:56.000Z (over 15 years ago)
Default Branch: master
Last Pushed: 2010-09-18T22:33:28.000Z (about 14 years ago)
Last Synced: 2024-10-18T16:22:30.981Z (26 days ago)
Language: Erlang
Homepage: http://jchrisa.net/
Size: 140 KB
Stars: 121
Watchers: 3
Forks: 25
Open Issues: 5
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

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