openstax_active_force 1.0.0

data/spec/active_force/association/relation_model_builder_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+module ActiveForce
+  module Association
+    describe RelationModelBuilder do
+      let(:instance){ described_class.new association, value }
+
+      describe '#build_relation_model' do
+        context 'has_many' do
+          let(:association){ HasManyAssociation.new Post, :comments }
+
+          context 'with values' do
+            let(:value) do
+              build_restforce_collection([
+                Restforce::SObject.new({'Id' => '213', 'PostId' => '123'}),
+                Restforce::SObject.new({'Id' => '214', 'PostId' => '123'})
+              ])
+            end
+
+            it 'returns an array of Comments' do
+              comments = instance.build_relation_model
+              expect(comments).to be_a Array
+              expect(comments.all?{ |c| c.is_a? Comment }).to be true
+            end
+          end
+
+          context 'without values' do
+            let(:value){ nil }
+
+            it 'returns an empty array' do
+              comments = instance.build_relation_model
+              expect(comments).to be_a Array
+              expect(comments).to be_empty
+            end
+          end
+        end
+
+        context 'belongs_to' do
+          let(:association){ BelongsToAssociation.new(Comment, :post) }
+
+          context 'with a value' do
+            let(:value) do
+              build_restforce_sobject 'Id' => '213'
+            end
+
+            it 'returns a post' do
+              expect(instance.build_relation_model).to be_a Post
+            end
+          end
+
+          context 'without a value' do
+            let(:value){ nil }
+
+            it 'returns nil' do
+              expect(instance.build_relation_model).to be_nil
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/active_force/association_spec.rb

@@ -0,0 +1,157 @@
+require 'spec_helper'
+
+describe ActiveForce::SObject do
+  let :post do
+    Post.new(id: "1", title: 'Ham')
+  end
+
+  let :comment do
+    Comment.new(id: "1", post_id: "1")
+  end
+
+  let :client do
+    double("sfdc_client", query: [Restforce::Mash.new("Id" => 1)])
+  end
+
+  before do
+    ActiveForce.sfdc_client = client
+  end
+
+  describe "has_many_query" do
+    it "should respond to relation method" do
+      expect(post).to respond_to(:comments)
+    end
+
+    it "should return a ActiveQuery object" do
+      expect(post.comments).to be_a ActiveForce::ActiveQuery
+    end
+
+    it 'makes only one API call to fetch the associated object' do
+      expect(client).to receive(:query).once
+      post.comments.to_a
+      post.comments.to_a
+    end
+
+    describe 'to_s' do
+      it "should return a SOQL statment" do
+        soql = "SELECT Id, PostId, PosterId__c, FancyPostId, Body__c FROM Comment__c WHERE (PostId = '1')"
+        expect(post.comments.to_s).to eq soql
+      end
+    end
+
+    context 'when the SObject is namespaced' do
+      let(:account){ Foo::Account.new(id: '1') }
+
+      it 'correctly infers the foreign key and forms the correct query' do
+        soql = "SELECT Id, AccountId, Partner_Account_Id__c FROM Opportunity WHERE (AccountId = '1')"
+        expect(account.opportunities.to_s).to eq soql
+      end
+
+      it 'uses an explicit foreign key if it is supplied' do
+        soql = "SELECT Id, AccountId, Partner_Account_Id__c FROM Opportunity WHERE (Partner_Account_Id__c = '1')"
+        expect(account.partner_opportunities.to_s).to eq soql
+      end
+    end
+  end
+
+  describe 'has_many(options)' do
+    it 'should allow to send a different query table name' do
+      soql = "SELECT Id, PostId, PosterId__c, FancyPostId, Body__c FROM Comment__c WHERE (PostId = '1')"
+      expect(post.ugly_comments.to_s).to eq soql
+    end
+
+    it 'should allow to change the foreign key' do
+      soql = "SELECT Id, PostId, PosterId__c, FancyPostId, Body__c FROM Comment__c WHERE (PosterId__c = '1')"
+      expect(post.poster_comments.to_s).to eq soql
+    end
+
+    it 'should allow to add a where condition' do
+      soql = "SELECT Id, PostId, PosterId__c, FancyPostId, Body__c FROM Comment__c WHERE (1 = 0) AND (PostId = '1')"
+      expect(post.impossible_comments.to_s).to eq soql
+    end
+
+    it 'accepts custom scoping' do
+      soql = "SELECT Id, PostId, PosterId__c, FancyPostId, Body__c FROM Comment__c WHERE (Body__c = 'RE: Ham') AND (PostId = '1') ORDER BY CreationDate DESC"
+      expect(post.reply_comments.to_s).to eq soql
+    end
+
+    it 'accepts custom scoping that preloads associations of the association' do
+      account = Salesforce::Account.new id: '1', business_partner: 'qwerty'
+      soql = "SELECT Id, OwnerId, AccountId, Business_Partner__c, Owner.Id FROM Opportunity WHERE (Business_Partner__c = 'qwerty') AND (AccountId = '1')"
+      expect(account.partner_opportunities.to_s).to eq soql
+    end
+
+    it 'should use a convention name for the foreign key' do
+      soql = "SELECT Id, PostId, PosterId__c, FancyPostId, Body__c FROM Comment__c WHERE (PostId = '1')"
+      expect(post.comments.to_s).to eq soql
+    end
+  end
+
+  describe "belongs_to" do
+    it "should get the resource it belongs to" do
+      expect(comment.post).to be_instance_of(Post)
+    end
+
+    it "should allow to pass a foreign key as options" do
+      Comment.belongs_to :post, foreign_key: :fancy_post_id
+      allow(comment).to receive(:fancy_post_id).and_return "2"
+      expect(client).to receive(:query).with("SELECT Id, Title__c FROM Post__c WHERE (Id = '2') LIMIT 1")
+      comment.post
+      Comment.belongs_to :post # reset association to original value
+    end
+
+    it 'makes only one API call to fetch the associated object' do
+      expect(client).to receive(:query).once
+      comment.post
+      comment.post
+    end
+
+    describe "assignments" do
+      let(:comment) do
+        comment = Comment.new(id: '1')
+        comment.post = Post.new(id: '1')
+        comment
+      end
+
+      before do
+        expect(client).to_not receive(:query)
+      end
+      
+      it 'accepts assignment of an existing object as an association' do
+        expect(client).to_not receive(:query)
+        other_post = Post.new(id: "2")
+        comment.post = other_post
+        expect(comment.post_id).to eq other_post.id
+        expect(comment.post).to eq other_post
+      end
+
+      it 'can desassociate an object by setting it as nil' do
+        comment.post = nil
+        expect(comment.post_id).to eq nil
+        expect(comment.post).to eq nil
+      end
+    end
+
+    context 'when the SObject is namespaced' do
+      let(:attachment){ Foo::Attachment.new(id: '1', lead_id: '2') }
+
+      it 'generates the correct query' do
+        expect(client).to receive(:query).with("SELECT Id FROM Lead WHERE (Id = '2') LIMIT 1")
+        attachment.lead
+      end
+
+      it 'instantiates the correct object' do
+        expect(attachment.lead).to be_instance_of(Foo::Lead)
+      end
+
+      context 'when given a foreign key' do
+        let(:attachment){ Foo::Attachment.new(id: '1', fancy_lead_id: '2') }
+
+        it 'generates the correct query' do
+          expect(client).to receive(:query).with("SELECT Id FROM Lead WHERE (Id = '2') LIMIT 1")
+          attachment.fancy_lead
+        end
+      end
+    end
+  end
+end

data/spec/active_force/attribute_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe ActiveForce::Attribute do
+  let(:attribute) { ActiveForce::Attribute }
+
+  describe 'initialize' do
+    let(:some_field) { attribute.new(:some_field) }
+
+    it 'should set "from" and "as" as default' do
+      expect(some_field.sfdc_name).to eq 'Some_Field__c'
+      expect(some_field.as).to eq :string
+    end
+
+    it 'should take values from the option parameter' do
+      other_field = attribute.new(:other_field, sfdc_name: 'OT__c', as: :integer)
+      expect(other_field.sfdc_name).to eq 'OT__c'
+      expect(other_field.as).to eq :integer
+    end
+  end
+
+  describe 'when the attribute is' do
+    it 'a multipick should return all values as 1 string separated with ";"' do
+      names = attribute.new(:names, as: :multi_picklist)
+      expect(names.value_for_hash ['olvap', 'eloy']).to eq 'olvap;eloy'
+    end
+  end
+end

data/spec/active_force/callbacks_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe ActiveForce::SObject do
+  let(:client) { double 'Client', create!: 'id' }
+
+  before do
+    ActiveForce.sfdc_client = client
+  end
+
+  describe "save" do
+    it 'call action callback when save a record' do
+      whizbanged = Whizbang.new
+      whizbanged.save
+      expect(whizbanged.updated_from).to eq 'Rails'
+      expect(whizbanged.dirty_attribute).to eq true
+      expect(whizbanged.changed.include? 'dirty_attribute').to eq true
+      expect(whizbanged.changed.include? 'updated_from').to eq false
+    end
+  end
+end

data/spec/active_force/mapping_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe ActiveForce::Mapping do
+  let(:mapping){ ActiveForce::Mapping.new 'some_table' }
+
+  describe 'field' do
+    it 'should add a new attribute to the instance' do
+      mapping.field :id, from: 'Id'
+      expect(mapping.mappings).to eq({ id: 'Id' })
+    end
+
+    it 'sf_names should return all attributes names from salesforce' do
+      mapping.field :id, from: 'Id'
+      mapping.field :name, from: 'Name'
+      expect(mapping.sfdc_names).to eq ['Id', 'Name']
+    end
+  end
+end

data/spec/active_force/query_spec.rb

@@ -0,0 +1,126 @@
+require 'spec_helper'
+
+describe ActiveForce::Query do
+  let(:query) do
+    query = ActiveForce::Query.new 'table_name'
+    query.fields ['name', 'etc']
+    query
+  end
+
+  describe '.select' do
+    it 'use column sent on the select method' do
+      expect(query.select('name').all.to_s).to eq "SELECT name FROM table_name"
+    end
+
+    it 'use columns sent on the select method' do
+      expect(query.select(['id','name']).all.to_s).to eq "SELECT id, name FROM table_name"
+    end
+  end
+
+  describe ".all" do
+    it "table should return table name" do
+      expect(query.all.table).to eq(query.table)
+    end
+
+    it "fields should return fields" do
+      expect(query.all.fields).to eq query.fields
+    end
+  end
+
+  describe ".all.to_s" do
+    it "should return a query for all records" do
+      expect(query.all.to_s).to eq "SELECT Id, name, etc FROM table_name"
+    end
+
+    it "should ignore dupicated attributes in select statment" do
+      query.fields ['Id', 'name', 'etc']
+      expect(query.all.to_s).to eq "SELECT Id, name, etc FROM table_name"
+    end
+  end
+
+  describe ".where" do
+    it "should add a where condition to a query" do
+      expect(query.where("name like '%a%'").to_s).to eq "SELECT Id, name, etc FROM table_name WHERE (name like '%a%')"
+    end
+
+    it "should add multiples conditions to a query with parentheses" do
+      expect(query.where("condition1 = 1").where("condition2 = 2 OR condition3 = 3").to_s).to eq "SELECT Id, name, etc FROM table_name WHERE (condition1 = 1) AND (condition2 = 2 OR condition3 = 3)"
+    end
+  end
+
+  describe ".limit" do
+    it "should add a limit to a query" do
+      expect(query.limit("25").to_s).to eq "SELECT Id, name, etc FROM table_name LIMIT 25"
+    end
+  end
+
+  describe ".limit_value" do
+    it "should return the limit value" do
+      query.limit(4)
+      expect(query.limit_value).to eq 4
+    end
+  end
+
+  describe ".offset" do
+    it "should add an offset to a query" do
+      expect(query.offset(4).to_s).to eq "SELECT Id, name, etc FROM table_name OFFSET 4"
+    end
+  end
+
+  describe ".offset_value" do
+    it "should return the offset value" do
+      query.offset(4)
+      expect(query.offset_value).to eq 4
+    end
+  end
+
+  describe ".find.to_s" do
+    it "should return a query for 1 record" do
+      expect(query.find(2).to_s).to eq "SELECT Id, name, etc FROM table_name WHERE (Id = '2') LIMIT 1"
+    end
+  end
+
+  describe ".order" do
+    it "should add a order condition in the statment" do
+      expect(query.order("name desc").to_s).to eq "SELECT Id, name, etc FROM table_name ORDER BY name desc"
+    end
+
+    it "should add a order condition in the statment with WHERE and LIMIT" do
+      expect(query.where("condition1 = 1").order("name desc").limit(1).to_s).to eq "SELECT Id, name, etc FROM table_name WHERE (condition1 = 1) ORDER BY name desc LIMIT 1"
+    end
+  end
+
+  describe '.join' do
+    let(:join_query) do
+      join = ActiveForce::Query.new 'join_table_name'
+      join.fields ['name', 'etc']
+      join
+    end
+
+    it 'should add another select statment on the current select' do
+      expect(query.join(join_query).to_s).to eq 'SELECT Id, name, etc, (SELECT Id, name, etc FROM join_table_name) FROM table_name'
+    end
+  end
+
+  describe '.first' do
+    it 'should return the query for the first record' do
+      expect(query.first.to_s).to eq 'SELECT Id, name, etc FROM table_name LIMIT 1'
+    end
+  end
+
+  describe '.last' do
+    it 'should return the query for the last record' do
+      expect(query.last.to_s).to eq 'SELECT Id, name, etc FROM table_name ORDER BY Id DESC LIMIT 1'
+    end
+  end
+
+  describe ".count" do
+    it "should return the query for getting the row count" do
+      expect(query.count.to_s).to eq 'SELECT count(Id) FROM table_name'
+    end
+
+    it "should work with a condition" do
+      expect(query.where("name = 'cool'").count.to_s).to eq "SELECT count(Id) FROM table_name WHERE (name = 'cool')"
+    end
+  end
+end