contactually-ruby 0.0.2

data/spec/api_spec.rb

@@ -0,0 +1,125 @@
+require 'spec_helper'
+
+describe Contactually::API do
+
+  describe 'missing configuration' do
+    before(:all) { Contactually.configure { |c| c.access_token = nil } }
+    specify do
+      expect{ subject }.to raise_error Contactually::ConfigMissingApiKeyError
+    end
+
+    it 'allows to supply api key via initialize' do
+      expect{ described_class.new('asdf') }.not_to raise_error
+    end
+
+    it 'sets access_token from parameters' do
+      expect(described_class.new('asdf').instance_variable_get(:@access_token)).to eq 'asdf'
+    end
+  end
+
+  describe 'valid configuration' do
+    before(:all) { Contactually.configure { |c| c.access_token = 'VALID_ACCESS_TOKEN' } }
+
+    describe '#initialize' do
+      it 'initializes correctly' do
+        expect{ subject }.not_to raise_error
+        expect(subject).to be_kind_of Contactually::API
+      end
+
+      it 'sets instance variables' do
+        expect(subject.instance_variable_get(:@access_token)).to eq 'VALID_ACCESS_TOKEN'
+        expect(subject.instance_variable_get(:@base_url)).to eq Contactually.contactually_url
+      end
+    end
+
+    describe '#call' do
+      it 'redirects get request to get' do
+        allow(subject).to receive(:get).and_return(Struct.new(:status, :body).new(200, {}))
+        subject.call('bla', :get, {})
+        expect(subject).to have_received(:get).with('bla', {})
+      end
+
+      it 'redirects post request to post' do
+        allow(subject).to receive(:post).and_return(Struct.new(:status, :body).new(200, {}))
+        subject.call('bla', :post, {})
+        expect(subject).to have_received(:post).with('bla', {})
+      end
+    end
+
+    describe '#call_params' do
+      specify do
+        expect(subject.send(:call_params, { foo: :bar })).to eql({ access_token: 'VALID_ACCESS_TOKEN', foo: :bar })
+      end
+    end
+
+    describe '#base_url' do
+      specify do
+        expect(subject.send(:base_url, 'foo/bar')).to eql("#{Contactually.contactually_url}foo/bar")
+      end
+    end
+
+    describe '#accounts' do
+      specify do
+        expect(subject.accounts).to be_kind_of Contactually::Accounts
+      end
+    end
+
+    describe '#contact_groupings' do
+      specify do
+        expect(subject.contact_groupings).to be_kind_of Contactually::ContactGroupings
+      end
+    end
+
+    describe '#contacts' do
+      specify do
+        expect(subject.contacts).to be_kind_of Contactually::Contacts
+      end
+    end
+
+    describe '#contents' do
+      specify do
+        expect(subject.contents).to be_kind_of Contactually::Contents
+      end
+    end
+
+    describe '#groupings' do
+      specify do
+        expect(subject.groupings).to be_kind_of Contactually::Groupings
+      end
+    end
+
+    describe '#notes' do
+      specify do
+        expect(subject.notes).to be_kind_of Contactually::Notes
+      end
+    end
+
+    describe '#tasks' do
+      specify do
+        expect(subject.tasks).to be_kind_of Contactually::Tasks
+      end
+    end
+
+    describe 'endpoints' do
+      %w{ accounts contact_groupings contacts contents groupings notes tasks }.each do |endpoint|
+        specify { expect(subject.respond_to?(endpoint)).to eq true }
+      end
+    end
+
+    describe '#get' do
+      it 'parses from json response' do
+        allow(subject.connection).to receive(:get).
+          with('https://api.contactually.com/v2/url', { foo: :bar, access_token: 'VALID_ACCESS_TOKEN' }).
+          and_return(Struct.new(:status, :body).new(200, "{ \"foo\": \"bar\" }"))
+        expect(subject.call('url', :get, { foo: :bar })).to be_kind_of Hash
+      end
+    end
+
+    describe '#post' do
+      it 'parses from json response' do
+        allow(subject.connection).to receive(:post).and_return(Struct.new(:status, :body).new(200, "{ \"foo\": \"bar\" }"))
+        expect(subject.call('url', :post, { foo: :bar })).to be_kind_of Hash
+      end
+    end
+  end
+end

data/spec/buckets_spec.rb

@@ -0,0 +1,97 @@
+require 'spec_helper'
+
+describe Contactually::Buckets do
+
+  let(:bucket_json) { File.read(File.join(File.dirname(__FILE__),"fixtures/bucket.json")) }
+  let(:bucket_index_json) { File.read(File.join(File.dirname(__FILE__),"fixtures/buckets_index.json")) }
+
+  before(:all) do
+    Contactually.configure { |c| c.access_token = 'VALID_ACCESS_TOKEN' }
+    @master = Contactually::API.new
+  end
+
+  subject { described_class.new @master }
+  describe '#initialize' do
+    specify do
+      expect(subject).to be_kind_of Contactually::Buckets
+    end
+
+    specify do
+      expect(subject.instance_variable_get(:@master)).to be_kind_of Contactually::API
+    end
+  end
+
+  describe '#create' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('buckets.json', :post, { bucket: { foo: :bar }}).and_return(JSON.load(bucket_json))
+      subject.create({ bucket: { foo: :bar }})
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a bucket' do
+      allow(@master).to receive(:call).with('buckets.json', :post, { bucket: { foo: :bar }}).and_return(JSON.load(bucket_json))
+      expect(subject.create({ bucket: { foo: :bar } })).to be_kind_of Contactually::Bucket
+    end
+  end
+
+  describe '#destroy' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('buckets/1.json', :delete, {})
+      subject.destroy(1)
+      expect(@master).to have_received(:call)
+    end
+  end
+
+  describe '#show' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('buckets/1.json', :get, { foo: :bar }).and_return({ id: 1 })
+      subject.show(1, { foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a bucket' do
+      allow(@master).to receive(:call).with('buckets/1.json', :get, { foo: :bar }).and_return(JSON.load(bucket_json))
+      expect(subject.show(1, { foo: :bar })).to be_kind_of Contactually::Bucket
+    end
+  end
+
+  describe '#update' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('buckets/1.json', :put, { bucket: { foo: :bar }}).and_return(JSON.load(bucket_json))
+      subject.update(1, { bucket: { foo: :bar } })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a bucket from json response' do
+      allow(@master).to receive(:call).with('buckets/1.json', :put, { bucket: { foo: :bar }}).and_return(JSON.load(bucket_json))
+      expect(subject.update(1, bucket: { foo: :bar })).to be_kind_of Contactually::Bucket
+    end
+  end
+
+  describe '#index' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('buckets.json', :get, { foo: :bar }).and_return({ 'data' => [] })
+      subject.index({ foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns buckets from json response' do
+      allow(@master).to receive(:call).with('buckets.json', :get, {}).and_return(JSON.load(bucket_index_json))
+      expect(subject.index({})).to be_kind_of Array
+      expect(subject.index({})[0]).to be_kind_of Contactually::Bucket
+    end
+  end
+
+  describe '#count' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('buckets.json', :get, { limit: 1 }).and_return({ 'data' => [], 'meta' => {'total' => 120 }})
+      subject.count()
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns total count' do
+      allow(@master).to receive(:call).with('buckets.json', :get, { limit: 1 }).and_return({ 'data' => [], 'meta' => {'total' => 120 }})
+      expect(subject.count).to be 120
+    end
+  end
+end

data/spec/contact_groupings_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe Contactually::ContactGroupings do
+
+  let(:grouping_json) { File.read(File.join(File.dirname(__FILE__),"fixtures/grouping.json")) }
+
+  before(:all) do
+    Contactually.configure { |c| c.access_token = 'VALID_ACCESS_TOKEN' }
+    @master = Contactually::API.new
+  end
+
+  subject { described_class.new @master }
+  describe '#initialize' do
+    specify do
+      expect(subject).to be_kind_of Contactually::ContactGroupings
+    end
+
+    specify do
+      expect(subject.instance_variable_get(:@master)).to be_kind_of Contactually::API
+    end
+  end
+
+
+  describe '#create' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts/1/groupings.json', :post, { grouping_id: 512 }).and_return({ 'id' => 1234 })
+      subject.create(1, { grouping_id: 512 })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns grouping from json response' do
+      allow(@master).to receive(:call).with('contacts/1/groupings.json', :post, { grouping_id: 512 }).and_return(JSON.load(grouping_json))
+      expect(subject.create(1, { grouping_id: 512 })).to be_kind_of Contactually::Grouping
+    end
+  end
+
+  describe '#destroy' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts/1/groupings/15.json', :delete, { foo: :bar }).and_return({ 'success' => true })
+      subject.destroy(1, 15, { foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+  end
+end

data/spec/contacts_spec.rb

@@ -0,0 +1,133 @@
+require 'spec_helper'
+
+describe Contactually::Contacts do
+
+  let(:contact_json) { File.read(File.join(File.dirname(__FILE__),"fixtures/contact.json")) }
+  let(:contacts_index_json) { File.read(File.join(File.dirname(__FILE__),"fixtures/contacts_index.json")) }
+
+  before(:all) do
+    Contactually.configure { |c| c.access_token = 'VALID_ACCESS_TOKEN' }
+    @master = Contactually::API.new
+  end
+
+  subject { described_class.new @master }
+  describe '#initialize' do
+    specify do
+      expect(subject).to be_kind_of Contactually::Contacts
+    end
+
+    specify do
+      expect(subject.instance_variable_get(:@master)).to be_kind_of Contactually::API
+    end
+  end
+
+  describe '#create' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts.json', :post, { contact: { foo: :bar }}).and_return(JSON.load(contact_json))
+      subject.create({ contact: { foo: :bar }})
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a contact' do
+      allow(@master).to receive(:call).with('contacts.json', :post, { contact: { foo: :bar }}).and_return(JSON.load(contact_json))
+      expect(subject.create({ contact: { foo: :bar } })).to be_kind_of Contactually::Contact
+    end
+  end
+
+  describe '#destroy' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts/1.json', :delete, {})
+      subject.destroy(1)
+      expect(@master).to have_received(:call)
+    end
+  end
+
+  describe '#destroy_multiple' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts.json', :delete, { ids: [ 1, 2, 3 ]})
+      subject.destroy_multiple({ ids: [ 1, 2, 3 ]})
+      expect(@master).to have_received(:call)
+    end
+  end
+
+  describe '#show' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts/1.json', :get, { foo: :bar }).and_return({ id: 1 })
+      subject.show(1, { foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a contact' do
+      allow(@master).to receive(:call).with('contacts/1.json', :get, { foo: :bar }).and_return(JSON.load(contact_json))
+      expect(subject.show(1, { foo: :bar })).to be_kind_of Contactually::Contact
+    end
+  end
+
+  describe '#tags' do
+    it 'calls the api with correct params - Array' do
+      allow(@master).to receive(:call).with('contacts/1/tags.json', :post, { tags: 'lol, haha' })
+      subject.tags(1, { tags: [ 'lol', 'haha' ]})
+      expect(@master).to have_received(:call)
+    end
+
+    it 'calls the api with correct params - String' do
+      allow(@master).to receive(:call).with('contacts/1/tags.json', :post, { tags: 'lol, haha' })
+      subject.tags(1, { tags: 'lol, haha' })
+      expect(@master).to have_received(:call)
+    end
+  end
+
+  describe '#update' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts/1.json', :put, { contact: { foo: :bar }}).and_return(JSON.load(contact_json))
+      subject.update(1, { contact: { foo: :bar } })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a contact from json response' do
+      allow(@master).to receive(:call).with('contacts/1.json', :put, { contact: { foo: :bar }}).and_return(JSON.load(contact_json))
+      expect(subject.update(1, { contact: { foo: :bar }})).to be_kind_of Contactually::Contact
+    end
+  end
+
+  describe '#index' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts.json', :get, { foo: :bar }).and_return({ 'data' => [] })
+      subject.index({ foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns contacts from json response' do
+      allow(@master).to receive(:call).with('contacts.json', :get, {}).and_return(JSON.load(contacts_index_json))
+      expect(subject.index({})).to be_kind_of Array
+      expect(subject.index({})[0]).to be_kind_of Contactually::Contact
+    end
+  end
+
+  describe '#search' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts/search.json', :get, { term: :foo_bar }).and_return({ 'data' => [] })
+      subject.search({ term: :foo_bar})
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns contacts from json response' do
+      allow(@master).to receive(:call).with('contacts/search.json', :get, { term: :foo_bar }).and_return(JSON.load(contacts_index_json))
+      expect(subject.search({ term: :foo_bar })).to be_kind_of Array
+      expect(subject.search({ term: :foo_bar })[0]).to be_kind_of Contactually::Contact
+    end
+  end
+
+  describe '#count' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contacts.json', :get, { limit: 1 }).and_return({ 'data' => [], 'total_count' => 120 })
+      subject.count()
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns total count' do
+      allow(@master).to receive(:call).with('contacts.json', :get, { limit: 1 }).and_return({ 'data' => [], 'total_count' => 120 })
+      expect(subject.count).to be 120
+    end
+  end
+end

data/spec/contents_spec.rb

@@ -0,0 +1,80 @@
+require 'spec_helper'
+
+describe Contactually::Contents do
+
+  let(:content_json) { File.read(File.join(File.dirname(__FILE__),"fixtures/content.json")) }
+  let(:contents_index_json) { File.read(File.join(File.dirname(__FILE__),"fixtures/contents_index.json")) }
+
+  before(:all) do
+    Contactually.configure { |c| c.access_token = 'VALID_ACCESS_TOKEN' }
+    @master = Contactually::API.new
+  end
+
+  subject { described_class.new @master }
+  describe '#initialize' do
+    specify do
+      expect(subject).to be_kind_of Contactually::Contents
+    end
+
+    specify do
+      expect(subject.instance_variable_get(:@master)).to be_kind_of Contactually::API
+    end
+  end
+
+  describe '#create' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contents.json', :post, { content: { foo: :bar }}).and_return(JSON.load(content_json))
+      subject.create({ content: { foo: :bar }})
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a content' do
+      allow(@master).to receive(:call).with('contents.json', :post, { content: { foo: :bar }}).and_return(JSON.load(content_json))
+      expect(subject.create({ content: { foo: :bar }})).to be_kind_of Contactually::Content
+    end
+  end
+
+  describe '#index' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contents.json', :get, { foo: :bar }).and_return({ 'data' => [] })
+      subject.index({ foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns contents from json response' do
+      allow(@master).to receive(:call).with('contents.json', :get, {}).and_return(JSON.load(contents_index_json))
+      expect(subject.index({})).to be_kind_of Array
+      expect(subject.index({})[0]).to be_kind_of Contactually::Content
+    end
+  end
+
+  describe '#destroy' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contents/115.json', :delete, { foo: :bar }).and_return({ 'success' => true })
+      subject.destroy(115, { foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+  end
+
+  describe '#show' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contents/1.json', :get, { foo: :bar }).and_return({ id: 1 })
+      subject.show(1, { foo: :bar })
+      expect(@master).to have_received(:call)
+    end
+
+    it 'returns a contact' do
+      allow(@master).to receive(:call).with('contents/1.json', :get, { foo: :bar }).and_return(JSON.load(content_json))
+      expect(subject.show(1, { foo: :bar })).to be_kind_of Contactually::Content
+    end
+  end
+
+  describe '#update' do
+    it 'calls the api with correct params' do
+      allow(@master).to receive(:call).with('contents/1.json', :put, { content: { foo: :bar }})
+      subject.update(1, { content: { foo: :bar } })
+      expect(@master).to have_received(:call)
+    end
+  end
+
+end