Doing the simple stuff so you don't have to
Find a file
2008-06-01 15:07:56 -07:00
examples/word_count markov chain generation is pretty decent 2008-06-01 15:07:56 -07:00
lib update to new Couch, vendor finish 2008-06-01 10:23:24 -07:00
script markov chain generation is pretty decent 2008-06-01 15:07:56 -07:00
spec update to new Couch, vendor finish 2008-06-01 10:23:24 -07:00
vendor making the push pull script solid 2008-06-01 12:23:04 -07:00
views markov chain generation is pretty decent 2008-06-01 15:07:56 -07:00
website get views 2008-03-19 22:38:01 -07:00
couchrest.rb require farm 2008-05-18 13:10:25 -07:00
README Added a README 2008-05-29 12:46:46 -07:00
TODO Added a README 2008-05-29 12:46:46 -07:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Couchrest is a loose port of the couch.js library from CouchDBs Futon admin interface, which I find to be concise, clear, and well designed.

I prefer to stay close to the metal, especially when the metal is as clean and simple as CouchDBs HTTP API. The main thing Couchrest does for you is manage the Ruby <=> JSON serialization, and point your actions (database creation, document CRUD, view creation and queries, etc) at the appropriate API endpoints.

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 API. (We use it for Grabb.its Tumblr integration, and it works like a charm.)

The most complete source of documentation are the spec files. To ensure that your environment is setup for successful CouchRest operation, from the project root directory run `autotest` or `spec spec` (requires RSpec and optionally ZenTest for autotest support). 

Quick Start:

@cr = CouchRest.new("http://localhost:5984")
@db = @cr.create_db('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"]}
  ])
puts @db.documents.inspect # returns ids and revs of the current docs

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