public
Fork of arunthampi/activecouch
Description: ActiveCouch is a simple, convenient, Ruby-idiomatic wrapper for CouchDB
Homepage: http://github.com/arunthampi/activecouch
Clone URL: git://github.com/fcheung/activecouch.git
name age message
file .gitignore Wed Feb 18 18:33:07 -0800 2009 Add .gitignore [arunthampi]
file MIT-LICENSE Wed Jan 23 01:04:42 -0800 2008 - Re-organize in gem-friendly layout - Added Ra... [arunthampi]
file README Wed Feb 18 19:05:04 -0800 2009 Fix typo in README. Thanks HansCz [arunthampi]
file Rakefile Sun Jan 27 20:40:26 -0800 2008 - ActiveCouch::Base#find supports find by id so... [arunthampi]
file VERSION Tue Oct 21 23:36:49 -0700 2008 Cleaning up for v0.2.0 release. Added find_from... [Arun Thampi]
directory generators/ Tue Oct 21 20:58:19 -0700 2008 Make the exporter view over-write existing view... [Arun Thampi]
file init.rb Wed Oct 22 00:33:52 -0700 2008 Add install.rb which copies a dummy activecouch... [Arun Thampi]
directory lib/ Wed Feb 18 21:29:10 -0800 2009 Add support for raw views to be defined (with m... [arunthampi]
directory rails/ Tue Oct 21 04:40:00 -0700 2008 More Rails stuff - generators, rake tasks [Arun Thampi]
directory spec/ Sat Mar 14 22:07:40 -0700 2009 fixed a failing test that didn't account for ot... [Derek Perez]
directory tasks/ Wed Oct 22 19:56:41 -0700 2008 save_view and delete_view Rake tasks support sa... [Arun Thampi]
README
ActiveCouch wants to be a simple, convenient, idiomatic Object Relational Mapper for the hot new kid on the block - 
CouchDB. CouchDB (simplistically speaking) is a document store, which essentially means that objects can be stored in a 
schema-less environment.

What it is?
-----------
With ActiveCouch, you can easily save, query, delete documents to/from a CouchDB database in your favourite language - 
Ruby. ActiveCouch derives a lot of its principles (and some code) from both ActiveRecord and ActiveResource, two 
libraries made popular by the other hot pubescent on the block - Ruby on Rails (http://www.rubyonrails.org).

Why?
----
As they say, necessity is the mother of invention. And as they also say, death before inconvenience. Our company, Wego 
(http://www.wego.com) has been using CouchDB for the past six months now, as we have a need for a document-model to 
store vast amounts of information, and we needed a convenience mapper in our favourite language, in order to use CouchDB 
elegantly. Since, the Rubyists here at Wego are already very familiar with ActiveRecord semantics, care has been taken 
to ensure that ActiveCouch resembled it in many ways.

Contributors
------------

- Cheah Chu Yeow (http://www.github.com/chuyeow)
- Carlos Villela (http://www.github.com/cv)

Requirements
------------
 - Ruby 1.8.5 or above (http://www.ruby-lang.org)
 - rubygems 0.9.4 (http://rubygems.org)
 - JSON gem (http://json.rubyforge.org) [Used for JSON encoding/decoding]
 - RSpec gem (http://rspec.rubyforge.org) [Used to run specs]
 - CouchDB 0.8.0 and upwards ( http://incubator.apache.org/couchdb/community/code.html ) [Some specs require running 
 CouchDB at localhost:5984]
 
Important Notice
----------------

ActiveCouch v0.2.0 does not support pre-0.8.0 versions of CouchDB