README.rdoc in eee-c-couch_docs-0.9.0 vs README.rdoc in eee-c-couch_docs-1.0.0
- old
+ new
@@ -7,17 +7,40 @@
Manage CouchDB views and documents.
== FEATURES/PROBLEMS:
-* Store your CouchDB documents on the filesystem for on-demand
- upload. Design documents are kept in a <tt>_design</tt>
- sub-directory, with <tt>.js</tt> extensions. Normal documents are
- stored with a <tt>.json</tt> extension.
+* Upload JSON documents stored on the filesystem into a CouchDB
+ database.
+* Map <tt>.js</tt> files stored on the filesystem
+ (e.g. <tt>_design/recipes/count_by_month/map.js</tt>) into CouchDB
+ design documents.
+
+* Dump documents stored in CouchDB to the filesystem.
+
+* Script (couch-docs) to restore / backup CouchDB database.
+
+* The couch-docs scipts does not work with design documents.
+
+* A progress bar would be helpful.
+
+* Unit testing of view javascript would be very nice.
+
== SYNOPSIS:
+ From the command line:
+
+ # For dumping the contents of a CouchDB database to the filesystem
+ couch-docs dump "http://localhost:5984/db" path/to/dump_dir/
+
+ # For loading documents from the filesystem into CouchDB
+ couch-docs load path/to/dump_dir/ "http://localhost:5984/db"
+
+
+ In code:
+
DB_URL = "http://localhost:5984/db"
DIRECTORY = "/repos/db/couchdb/"
# /repos/db/couchdb/_design/lucene/transform.js
# /repos/db/couchdb/foo.json
@@ -28,18 +51,22 @@
# the contents of transform.js
# - AND -
# a document named "foo" with the JSON contents from the foo.json
# file
+ CouchDocs.dump(DB_URL, "/repos/db/bak")
+
+ # => JSON dump of every document at DB_URL
+
== REQUIREMENTS:
* CouchDB
* JSON
* RestClient
== INSTALL:
-* sudo gem install couch_docs
+* sudo gem install eee-c-couch_docs
== LICENSE:
(The MIT License)