couchdb 0.1.0

data/lib/couchdb/row.rb

@@ -0,0 +1,22 @@
+
+module CouchDB
+
+  # The Row class acts as a wrapper for a CouchDB view result row.
+  class Row
+
+    attr_reader :database
+    attr_reader :id
+    attr_reader :key
+    attr_reader :value
+
+    def initialize(database, attributes = { })
+      @database, @id, @key, @value, @document = database, *attributes.values_at("id", "key", "value", "doc")
+    end
+
+    def document
+      Document.new @database, @document
+    end
+
+  end
+
+end

data/lib/couchdb/server.rb

@@ -0,0 +1,42 @@
+
+module CouchDB
+
+  # The Server class provides methods to retrieve informations and statistics
+  # of a CouchDB server.
+  class Server
+
+    attr_reader :host
+    attr_reader :port
+
+    def initialize(host = "localhost", port = 5984)
+      @host, @port = host, port
+    end
+
+    def ==(other)
+      other.is_a?(self.class) && @host == other.host && @port == other.port
+    end
+
+    def information
+      Transport::JSON.request :get, url + "/", :expected_status_code => 200
+    end
+
+    def statistics
+      Transport::JSON.request :get, url + "/_stats", :expected_status_code => 200
+    end
+
+    def database_names
+      Transport::JSON.request :get, url + "/_all_dbs", :expected_status_code => 200
+    end
+
+    def uuids(count = 1)
+      response = Transport::JSON.request :get, url + "/_uuids", :expected_status_code => 200, :parameters => { :count => count }
+      response["uuids"]
+    end
+
+    def url
+      "http://#{@host}:#{@port}"
+    end
+
+  end
+
+end

data/spec/acceptance/database_spec.rb

@@ -0,0 +1,56 @@
+require File.join(File.dirname(__FILE__), "..", "spec_helper")
+
+describe CouchDB::Database do
+
+  before :each do
+    @server = CouchDB::Server.new
+    @database = described_class.new @server, "test"
+  end
+
+  describe "create!" do
+
+    before :each do
+      @database.delete_if_exists!
+    end
+
+    it "should create the database" do
+      @database.create!
+      @database.exists?.should be_true
+    end
+
+  end
+
+  describe "delete!" do
+
+    before :each do
+      @database.create_if_missing!
+    end
+
+    it "should delete the database" do
+      @database.delete!
+      @database.exists?.should be_false
+    end
+
+  end
+
+  describe "information" do
+
+    before :each do
+      @database.create_if_missing!
+    end
+
+    it "should return information about the database" do
+      @database.information.should be_instance_of(Hash)
+    end
+
+  end
+
+  describe "documents" do
+
+    it "should return a collection" do
+      @database.documents.should be_instance_of(CouchDB::Collection)
+    end
+
+  end
+
+end

data/spec/acceptance/document_spec.rb

@@ -0,0 +1,78 @@
+require File.join(File.dirname(__FILE__), "..", "spec_helper")
+
+describe CouchDB::Document do
+
+  before :each do
+    @server = CouchDB::Server.new
+    @database = CouchDB::Database.new @server, "test"
+    @database.delete_if_exists!
+    @database.create_if_missing!
+
+    @document = described_class.new @database, "_id" => "test_document_1", "test" => "test value"
+    @document.save
+  end
+
+  after :each do
+    @document.destroy
+  end
+
+  describe "load" do
+
+    it "should load the document's properties" do
+      @document["test"] = nil
+      @document.load
+      @document["test"].should == "test value"
+    end
+
+  end
+
+  describe "save" do
+
+    context "on a new model" do
+
+      before :each do
+        begin
+          @document.load
+          @document.destroy
+        rescue described_class::NotFoundError
+        end
+      end
+
+      it "should create the document" do
+        lambda do
+          @document.save
+        end.should change(@document, :new?).from(true).to(false)
+      end
+
+    end
+
+    context "on an existing model" do
+
+      it "should update the document" do
+        lambda do
+          @document["test"] = "another test value"
+          @document.save
+        end.should change(@document, :rev)
+      end
+
+    end
+
+  end
+
+  describe "destroy" do
+
+    it "should destroy the document" do
+      lambda do
+        @document.destroy
+      end.should change(@document, :exists?).from(true).to(false)
+    end
+
+    it "should set the document's state to new" do
+      lambda do
+        @document.destroy
+      end.should change(@document, :new?).from(false).to(true)
+    end
+
+  end
+
+end

data/spec/acceptance/server_spec.rb

@@ -0,0 +1,43 @@
+require File.join(File.dirname(__FILE__), "..", "spec_helper")
+
+describe CouchDB::Server do
+
+  before :each do
+    @server = described_class.new
+  end
+
+  describe "information" do
+
+    it "should return some information about the server" do
+      @server.information.should == { "couchdb" => "Welcome", "version" => "1.0.1" }
+    end
+
+  end
+
+  describe "statistics" do
+
+    it "should return some statistics about the server" do
+      @server.statistics.should be_instance_of(Hash)
+    end
+
+  end
+
+  describe "database_names" do
+
+    it "should return the names of all databases" do
+      @server.database_names.should be_instance_of(Array)
+    end
+
+  end
+
+  describe "uuids" do
+
+    it "should return the given number of generated uuids" do
+      uuids = @server.uuids 4
+      uuids.should be_instance_of(Array)
+      uuids.size.should == 4
+    end
+
+  end
+
+end

data/spec/acceptance/views_spec.rb

@@ -0,0 +1,49 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper"))
+
+describe "views" do
+
+  before :each do
+    @server = CouchDB::Server.new
+    @database = CouchDB::Database.new @server, "test"
+    @database.delete_if_exists!
+    @database.create_if_missing!
+
+    @document_one = CouchDB::Document.new @database, "_id" => "test_document_1", "category" => "one"
+    @document_one.save
+    @document_two = CouchDB::Document.new @database, "_id" => "test_document_2", "category" => "two"
+    @document_two.save
+
+    @design = CouchDB::Design.new @database, "design_1"
+    @view = CouchDB::Design::View.new @design, "view_1",
+      "function(document) { emit([ document['category'], document['_id'] ]); }"
+    @design.save
+  end
+
+  describe "collection" do
+
+    it "should return a collection including the right rows" do
+      collection = @view.collection :startkey => [ "one", nil ], :endkey => [ "one", { } ]
+      collection.size.should == 1
+      collection[0].id.should == "test_document_1"
+      collection[0].key.should == [ "one", "test_document_1" ]
+      collection[0].value.should be_nil
+    end
+
+    it "should return a collection including the right documents" do
+      collection = @view.collection :startkey => [ "one", nil ], :endkey => [ "one", { } ]
+      collection.documents.should include(@document_one)
+      collection.documents.should_not include(@document_two)
+    end
+
+  end
+
+  describe "all documents collection" do
+
+    it "should return a collection with all documents of the database" do
+      collection = @database.documents
+      collection.size.should == 3 # two documents plus the design
+    end
+
+  end
+
+end

data/spec/lib/couchdb/collection_spec.rb

@@ -0,0 +1,121 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "spec_helper"))
+
+describe CouchDB::Collection do
+
+  before :each do
+    Transport::JSON.stub(:request)
+    @database = mock CouchDB::Database
+
+    @collection = described_class.new @database, "http://host:1234/test/_all_docs"
+  end
+
+  describe "initialize" do
+
+    it "should set the database" do
+      @collection.database.should == @database
+    end
+
+    it "should set the url" do
+      @collection.url.should == "http://host:1234/test/_all_docs"
+    end
+
+  end
+
+  describe "total_count" do
+
+    before :each do
+      Transport::JSON.stub(:request).and_return({ "total_rows" => 1 })
+    end
+
+    describe "without a previously performed fetch" do
+
+      it "should perform a meta fetch (with a limit of zero)" do
+        Transport::JSON.should_receive(:request).with(
+          :get,
+          "http://host:1234/test/_all_docs",
+          :parameters => { :limit => 0 },
+          :encode_parameters => true,
+          :expected_status_code => 200
+        ).and_return({ "total_rows" => 1 })
+        @collection.total_count
+      end
+
+      it "should return the total count" do
+        @collection.total_count.should == 1
+      end
+
+    end
+
+    describe "with a previously performed fetch" do
+
+      before :each do
+        @collection.first # perform the fetch
+      end
+
+      it "should not perform another fetch" do
+        Transport::JSON.should_not_receive(:request)
+        @collection.total_count
+      end
+
+      it "should return the total count" do
+        @collection.total_count.should == 1
+      end
+
+    end
+
+  end
+
+  describe "first" do
+
+    before :each do
+      @row_hash = mock Hash
+      Transport::JSON.stub(:request).and_return({
+        "total_rows" => 1,
+        "rows" => [ @row_hash ]
+      })
+      @row = mock CouchDB::Row
+      CouchDB::Row.stub(:new).and_return(@row)
+    end
+
+    it "should initialize the row with the row hash" do
+      CouchDB::Row.should_receive(:new).with(@database, @row_hash).and_return(@row)
+      @collection.first
+    end
+
+    it "should return the first element of the fetched result" do
+      @collection.first.should == @row
+    end
+
+    it "should update the total count" do
+      @collection.first
+      @collection.total_count.should == 1
+    end
+
+  end
+
+  describe "documents" do
+
+    before :each do
+      @document = mock CouchDB::Document
+      @row = mock CouchDB::Row, :document => @document
+      @collection.stub(:map).and_yield(@row).and_return([ @document ])
+    end
+
+    it "should add the include docs options" do
+      @collection.documents.first
+      @collection.options.should include(:include_docs => true)
+    end
+
+    it "should map the rows to documents" do
+      @collection.should_receive(:map).and_yield(@row).and_return([ @document ])
+      @collection.documents.first
+    end
+
+    it "should return the selected row's document" do
+      document = @collection.documents.first
+      document.should == @document
+    end
+
+  end
+
+end

data/spec/lib/couchdb/database_spec.rb

@@ -0,0 +1,138 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "spec_helper"))
+
+describe CouchDB::Database do
+
+  before :each do
+    Transport::JSON.stub(:request)
+    @server = mock CouchDB::Server, :url => "http://host:1234", :database_names => [ "test" ]
+
+    @database = CouchDB::Database.new @server, "test"
+  end
+
+  describe "==" do
+
+    it "should be true when comparing two equal databases" do
+      @database.should == described_class.new(@server, "test")
+    end
+
+    it "should be false when comparing two different databases" do
+      @database.should_not == described_class.new(@server, "different")
+    end
+
+  end
+
+  describe "===" do
+
+    it "should be true when comparing a database object with itself" do
+      @database.should === @database
+    end
+
+    it "should be false when comparing a database object with another database object" do
+      @database.should_not === described_class.new(@server, "test")
+    end
+
+  end
+
+  describe "create!" do
+
+    it "should request the create of the database" do
+      Transport::JSON.should_receive(:request).with(
+        :put,
+        "http://host:1234/test",
+        :expected_status_code => 201
+      )
+      @database.create!
+    end
+
+  end
+
+  describe "create_if_missing!" do
+
+    before :each do
+      @database.stub(:create!)
+    end
+
+    it "should not call create! if the database exists" do
+      @database.stub(:exists?).and_return(true)
+      @database.should_not_receive(:create!)
+      @database.create_if_missing!
+    end
+
+    it "should call create! if the database not exists" do
+      @database.stub(:exists?).and_return(false)
+      @database.should_receive(:create!)
+      @database.create_if_missing!
+    end
+
+  end
+
+  describe "delete!" do
+
+    it "should delete the database" do
+      Transport::JSON.should_receive(:request).with(
+        :delete,
+        "http://host:1234/test",
+        :expected_status_code => 200
+      )
+      @database.delete!
+    end
+
+  end
+
+  describe "delete_if_exists!" do
+
+    before :each do
+      @database.stub(:delete!)
+    end
+
+    it "should call delete! if the database exists" do
+      @database.stub(:exists?).and_return(true)
+      @database.should_receive(:delete!)
+      @database.delete_if_exists!
+    end
+
+    it "should not call delete! if the database not exists" do
+      @database.stub(:exists?).and_return(false)
+      @database.should_not_receive(:delete!)
+      @database.delete_if_exists!
+    end
+
+  end
+
+  describe "information" do
+
+    it "should request database information" do
+      Transport::JSON.should_receive(:request).with(
+        :get,
+        "http://host:1234/test",
+        :expected_status_code => 200
+      ).and_return("result")
+      @database.information.should == "result"
+    end
+
+  end
+
+  describe "exists?" do
+
+    it "should be true" do
+      @database.exists?.should be_true
+    end
+
+    it "should be false if no database with the given name exists" do
+      database = described_class.new @server, "invalid"
+      database.exists?.should be_false
+    end
+
+  end
+
+  describe "documents" do
+
+    it "should return a collection" do
+      collection = @database.documents
+      collection.should be_instance_of(CouchDB::Collection)
+      collection.url.should == "http://host:1234/test/_all_docs"
+    end
+
+  end
+
+end