eee-c-couch_docs 0.9.0 → 1.0.0

data/History.txt

@@ -1,3 +1,14 @@
+== 1.0.0 / 2009-08-09
+
+* Update the couch-docs script to be able to dump a CouchDB database
+  to a local directory as well as uploading a local directory into a
+  CouchDB database.
+
+  * CouchDB revision numbers are stripped when dumping (to prevent
+    conflicts when re-loading)
+
+  * Attachments are dumped as well.
+
 == 0.9.0 / 2009-08-08
 
 * Import from couch_design_docs (name change to reflect increased functionality)

data/README.rdoc

@@ -9,13 +9,36 @@ 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/"
 
@@ -30,6 +53,10 @@ Manage CouchDB views and documents.
   #    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
@@ -38,7 +65,7 @@ Manage CouchDB views and documents.
 
 == INSTALL:
 
-* sudo gem install couch_docs
+* sudo gem install eee-c-couch_docs
 
 == LICENSE:
 

data/couch_docs.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{couch_docs}
-  s.version = "0.9.0"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Chris Strom"]

data/lib/couch_docs.rb

@@ -1,7 +1,7 @@
 module CouchDocs
 
   # :stopdoc:
-  VERSION = '0.9.0'
+  VERSION = '1.0.0'
   LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
   PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
   # :startdoc:
@@ -55,7 +55,7 @@ module CouchDocs
     store.
       map.
       reject { |doc| doc['_id'] =~ /^_design/ }.
-      each   { |doc| dir.store_document(doc) }
+      each   { |doc| doc.delete('_rev'); dir.store_document(doc) }
   end
 
   # Returns the library path for the module. If any arguments are given,

data/lib/couch_docs/store.rb

@@ -57,7 +57,7 @@ module CouchDocs
 
     def each
       Store.get("#{url}/_all_docs")['rows'].each do |rec|
-        yield Store.get("#{url}/#{rec['id']}")
+        yield Store.get("#{url}/#{rec['id']}?attachments=true")
       end
     end
   end

data/spec/couch_docs_spec.rb

@@ -62,13 +62,22 @@ describe CouchDocs do
 
       CouchDocs.dump("uri", "fixtures")
     end
-    it "should be able to store all CouchDB documents on the filesystem" do
+    it "should ignore design documents" do
       @store.stub!(:map).and_return([{'_id' => '_design/foo'}])
       @dir.
         should_not_receive(:store_document)
 
       CouchDocs.dump("uri", "fixtures")
     end
+    it "should strip revision numbers" do
+      @store.stub!(:map).
+        and_return([{'_id' => 'foo', '_rev' => '1-1234'}])
+      @dir.
+        should_receive(:store_document).
+        with({'_id' => 'foo'})
+
+      CouchDocs.dump("uri", "fixtures")
+    end
   end
 end
 
@@ -162,8 +171,8 @@ describe Store do
                      "rows"       => [{"id"=>"1", "value"=>{}, "key"=>"1"},
                                       {"id"=>"2", "value"=>{}, "key"=>"2"}]})
 
-      Store.stub!(:get).with("uri/1")
-      Store.should_receive(:get).with("uri/2")
+      Store.stub!(:get).with("uri/1?attachments=true")
+      Store.should_receive(:get).with("uri/2?attachments=true")
 
       @it.each { }
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: eee-c-couch_docs
 version: !ruby/object:Gem::Version 
-  version: 0.9.0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Chris Strom