Doing the simple stuff so you don't have to
Find a file
Matt Aimonetti 6b2e5f84ad Started the refactoring work on couchrest.
* A server can have multiple defined available databases set to be used by documents (think DM repos)
* A server can have a default database so documents can easily share the same db connection
* Let a document class have a default database to use
* Give access to a document uri
* extracted some of the document features to a mixin
2009-01-28 22:55:42 -08:00
examples word count views 2009-01-15 15:12:52 -08:00
lib Started the refactoring work on couchrest. 2009-01-28 22:55:42 -08:00
spec Started the refactoring work on couchrest. 2009-01-28 22:55:42 -08:00
utils s/localhost/127.0.0.1/ 2008-12-14 12:05:02 +01:00
.gitignore added gem task for easy local packaging 2008-10-26 10:03:59 -05:00
couchrest.gemspec change couchrest back to _temp_view, rev gem version 2009-01-27 15:11:10 -08:00
github_gemtest.rb a file to check the gem build 2008-11-26 13:42:27 -08:00
LICENSE added apache license 2008-09-11 21:31:59 -07:00
make-gemspec.sh make gemspec cleans build products before gemspecing 2009-01-12 21:19:02 -08:00
Rakefile drop couchdir binary 2009-01-19 16:13:03 -08:00
README.md updated word count example 2009-01-15 15:05:55 -08:00
THANKS.md updated thanks file 2009-01-12 21:10:00 -08:00

CouchRest: CouchDB, close to the metal

CouchRest is based on CouchDB's couch.js test library, which I find to be concise, clear, and well designed. CouchRest lightly wraps CouchDB's HTTP API, managing JSON serialization, and remembering the URI-paths to CouchDB's API endpoints so you don't have to.

CouchRest is designed to make a simple base for application and framework-specific object oriented APIs. CouchRest is Object-Mapper agnostic, the parsed JSON it returns from CouchDB shows up as subclasses of Ruby's Hash. Naked JSON, just as it was mean to be.

Easy Install

Easy Install is moving to RubyForge, heads up for the gem.

Relax, it's RESTful

The core of Couchrest is Herokus excellent REST Client Ruby HTTP wrapper. REST Client takes all the nastyness of Net::HTTP and gives is a pretty face, while still giving you more control than Open-URI. I recommend it anytime youre interfacing with a well-defined web service.

Running the Specs

The most complete documentation is the spec/ directory. To validate your CouchRest install, from the project root directory run rake, or autotest (requires RSpec and optionally ZenTest for autotest support).

Examples

Quick Start:

# with !, it creates the database if it doesn't already exist
@db = CouchRest.database!("http://127.0.0.1:5984/couchrest-test")
response = @db.save({:key => 'value', 'another key' => 'another value'})
doc = @db.get(response['id'])
puts doc.inspect

Bulk Save:

@db.bulk_save([
    {"wild" => "and random"},
    {"mild" => "yet local"},
    {"another" => ["set","of","keys"]}
  ])
# returns ids and revs of the current docs
puts @db.documents.inspect 

Creating and Querying Views:

@db.save({
  "_id" => "_design/first", 
  :views => {
    :test => {
      :map => "function(doc){for(var w in doc){ if(!w.match(/^_/))emit(w,doc[w])}}"
      }
    }
  })
puts @db.view('first/test')['rows'].inspect 

CouchRest::Model

CouchRest::Model is a module designed along the lines of DataMapper::Resource. By subclassing, suddenly you get all sorts of powerful sugar, so that working with CouchDB in your Rails or Merb app is no harder than working with the standard SQL alternatives. See the CouchRest::Model documentation for an example article class that illustrates usage.

CouchRest::Model will be removed from this package.