rsbe-client 0.5.0

data/spec/fixtures/partners/partners_all.json

@@ -0,0 +1 @@
+[{"id":"8c32791e-0fcd-4508-86e0-6fd28ee4550d","code":"afc","name":"Avery Fisher Center","created_at":"2014-09-25T19:40:05.076Z","updated_at":"2014-09-25T19:40:05.076Z","url":"http://localhost:3000/api/v0/partners/8c32791e-0fcd-4508-86e0-6fd28ee4550d"},{"id":"2215c154-479a-433e-9dcd-b04eef8dedfa","code":"apa","name":"Asian/Pacific/American Institute","created_at":"2014-09-25T19:40:06.315Z","updated_at":"2014-09-25T19:40:06.315Z","url":"http://localhost:3000/api/v0/partners/2215c154-479a-433e-9dcd-b04eef8dedfa"},{"id":"66f3af3c-9a0d-43d4-8dcf-9cf3189bc84e","code":"bobst","name":"New York University Bobst Library","created_at":"2014-09-25T19:40:06.581Z","updated_at":"2014-09-25T19:40:06.581Z","url":"http://localhost:3000/api/v0/partners/66f3af3c-9a0d-43d4-8dcf-9cf3189bc84e"},{"id":"c6512a7e-8e95-4857-966b-c25cffb864f4","code":"brill","name":"Koninklijke Brill NV","created_at":"2014-09-25T19:40:06.803Z","updated_at":"2014-09-25T19:40:06.803Z","url":"http://localhost:3000/api/v0/partners/c6512a7e-8e95-4857-966b-c25cffb864f4"},{"id":"1610d763-a788-42fe-996a-f8717403e7e3","code":"columbia","name":"Columbia University Libraries","created_at":"2014-09-25T19:40:07.027Z","updated_at":"2014-09-25T19:40:07.027Z","url":"http://localhost:3000/api/v0/partners/1610d763-a788-42fe-996a-f8717403e7e3"},{"id":"bd48bc64-0ba6-4d28-8b7e-cfe444fc65ba","code":"cornell","name":"Cornell University Libraries","created_at":"2014-09-25T19:40:07.246Z","updated_at":"2014-09-25T19:40:07.246Z","url":"http://localhost:3000/api/v0/partners/bd48bc64-0ba6-4d28-8b7e-cfe444fc65ba"},{"id":"e6517775-6277-4e25-9373-ee7738e820b5","code":"dlts","name":"New York University Digital Library Technology Services","created_at":"2014-09-25T19:40:07.524Z","updated_at":"2014-09-25T19:40:07.524Z","url":"http://localhost:3000/api/v0/partners/e6517775-6277-4e25-9373-ee7738e820b5"},{"id":"2f096796-c685-444f-a4fe-5971346b159d","code":"fales","name":"The Fales Library \u0026 Special Collections","created_at":"2014-09-25T19:40:07.762Z","updated_at":"2014-09-25T19:40:07.762Z","url":"http://localhost:3000/api/v0/partners/2f096796-c685-444f-a4fe-5971346b159d"},{"id":"c263d631-6cc5-42e9-8070-00ecfa4915b5","code":"ifa","name":"Institute of Fine Arts","created_at":"2014-09-25T19:40:07.986Z","updated_at":"2014-09-25T19:40:07.986Z","url":"http://localhost:3000/api/v0/partners/c263d631-6cc5-42e9-8070-00ecfa4915b5"},{"id":"12b75a91-081d-414b-82cb-c347d0bbf0e0","code":"isaw","name":"Institute for the Study of the Ancient World","created_at":"2014-09-25T19:40:08.237Z","updated_at":"2014-09-25T19:40:08.237Z","url":"http://localhost:3000/api/v0/partners/12b75a91-081d-414b-82cb-c347d0bbf0e0"},{"id":"4200a155-38a2-494f-ad56-c32a03382570","code":"nyu","name":"New York University Libraries","created_at":"2014-09-25T19:40:08.461Z","updated_at":"2014-09-25T19:40:08.461Z","url":"http://localhost:3000/api/v0/partners/4200a155-38a2-494f-ad56-c32a03382570"},{"id":"a2ab971f-ce12-4799-96a3-d550207e2f54","code":"nyuad","name":"New York University Libraries - Abu Dhabi","created_at":"2014-09-25T19:40:08.687Z","updated_at":"2014-09-25T19:40:08.687Z","url":"http://localhost:3000/api/v0/partners/a2ab971f-ce12-4799-96a3-d550207e2f54"},{"id":"01dcf840-93bf-4184-8ebe-b9ec3261015e","code":"nyuarchives","name":"New York University Archives","created_at":"2014-09-25T19:40:08.910Z","updated_at":"2014-09-25T19:40:08.910Z","url":"http://localhost:3000/api/v0/partners/01dcf840-93bf-4184-8ebe-b9ec3261015e"},{"id":"d95dd72c-9d28-411b-95be-0d3831464eea","code":"nyuhsl","name":"New York University Health Sciences Library","created_at":"2014-09-25T19:40:09.132Z","updated_at":"2014-09-25T19:40:09.132Z","url":"http://localhost:3000/api/v0/partners/d95dd72c-9d28-411b-95be-0d3831464eea"},{"id":"73cc4a72-b59f-4d54-b393-87353a3332df","code":"nyup","name":"New York University Press","created_at":"2014-09-25T19:40:09.354Z","updated_at":"2014-09-25T19:40:09.354Z","url":"http://localhost:3000/api/v0/partners/73cc4a72-b59f-4d54-b393-87353a3332df"},{"id":"bfd9ea9a-66ee-4d0c-95b2-e9b54f883cb5","code":"nyupoly","name":"New York University Polytechnic Archives","created_at":"2014-09-25T19:40:09.576Z","updated_at":"2014-09-25T19:40:09.576Z","url":"http://localhost:3000/api/v0/partners/bfd9ea9a-66ee-4d0c-95b2-e9b54f883cb5"},{"id":"acb3cd77-9408-4135-93e7-9b7d105f4c68","code":"pres","name":"Barbara Goldsmith Preservation and Conservation Department","created_at":"2014-09-25T19:40:09.795Z","updated_at":"2014-09-25T19:40:09.795Z","url":"http://localhost:3000/api/v0/partners/acb3cd77-9408-4135-93e7-9b7d105f4c68"},{"id":"062309d0-5a8a-46dd-8783-60e62f8cf1a5","code":"princeton","name":"Princeton University Libraries","created_at":"2014-09-25T19:40:10.019Z","updated_at":"2014-09-25T19:40:10.019Z","url":"http://localhost:3000/api/v0/partners/062309d0-5a8a-46dd-8783-60e62f8cf1a5"},{"id":"95b6d056-9026-4436-b3a9-4fad9a7a927f","code":"tamwag","name":"The Tamiment Library and Robert F. Wagner Labor Archives","created_at":"2014-09-25T19:40:10.274Z","updated_at":"2014-09-25T19:40:10.274Z","url":"http://localhost:3000/api/v0/partners/95b6d056-9026-4436-b3a9-4fad9a7a927f"}]

data/spec/fixtures/partners/partners_none.json

@@ -0,0 +1 @@
+[]

data/spec/rsbe/client/base_spec.rb

@@ -0,0 +1,10 @@
+describe Rsbe::Client::Base do
+  context "when created" do
+    subject { Rsbe::Client::Base.new }
+    it      { should be_a(Rsbe::Client::Base) }
+  end
+  describe ".base_path" do
+    subject { Rsbe::Client::Base }
+    its(:base_path) { should == '/api/v0' }
+  end
+end

data/spec/rsbe/client/collection_spec.rb

@@ -0,0 +1,186 @@
+describe Rsbe::Client::Collection do
+
+  describe ".new" do
+    context "with valid attributes and symbol keys" do
+      subject { Rsbe::Client::Collection.new(code: 'boo', rel_path: 'b/o/o') }
+      it { should be_a(Rsbe::Client::Collection) }
+      its(:code)     { should eq 'boo' }
+      its(:rel_path) { should eq 'b/o/o' }
+    end
+    context "with valid attributes and string keys" do
+      subject { Rsbe::Client::Collection.new('code' => 'boo', 'rel_path' => 'b/o/o') }
+      it { should be_a(Rsbe::Client::Collection) }
+      its(:code)     { should eq 'boo' }
+      its(:rel_path) { should eq 'b/o/o' }
+    end
+    context "with incorrect argument type" do
+      subject { Rsbe::Client::Collection.new(42) }
+      it 'should raise an ArgumentError' do
+        expect { subject }.to raise_error ArgumentError
+      end
+    end
+  end
+
+  describe ".base_path" do
+    subject { Rsbe::Client::Collection }
+    its(:base_path) { should eq '/api/v0/colls' }
+  end
+
+  describe ".all" do
+    subject { Rsbe::Client::Collection.all }
+    it 'should raise a MethodNotImplementedError' do
+      expect { subject }.to raise_error Rsbe::Client::MethodNotImplementedError
+    end
+  end
+
+  describe ".find" do
+    context "with id of existing Collection", vcr: {cassette_name: 'collection/find-existing'} do
+      subject { Rsbe::Client::Collection.find('fc7455cf-3b20-494c-9b9e-17cae9e51fa1') }
+      its(:class) { should eq Rsbe::Client::Collection }
+      its(:id)    { should eq 'fc7455cf-3b20-494c-9b9e-17cae9e51fa1' }
+      its(:code)  { should eq 'zaap' }
+    end
+
+    context "with non-existent id", vcr: {cassette_name: 'collection/find-non_existent'} do
+      subject { Rsbe::Client::Collection.find('bad45d46-a14a-489f-97ac-384afb552a13') }
+      it 'should raise an Rsbe::Client::RecordNotFound' do
+        expect { subject }.to raise_error Rsbe::Client::RecordNotFound
+      end
+    end
+  end
+
+  describe "#save" do
+    context "when creating a new Collection" do
+      context "with valid attributes" do
+        # TODO: implment FactoryGirl
+        context "and no id", vcr: {cassette_name: 'collection/save-create-unknown-id'} do
+          let(:partner_id) { "5c902ffa-b2d9-4b8a-bac6-6ec8cfb50baa" }
+          let(:code) { 'luke' }
+          let(:quota) { 1024 }
+          let(:name)  { 'Lasers Under Kinetic Ether' }
+          let(:coll_type) { 'origin' }
+          let(:collection) { Rsbe::Client::Collection.new(partner_id: partner_id,
+                                                          code:  code,
+                                                          quota: quota,
+                                                          name:  name,
+                                                          coll_type: coll_type) }
+          subject { collection }
+          its(:save) { should eq true }
+
+          context "after save" do
+            before { collection.save }
+            its(:id)         { should_not be_nil }
+            its(:partner_id) { should eq '5c902ffa-b2d9-4b8a-bac6-6ec8cfb50baa' }
+            its(:code)       { should eq code    }
+            its(:quota)      { should eq quota   }
+            its(:name)       { should eq name    }
+            its(:created_at) { should_not be_nil }
+            its(:updated_at) { should_not be_nil }
+          end
+        end
+
+        context "and a known id", vcr: {cassette_name: 'collection/save-create-known-id'} do
+          let(:collection) do
+            Rsbe::Client::Collection.new(id:         '07998216-af0a-4262-b7f9-6a7d9c4aeae4',
+                                         partner_id: '5c902ffa-b2d9-4b8a-bac6-6ec8cfb50baa',
+                                         code:       'han',
+                                         name:       'Happy Anteaters of Nigeria',
+                                         quota:      123,
+                                         coll_type:  'origin')
+          end
+          subject { collection }
+          its(:save) { should eq true }
+
+          context "after save" do
+            before { collection.save }
+            its(:id)         { should eq '07998216-af0a-4262-b7f9-6a7d9c4aeae4' }
+            its(:partner_id) { should eq '5c902ffa-b2d9-4b8a-bac6-6ec8cfb50baa' }
+            its(:code)       { should eq 'han'   }
+            its(:name)       { should eq 'Happy Anteaters of Nigeria' }
+            its(:quota)      { should eq 123 }
+            its(:created_at) { should_not be_nil }
+            its(:updated_at) { should_not be_nil }
+          end
+        end
+      end
+      context "with invalid attributes", vcr: {cassette_name: 'collection/save-invalid'} do
+        let(:collection) do
+          Rsbe::Client::Collection.new(partner_id: '5c902ffa-b2d9-4b8a-bac6-6ec8cfb50baa',
+                                       coll_type:  'banana frappe')
+        end
+        subject { collection }
+        its(:save) { should eq false }
+      end
+    end
+    context "when updating a Collection" do
+      context "with valid attributes", vcr: {cassette_name: 'collection/save-update-valid'} do
+        let(:collection) { Rsbe::Client::Collection.find('07998216-af0a-4262-b7f9-6a7d9c4aeae4') }
+        subject { collection }
+        context "before save-as-update" do
+          its(:id)         { should eq '07998216-af0a-4262-b7f9-6a7d9c4aeae4' }
+          its(:code)       { should eq 'han'  }
+          its(:name)       { should eq 'Happy Anteaters of Nigeria' }
+          its(:created_at) { should_not be_nil }
+          its(:updated_at) { should_not be_nil }
+        end
+        context "on save-as-update" do
+          before do
+            collection.name = 'Last Emu In Australia'
+            collection.code = 'leia'
+          end
+          its(:save) { should eq true }
+          context "after save" do
+            its(:id)         { should eq '07998216-af0a-4262-b7f9-6a7d9c4aeae4' }
+            its(:code)       { should eq 'leia'  }
+            its(:name)       { should eq 'Last Emu In Australia' }
+            its(:created_at) { should_not be_nil }
+            its(:updated_at) { should_not be_nil }
+          end
+        end
+      end
+    end
+  end
+  describe "lazy evaluation" do
+    context "when Collection exists, but is populated with minimal attributes", vcr: {cassette_name: 'collection/lazy-eval-exists'} do
+      let(:collection) { Rsbe::Client::Collection.new(id: 'fc7455cf-3b20-494c-9b9e-17cae9e51fa1') }
+      it "should return values for all attributes" do
+        expect(collection.code).to eq 'zaap'
+        expect(collection.name).to eq 'Zoinks and Away, Potatoes!'
+        expect(collection.quota).to eq 500
+        expect(collection.coll_type).to eq 'origin'
+        expect(collection.lock_version).not_to be_nil
+        expect(collection.created_at).not_to be_nil
+        expect(collection.updated_at).not_to be_nil
+      end
+    end
+    context "when Collection does not exist in RSBE and does not have an id" do
+      let(:collection) { Rsbe::Client::Collection.new }
+      it "should return nil for all attributes" do
+        expect(collection.id).to be_nil
+        expect(collection.code).to be_nil
+        expect(collection.name).to be_nil
+        expect(collection.quota).to be_nil
+        expect(collection.coll_type).to be_nil
+        expect(collection.lock_version).to be_nil
+        expect(collection.created_at).to be_nil
+        expect(collection.updated_at).to be_nil
+      end
+    end
+    context "when Collection does not exist in RSBE but has an id", vcr: {cassette_name: 'collection/lazy-eval-dne'} do
+      let(:collection) do
+        Rsbe::Client::Collection.new(id: '7c7afee8-c8be-43bf-8096-c03672aaf114',
+                                     code: 'flippers')
+      end
+      it "should return values for defined attributes" do
+        expect(collection.id).to eq '7c7afee8-c8be-43bf-8096-c03672aaf114'
+        expect(collection.code).to eq 'flippers'
+        expect(collection.name).to be_nil
+        expect(collection.quota).to be_nil
+        expect(collection.coll_type).to be_nil
+        expect(collection.lock_version).to be_nil
+        expect(collection.created_at).to be_nil
+        expect(collection.updated_at).to be_nil
+      end
+    end
+  end
+end

data/spec/rsbe/client/connection_spec.rb

@@ -0,0 +1,20 @@
+describe Rsbe::Client::Connection do
+  let(:same_origin_url) { 'http://localhost:3000/api/v0/partners/2f096796-c685-444f-a4fe-5971346b159d' }
+  let(:different_origin_url) { 'http://localhost:3001/api/v0/partners/2f096796-c685-444f-a4fe-5971346b159d' }
+
+  context "when created" do
+    subject { Rsbe::Client::Connection.new }
+    it { should be_a(Rsbe::Client::Connection) }
+  end
+
+  describe "same_origin?" do
+    context "with a  url from the same origin" do
+      subject { Rsbe::Client::Connection.new.same_origin?(same_origin_url) }
+      it { should == true }
+    end
+    context "with a  url from a different origin" do
+      subject { Rsbe::Client::Connection.new.same_origin?(different_origin_url) }
+      it { should == false }
+    end
+  end
+end

data/spec/rsbe/client/partner_spec.rb

@@ -0,0 +1,185 @@
+describe Rsbe::Client::Partner do
+
+  describe ".new" do
+    context "with valid attributes and symbol keys" do
+      subject { Rsbe::Client::Partner.new(code: 'foo', rel_path: 'f/o/o') }
+      it { should be_a(Rsbe::Client::Partner) }
+      its(:code)     { should eq 'foo' }
+      its(:rel_path) { should eq 'f/o/o' }
+    end
+    context "with valid attributes and string keys" do
+      subject { Rsbe::Client::Partner.new('code' => 'foo', 'rel_path' => 'f/o/o') }
+      it { should be_a(Rsbe::Client::Partner) }
+      its(:code)     { should eq 'foo' }
+      its(:rel_path) { should eq 'f/o/o' }
+    end
+    context "with incorrect argument type" do
+      subject { Rsbe::Client::Partner.new(42) }
+      it 'should raise an ArgumentError' do
+        expect { subject }.to raise_error ArgumentError
+      end
+    end
+  end
+  describe ".base_path" do
+    subject { Rsbe::Client::Partner }
+    its(:base_path) { should eq '/api/v0/partners' }
+  end
+  describe ".all", vcr: { cassette_name: 'partner/all' } do
+    context "returned array" do
+      subject { Rsbe::Client::Partner.all }
+      it         { should be_a(Array) }
+      its(:size) { should eq 4 }
+    end
+    context "returned array element" do
+      subject { Rsbe::Client::Partner.all[0] }
+      it { should be_a(Rsbe::Client::Partner) }
+    end
+  end
+
+  describe ".find" do
+    context "with id of existing Partner", vcr: { cassette_name: 'partner/find-existing' } do
+      subject { Rsbe::Client::Partner.find('b110731f-86af-4534-8e58-6d219dcb1c52') }
+      its(:class) { should eq Rsbe::Client::Partner }
+      its(:id)    { should eq 'b110731f-86af-4534-8e58-6d219dcb1c52' }
+      its(:code)  { should eq 'quux' }
+    end
+
+    context "with non-existant id", vcr: { cassette_name: 'partner/find-non_existent' } do
+      subject { Rsbe::Client::Partner.find('bad45d46-a14a-489f-97ac-384afb552a13') }
+      it 'should raise an Rsbe::Client::RecordNotFound' do
+        expect { subject }.to raise_error Rsbe::Client::RecordNotFound
+      end
+    end
+  end
+
+  describe "#save" do
+    context "when creating a new Partner" do
+      context "with valid attributes" do
+        context "and no id", vcr: { cassette_name: 'partner/save-create-unknown-id' } do
+          let(:partner) { Rsbe::Client::Partner.new(code: 'foo', rel_path: 'f/o/o') }
+          subject { partner }
+          its(:save) { should eq true }
+
+          context "after save" do
+            before { partner.save }
+            its(:id)         { should_not be_nil }
+            its(:code)       { should eq 'foo'   }
+            its(:created_at) { should_not be_nil }
+            its(:updated_at) { should_not be_nil }
+          end
+        end
+
+        context "and a known id", vcr: {cassette_name: 'partner/save-create-known-id'} do
+          let(:partner) do
+            Rsbe::Client::Partner.new(id: '51213be7-c8de-4e06-8cc2-06bfc82cdd68',
+                                      code: 'bar',
+                                      rel_path: 'b/a/r')
+          end
+          subject { partner }
+          its(:save) { should eq true }
+
+          context "after save" do
+            before { partner.save }
+            its(:id)         { should eq '51213be7-c8de-4e06-8cc2-06bfc82cdd68' }
+            its(:code)       { should eq 'bar'   }
+            its(:created_at) { should_not be_nil }
+            its(:updated_at) { should_not be_nil }
+          end
+        end
+      end
+
+      context "with invalid attributes", vcr: {cassette_name: 'partner/save-invalid'} do
+        let(:partner) { Rsbe::Client::Partner.new(id: 'abc123',
+                                                  code: 'baz a saurus',
+                                                  rel_path: 'b/a/z') }
+        subject { partner }
+        its(:save) { should eq false }
+      end
+    end
+    context "when updating a Partner" do
+      context "with valid attributes", vcr: {cassette_name: 'partner/save-update-valid'} do
+        let(:partner) { Rsbe::Client::Partner.find('b051f936-835c-4abb-9034-efa7508db4bf') }
+        subject { partner }
+        context "before save-as-update" do
+          its(:id)         { should eq 'b051f936-835c-4abb-9034-efa7508db4bf' }
+          its(:code)       { should eq 'onyx'  }
+          its(:name)       { should     be_nil }
+          its(:created_at) { should_not be_nil }
+          its(:updated_at) { should_not be_nil }
+        end
+
+        context "on save-as-update" do
+          before { partner.name = 'The Black Onyx Syndicate' }
+          its(:save) { should eq true }
+          context "after save" do
+            its(:id)         { should eq 'b051f936-835c-4abb-9034-efa7508db4bf' }
+            its(:code)       { should eq 'onyx'  }
+            its(:name)       { should eq 'The Black Onyx Syndicate' }
+            its(:created_at) { should_not be_nil }
+            its(:updated_at) { should_not be_nil }
+          end
+        end
+      end
+    end
+  end
+  describe "#collections" do
+    context "when Partner has some collections", vcr: {cassette_name: 'partner/with-collections'} do
+      let(:partner) { Rsbe::Client::Partner.find('5c902ffa-b2d9-4b8a-bac6-6ec8cfb50baa') }
+      let(:collections) { partner.collections }
+
+      it "should return an Array of Collections" do
+        expect(collections).to be_instance_of Array
+        expect(collections.first).to be_instance_of Rsbe::Client::Collection
+        expect(collections.length).to eq 2
+        expect(collections.first.code).to eq 'luke'
+      end
+    end
+    context "when Partner doesn't have any collections", vcr: {cassette_name: 'partner/without-collections'} do
+      let(:partner) { Rsbe::Client::Partner.find('51213be7-c8de-4e06-8cc2-06bfc82cdd68') }
+      let(:collections) { partner.collections }
+
+      it "should return an Array of Collections" do
+        expect(collections).to be_instance_of Array
+        expect(collections.length).to eq 0
+      end
+    end
+  end
+  describe "lazy evaluation" do
+    context "when Partner exists, but is populated with minimal attributes",  vcr: {cassette_name: 'partner/lazy-eval-exists'} do
+      let(:partner) { Rsbe::Client::Partner.new(id: 'b051f936-835c-4abb-9034-efa7508db4bf') }
+      it "should return values for all attributes" do
+        expect(partner.code).to eq 'onyx'
+        expect(partner.name).to eq 'The Black Onyx Syndicate'
+        expect(partner.rel_path).to eq 'o/n/y/x'
+        expect(partner.lock_version).not_to be_nil
+        expect(partner.created_at).not_to be_nil
+        expect(partner.updated_at).not_to be_nil
+      end
+    end
+    context "when Partner does not exist in RSBE and does not have an id" do
+      let(:partner) { Rsbe::Client::Partner.new }
+      it "should return values for all attributes" do
+        expect(partner.code).to be_nil
+        expect(partner.name).to be_nil
+        expect(partner.rel_path).to be_nil
+        expect(partner.lock_version).to be_nil
+        expect(partner.created_at).to be_nil
+        expect(partner.updated_at).to be_nil
+      end
+    end
+    context "when Partner does not exist in RSBE but has an id" do
+      let(:partner) do
+        Rsbe::Client::Partner.new(id: '7c7afee8-c8be-43bf-8096-c03672aaf114',
+                                  code: 'topaz')
+      end
+      it "should return values for defined attributes", vcr: {cassette_name: 'partner/dne-with-id'} do
+        expect(partner.code).to eq 'topaz'
+        expect(partner.name).to be_nil
+        expect(partner.rel_path).to be_nil
+        expect(partner.lock_version).to be_nil
+        expect(partner.created_at).to be_nil
+        expect(partner.updated_at).to be_nil
+      end
+    end
+  end
+end

data/spec/rsbe/client/provider_spec.rb

@@ -0,0 +1,122 @@
+describe Rsbe::Client::Provider do
+
+  describe ".new" do
+    let(:provider_name) { 'James T. Kirk' }
+    context "with valid attributes and symbol keys" do
+      subject { Rsbe::Client::Provider.new(name: provider_name) }
+      it { should be_a(Rsbe::Client::Provider) }
+      its(:name) { should eq provider_name }
+    end
+    context "with valid attributes and string keys" do
+      subject { Rsbe::Client::Provider.new('name' => provider_name) }
+      it { should be_a(Rsbe::Client::Provider) }
+      its(:name) { should eq provider_name }
+    end
+    context "with incorrect argument type" do
+      subject { Rsbe::Client::Provider.new(42) }
+      it 'should raise an ArgumentError' do
+        expect { subject }.to raise_error ArgumentError
+      end
+    end
+  end
+
+  describe ".base_path" do
+    subject { Rsbe::Client::Provider }
+    its(:base_path) { should eq '/api/v0/providers' }
+  end
+
+  describe ".all", vcr: {cassette_name: 'provider/all'} do
+    context "returned array" do
+      subject { Rsbe::Client::Provider.all }
+      it         { should be_a(Array) }
+      its(:size) { should eq 4 }
+    end
+    context "returned array element" do
+      subject { Rsbe::Client::Provider.all[0] }
+      it { should be_a(Rsbe::Client::Provider) }
+    end
+  end
+
+  describe ".find" do
+    context "with id of existing Provider", vcr: {cassette_name: 'provider/find-existing'} do
+      subject { Rsbe::Client::Provider.find('0938b200-e388-4626-bee8-69b3fc73ecdb') }
+      its(:class) { should eq Rsbe::Client::Provider }
+      its(:id)    { should eq '0938b200-e388-4626-bee8-69b3fc73ecdb' }
+      its(:name)  { should eq 'Portia' }
+    end
+
+    context "with non-existant id", vcr: {cassette_name: 'provider/find-non_existent'} do
+      subject { Rsbe::Client::Provider.find('bad45d46-a14a-489f-97ac-384afb552a13') }
+      it 'should raise an Rsbe::Client::RecordNotFound' do
+        expect { subject }.to raise_error Rsbe::Client::RecordNotFound
+      end
+    end
+  end
+
+  describe "#save" do
+    context "when creating a new Provider" do
+      context "with valid attributes" do
+        context "and no id", vcr: {cassette_name: 'provider/save-create-unknown-id'} do
+          let(:provider) { Rsbe::Client::Provider.new(name: 'Antony') }
+          subject { provider }
+          its(:save) { should eq true }
+
+          context "after save" do
+            before { provider.save }
+            its(:id)         { should_not be_nil  }
+            its(:name)       { should eq 'Antony' }
+            its(:created_at) { should_not be_nil  }
+            its(:updated_at) { should_not be_nil  }
+          end
+
+          context "and a known id", vcr: {cassette_name: 'provider/save-create-known-id'} do
+            let(:provider) do
+              Rsbe::Client::Provider.new(id:   '51213be7-c8de-4e06-8cc2-06bfc82cdd68',
+                                         name: 'Octavius')
+            end
+            subject { provider }
+            its(:save) { should eq true }
+            context "after save" do
+              before { provider.save }
+              its(:id)         { should eq '51213be7-c8de-4e06-8cc2-06bfc82cdd68' }
+              its(:name)       { should eq 'Octavius' }
+              its(:created_at) { should_not be_nil }
+              its(:updated_at) { should_not be_nil }
+            end
+          end
+        end
+      end
+
+      context "with invalid attributes", vcr: {cassette_name: 'provider/save-invalid'} do
+        let(:provider) { Rsbe::Client::Provider.new(id:   'abc123',
+                                                    name: '') }
+        subject { provider }
+        its(:save) { should eq false }
+      end
+    end
+
+    context "when updating a Provider" do
+      context "with valid attributes", vcr: {cassette_name: 'provider/save-update-valid'} do
+        let(:provider) { Rsbe::Client::Provider.find('51213be7-c8de-4e06-8cc2-06bfc82cdd68') }
+        subject { provider }
+        context "before save-as-update" do
+          its(:id)         { should eq '51213be7-c8de-4e06-8cc2-06bfc82cdd68' }
+          its(:name)       { should eq 'Octavius' }
+          its(:created_at) { should_not be_nil }
+          its(:updated_at) { should_not be_nil }
+        end
+
+        context "on save-as-update" do
+          before { provider.name = 'Calpurnia' }
+          its(:save) { should eq true }
+          context "after save" do
+            its(:id)         { should eq '51213be7-c8de-4e06-8cc2-06bfc82cdd68' }
+            its(:name)       { should eq 'Calpurnia' }
+            its(:created_at) { should_not be_nil }
+            its(:updated_at) { should_not be_nil }
+          end
+        end
+      end
+    end
+  end
+end