mongo 1.12.5 → 2.0.0.beta

data/spec/mongo/client_spec.rb

@@ -0,0 +1,564 @@
+require 'spec_helper'
+
+describe Mongo::Client do
+
+  describe '#==' do
+
+    let(:client) do
+      described_class.new(
+        ['127.0.0.1:27017'],
+        :read => { :mode => :primary },
+        :database => TEST_DB
+      )
+    end
+
+    context 'when the other is a client' do
+
+      context 'when the options and cluster are equal' do
+
+        let(:other) do
+          described_class.new(
+            ['127.0.0.1:27017'],
+            :read => { :mode => :primary },
+            :database => TEST_DB
+          )
+        end
+
+        it 'returns true' do
+          expect(client).to eq(other)
+        end
+      end
+
+      context 'when the options and cluster are not equal' do
+
+        let(:other) do
+          described_class.new(
+            ['127.0.0.1:27017'],
+            :read => { :mode => :secondary },
+            :database => TEST_DB
+          )
+        end
+
+        it 'returns true' do
+          expect(client).not_to eq(other)
+        end
+      end
+    end
+
+    context 'when the other is not a client' do
+
+      it 'returns false' do
+        expect(client).not_to eq('test')
+      end
+    end
+  end
+
+  describe '#[]' do
+
+    let(:client) do
+      described_class.new(['127.0.0.1:27017'], :database => TEST_DB)
+    end
+
+    shared_examples_for 'a collection switching object' do
+
+      before do
+        client.use(:dbtest)
+      end
+
+      it 'returns the new collection' do
+        expect(collection.name).to eq('users')
+      end
+    end
+
+    context 'when provided a string' do
+
+      let(:collection) do
+        client['users']
+      end
+
+      it_behaves_like 'a collection switching object'
+    end
+
+    context 'when provided a symbol' do
+
+      let(:collection) do
+        client[:users]
+      end
+
+      it_behaves_like 'a collection switching object'
+    end
+  end
+
+  describe '#eql' do
+
+    let(:client) do
+      described_class.new(
+        ['127.0.0.1:27017'],
+        :read => { :mode => :primary },
+        :database => TEST_DB
+      )
+    end
+
+    context 'when the other is a client' do
+
+      context 'when the options and cluster are equal' do
+
+        let(:other) do
+          described_class.new(
+            ['127.0.0.1:27017'],
+            :read => { :mode => :primary },
+            :database => TEST_DB
+          )
+        end
+
+        it 'returns true' do
+          expect(client).to eql(other)
+        end
+      end
+
+      context 'when the options and cluster are not equal' do
+
+        let(:other) do
+          described_class.new(
+            ['127.0.0.1:27017'],
+            :read => { :mode => :secondary },
+            :database => TEST_DB
+          )
+        end
+
+        it 'returns true' do
+          expect(client).not_to eql(other)
+        end
+      end
+    end
+
+    context 'when the other is not a client' do
+
+      let(:client) do
+        described_class.new(
+          ['127.0.0.1:27017'],
+          :read => { :mode => :primary },
+          :database => TEST_DB
+        )
+      end
+
+      it 'returns false' do
+        expect(client).not_to eql('test')
+      end
+    end
+  end
+
+  describe '#hash' do
+
+    let(:client) do
+      described_class.new(
+        ['127.0.0.1:27017'],
+        :read => { :mode => :primary },
+        :local_threshold_ms => 10,
+        :server_selection_timeout_ms => 10000,
+        :database => TEST_DB
+      )
+    end
+
+    let(:expected) do
+      [client.cluster, { :read => { :mode => :primary },
+                         :local_threshold_ms => 10,
+                         :server_selection_timeout_ms => 10000,
+                         :database => TEST_DB }].hash
+    end
+
+    it 'returns a hash of the cluster and options' do
+      expect(client.hash).to eq(expected)
+    end
+  end
+
+  describe '#inspect' do
+
+    let(:client) do
+      described_class.new(
+        ['127.0.0.1:27017'],
+        :read => { :mode => :primary },
+        :database => TEST_DB
+      )
+    end
+
+    it 'returns the cluster information' do
+      expect(client.inspect).to include(
+        "<Mongo::Client:0x#{client.object_id} cluster=127.0.0.1:27017"
+      )
+    end
+  end
+
+  describe '#initialize' do
+
+    context 'when providing options' do
+
+      context 'when no database is provided' do
+
+        let(:client) do
+          described_class.new(['127.0.0.1:27017'], :read => { :mode => :secondary })
+        end
+
+        it 'defaults the database to admin' do
+          expect(client.database.name).to eq('admin')
+        end
+      end
+
+      context 'when a database is provided' do
+
+        let(:client) do
+          described_class.new(['127.0.0.1:27017'], :database => :testdb)
+        end
+
+        it 'sets the current database' do
+          expect(client[:users].name).to eq('users')
+        end
+      end
+    end
+
+    context 'when providing a connection string' do
+
+      context 'when a database is provided' do
+
+        let!(:uri) do
+          'mongodb://127.0.0.1:27017/testdb'
+        end
+
+        let(:client) do
+          described_class.new(uri)
+        end
+
+        it 'sets the database' do
+          expect { client[:users] }.to_not raise_error
+        end
+      end
+
+      context 'when a database is not provided' do
+
+        let!(:uri) do
+          'mongodb://127.0.0.1:27017'
+        end
+
+        let(:client) do
+          described_class.new(uri)
+        end
+
+        it 'defaults the database to admin' do
+          expect(client.database.name).to eq('admin')
+        end
+      end
+
+      context 'when options are provided' do
+
+        let!(:uri) do
+          'mongodb://127.0.0.1:27017/testdb?w=3'
+        end
+
+        let(:client) do
+          described_class.new(uri)
+        end
+
+        it 'sets the options' do
+          expect(client.options).to eq(:write => { :w => 3 }, :database => 'testdb')
+        end
+      end
+
+      context 'when options are provided not in the string' do
+
+        let!(:uri) do
+          'mongodb://127.0.0.1:27017/testdb'
+        end
+
+        let(:client) do
+          described_class.new(uri, :write => { :w => 3 })
+        end
+
+        it 'sets the options' do
+          expect(client.options).to eq(:write => { :w => 3 }, :database => 'testdb')
+        end
+      end
+
+      context 'when options are provided in the string and explicitly' do
+
+        let!(:uri) do
+          'mongodb://127.0.0.1:27017/testdb?w=3'
+        end
+
+        let(:client) do
+          described_class.new(uri, :write => { :w => 4 })
+        end
+
+        it 'allows explicit options to take preference' do
+          expect(client.options).to eq(:write => { :w => 4 }, :database => 'testdb')
+        end
+      end
+
+      context 'when a replica set name is provided' do
+
+        let!(:uri) do
+          'mongodb://127.0.0.1:27017/testdb?replicaSet=testing'
+        end
+
+        let(:client) do
+          described_class.new(uri)
+        end
+
+        it 'sets the correct cluster topology' do
+          expect(client.cluster.topology).to be_a(Mongo::Cluster::Topology::ReplicaSet)
+        end
+      end
+    end
+  end
+
+  describe '#read_preference' do
+
+    let(:client) do
+      described_class.new(['127.0.0.1:27017'],
+                          :database => TEST_DB,
+                          :read => mode)
+    end
+
+    let(:preference) do
+      client.read_preference
+    end
+
+    context 'when mode is primary' do
+
+      let(:mode) do
+        { :mode => :primary }
+      end
+
+      it 'returns a primary read preference' do
+        expect(preference).to be_a(Mongo::ServerSelector::Primary)
+      end
+
+      it 'passes the options to the read preference' do
+        expect(preference.options[:database]).to eq(TEST_DB)
+      end
+    end
+
+    context 'when mode is primary_preferred' do
+
+      let(:mode) do
+        { :mode => :primary_preferred }
+      end
+
+      it 'returns a primary preferred read preference' do
+        expect(preference).to be_a(Mongo::ServerSelector::PrimaryPreferred)
+      end
+    end
+
+    context 'when mode is secondary' do
+
+      let(:mode) do
+        { :mode => :secondary }
+      end
+
+      it 'returns a secondary read preference' do
+        expect(preference).to be_a(Mongo::ServerSelector::Secondary)
+      end
+    end
+
+    context 'when mode is secondary preferred' do
+
+      let(:mode) do
+        { :mode => :secondary_preferred }
+      end
+
+      it 'returns a secondary preferred read preference' do
+        expect(preference).to be_a(Mongo::ServerSelector::SecondaryPreferred)
+      end
+    end
+
+    context 'when mode is nearest' do
+
+      let(:mode) do
+        { :mode => :nearest }
+      end
+
+      it 'returns a nearest read preference' do
+        expect(preference).to be_a(Mongo::ServerSelector::Nearest)
+      end
+    end
+
+    context 'when no mode provided' do
+
+      let(:mode) do
+        {}
+      end
+
+      it 'returns a primary read preference' do
+        expect(preference).to be_a(Mongo::ServerSelector::Primary)
+      end
+    end
+  end
+
+  describe '#use' do
+
+    let(:client) do
+      described_class.new(['127.0.0.1:27017'], :database => TEST_DB)
+    end
+
+    shared_examples_for 'a database switching object' do
+
+      it 'returns the new client' do
+        expect(client.send(:database).name).to eq('ruby-driver')
+      end
+    end
+
+    context 'when provided a string' do
+
+      let(:database) do
+        client.use('testdb')
+      end
+
+      it_behaves_like 'a database switching object'
+    end
+
+    context 'when provided a symbol' do
+
+      let(:database) do
+        client.use(:testdb)
+      end
+
+      it_behaves_like 'a database switching object'
+    end
+
+    context 'when providing nil' do
+
+      it 'raises an exception' do
+        expect {
+          client.use(nil)
+        }.to raise_error(Mongo::Error::InvalidDatabaseName)
+      end
+    end
+  end
+
+  describe '#with' do
+
+    context 'when the write concern is not changed' do
+
+      let(:client) do
+        described_class.new(
+          ['127.0.0.1:27017'],
+          :read => { :mode => :secondary }, :write => { :w => 1 }, :database => TEST_DB
+        )
+      end
+
+      let!(:new_client) do
+        client.with(:read => { :mode => :primary })
+      end
+
+      it 'returns a new client' do
+        expect(new_client).not_to equal(client)
+      end
+
+      it 'replaces the existing options' do
+        expect(new_client.options).to eq({
+          :read => { :mode => :primary }, :write => { :w => 1 }, :database => TEST_DB
+        })
+      end
+
+      it 'does not modify the original client' do
+        expect(client.options).to eq({
+          :read => { :mode => :secondary }, :write => { :w => 1 }, :database => TEST_DB
+        })
+      end
+
+      it 'keeps the same cluster' do
+        expect(new_client.cluster).to equal(client.cluster)
+      end
+    end
+
+    context 'when the write concern is changed' do
+
+      let(:client) do
+        described_class.new(['127.0.0.1:27017'], :write => { :w => 1 }, :database => TEST_DB)
+      end
+
+      context 'when the write concern has not been accessed' do
+
+        let!(:new_client) do
+          client.with(:write => { :w => 0 })
+        end
+
+        let(:get_last_error) do
+          new_client.write_concern.get_last_error
+        end
+
+        it 'returns the correct write concern' do
+          expect(get_last_error).to be_nil
+        end
+      end
+
+      context 'when the write concern has been accessed' do
+
+        let!(:new_client) do
+          client.write_concern
+          client.with(:write => { :w => 0 })
+        end
+
+        let(:get_last_error) do
+          new_client.write_concern.get_last_error
+        end
+
+        it 'returns the correct write concern' do
+          expect(get_last_error).to be_nil
+        end
+      end
+    end
+  end
+
+  describe '#write_concern' do
+
+    let(:concern) { client.write_concern }
+
+    context 'when no option was provided to the client' do
+
+      let(:client) { described_class.new(['127.0.0.1:27017'], :database => TEST_DB) }
+
+      it 'returns a acknowledged write concern' do
+        expect(concern.get_last_error).to eq(:getlasterror => 1, :w => 1)
+      end
+    end
+
+    context 'when an option is provided' do
+
+      context 'when the option is acknowledged' do
+
+        let(:client) do
+          described_class.new(['127.0.0.1:27017'], :write => { :j => true }, :database => TEST_DB)
+        end
+
+        it 'returns a acknowledged write concern' do
+          expect(concern.get_last_error).to eq(:getlasterror => 1, :j => true)
+        end
+      end
+
+      context 'when the option is unacknowledged' do
+
+        context 'when the w is 0' do
+
+          let(:client) do
+            described_class.new(['127.0.0.1:27017'], :write => { :w => 0 }, :database => TEST_DB)
+          end
+
+          it 'returns an unacknowledged write concern' do
+            expect(concern.get_last_error).to be_nil
+          end
+        end
+
+        context 'when the w is -1' do
+
+          let(:client) do
+            described_class.new(['127.0.0.1:27017'], :write => { :w => -1 }, :database => TEST_DB)
+          end
+
+          it 'returns an unacknowledged write concern' do
+            expect(concern.get_last_error).to be_nil
+          end
+        end
+      end
+    end
+  end
+end