couchrest_model/README.rdoc

57 lines
2.3 KiB
Plaintext
Raw Normal View History

2008-09-12 07:21:16 +02:00
== CouchRest - CouchDB, close to the metal
2008-09-07 21:54:22 +02:00
CouchRest is based on [CouchDB's couch.js test library](http://svn.apache.org/repos/asf/incubator/couchdb/trunk/share/www/script/couch.js), 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's lighweight is designed to make a simple base for application and framework-specific object oriented APIs.
2008-09-12 07:21:16 +02:00
=== Easy Install
2008-09-07 21:54:22 +02:00
2008-09-12 07:21:16 +02:00
sudo gem install jchris-couchrest -s http://gems.github.com
2008-09-07 21:54:22 +02:00
2008-09-12 07:21:16 +02:00
=== Relax, it's RESTful
2008-09-07 21:54:22 +02:00
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.
2008-09-12 07:21:16 +02:00
=== Running the Specs
2008-09-07 21:54:22 +02:00
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).
2008-09-12 07:21:16 +02:00
=== Examples
2008-09-07 21:54:22 +02:00
Quick Start:
# with !, it creates the database if it doesn't already exist
@db = CouchRest.database!("http://localhost: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
2008-09-30 07:56:24 +02:00
== CouchRest::Model
2008-09-07 21:54:22 +02:00
2008-09-30 07:56:24 +02:00
CouchRest::Model is a module designed along the lines of DataMapper::Resource. By
including it in your class, suddenly you get all sorts of magic 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 and example article class that illustrates usage.