restforce-db 0.5.1 → 1.0.0

data/test/cassettes/{Restforce_DB_Initializer/_run/given_an_existing_Salesforce_record/for_a_root_mapping/creates_a_matching_database_record.yml → Restforce_DB_Strategies_Always/_build_/given_a_Salesforce_record/wants_to_build_a_new_matching_record.yml}

@@ -21,10 +21,10 @@ http_interactions:
       message: OK
     headers:
       Date:
-      - Mon, 06 Apr 2015 16:24:41 GMT
+      - Wed, 08 Apr 2015 17:25:20 GMT
       Set-Cookie:
-      - BrowserId=lVxxhf7fSri3JVI565pIKA;Path=/;Domain=.salesforce.com;Expires=Fri,
-        05-Jun-2015 16:24:41 GMT
+      - BrowserId=aV1yozgjTVWf7NTdcekyKQ;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:20 GMT
       Expires:
       - Thu, 01 Jan 1970 00:00:00 GMT
       Pragma:
@@ -37,22 +37,22 @@ http_interactions:
       - chunked
     body:
       encoding: ASCII-8BIT
-      string: '{"id":"https://login.salesforce.com/id/00D1a000000H3O9EAK/0051a000000UGT8AAO","issued_at":"1428337481161","token_type":"Bearer","instance_url":"https://<host>","signature":"qovSt6iFWpcplBSmFRHDaaAYio/Wlu4HTu99Vp6+kzY=","access_token":"00D1a000000H3O9!AQ4AQFhXX0t0My8qCHdrUMfRwg3B5FPFTjOwddPzvTaHu0t9H1xiDVKOSpDxKItHiqnvYyMKqZVwaC5AIJvYk_bzVt8m7Vil"}'
+      string: '{"id":"https://login.salesforce.com/id/00D1a000000H3O9EAK/0051a000000UGT8AAO","issued_at":"1428513920164","token_type":"Bearer","instance_url":"https://<host>","signature":"+9Ohy1Rt/hV2LV72iFHN4G0osOsG5BWr/EnsA2it878=","access_token":"00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe"}'
     http_version: 
-  recorded_at: Mon, 06 Apr 2015 16:24:41 GMT
+  recorded_at: Wed, 08 Apr 2015 17:25:19 GMT
 - request:
     method: post
     uri: https://<host>/services/data/v26.0/sobjects/CustomObject__c
     body:
       encoding: UTF-8
-      string: '{"Name":"Custom object","Example_Field__c":"Some sample text"}'
+      string: '{"Name":"Sample object"}'
     headers:
       User-Agent:
       - Faraday v0.9.1
       Content-Type:
       - application/json
       Authorization:
-      - OAuth 00D1a000000H3O9!AQ4AQFhXX0t0My8qCHdrUMfRwg3B5FPFTjOwddPzvTaHu0t9H1xiDVKOSpDxKItHiqnvYyMKqZVwaC5AIJvYk_bzVt8m7Vil
+      - OAuth 00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -63,28 +63,28 @@ http_interactions:
       message: Created
     headers:
       Date:
-      - Mon, 06 Apr 2015 16:24:42 GMT
+      - Wed, 08 Apr 2015 17:25:20 GMT
       Set-Cookie:
-      - BrowserId=cL6_Fot-T9yc4mTZnI1ACw;Path=/;Domain=.salesforce.com;Expires=Fri,
-        05-Jun-2015 16:24:42 GMT
+      - BrowserId=bweRzNnuS5yGi0KPQtNPlw;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:20 GMT
       Expires:
       - Thu, 01 Jan 1970 00:00:00 GMT
       Sforce-Limit-Info:
-      - api-usage=36/15000
+      - api-usage=1/15000
       Location:
-      - "/services/data/v26.0/sobjects/CustomObject__c/a001a000001LH2uAAG"
+      - "/services/data/v26.0/sobjects/CustomObject__c/a001a000001LMs9AAG"
       Content-Type:
       - application/json;charset=UTF-8
       Transfer-Encoding:
       - chunked
     body:
       encoding: ASCII-8BIT
-      string: '{"id":"a001a000001LH2uAAG","success":true,"errors":[]}'
+      string: '{"id":"a001a000001LMs9AAG","success":true,"errors":[]}'
     http_version: 
-  recorded_at: Mon, 06 Apr 2015 16:24:42 GMT
+  recorded_at: Wed, 08 Apr 2015 17:25:19 GMT
 - request:
     method: get
-    uri: https://<host>/services/data/v26.0/query?q=select%20Id,%20SystemModstamp,%20Name,%20Example_Field__c%20from%20CustomObject__c
+    uri: https://<host>/services/data/v26.0/query?q=select%20Id,%20SystemModstamp,%20Name,%20Example_Field__c%20from%20CustomObject__c%20where%20Id%20=%20%27a001a000001LMs9AAG%27
     body:
       encoding: US-ASCII
       string: ''
@@ -92,7 +92,7 @@ http_interactions:
       User-Agent:
       - Faraday v0.9.1
       Authorization:
-      - OAuth 00D1a000000H3O9!AQ4AQFhXX0t0My8qCHdrUMfRwg3B5FPFTjOwddPzvTaHu0t9H1xiDVKOSpDxKItHiqnvYyMKqZVwaC5AIJvYk_bzVt8m7Vil
+      - OAuth 00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -103,27 +103,27 @@ http_interactions:
       message: OK
     headers:
       Date:
-      - Mon, 06 Apr 2015 16:24:43 GMT
+      - Wed, 08 Apr 2015 17:25:20 GMT
       Set-Cookie:
-      - BrowserId=BILH41M9Q5a6jzEpUQmMaw;Path=/;Domain=.salesforce.com;Expires=Fri,
-        05-Jun-2015 16:24:43 GMT
+      - BrowserId=LdEHnhcdRxGe-GXkxf1njw;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:20 GMT
       Expires:
       - Thu, 01 Jan 1970 00:00:00 GMT
       Sforce-Limit-Info:
-      - api-usage=36/15000
+      - api-usage=1/15000
       Content-Type:
       - application/json;charset=UTF-8
       Transfer-Encoding:
       - chunked
     body:
       encoding: ASCII-8BIT
-      string: '{"totalSize":1,"done":true,"records":[{"attributes":{"type":"CustomObject__c","url":"/services/data/v26.0/sobjects/CustomObject__c/a001a000001LH2uAAG"},"Id":"a001a000001LH2uAAG","SystemModstamp":"2015-04-06T16:24:42.000+0000","Name":"Custom
-        object","Example_Field__c":"Some sample text"}]}'
+      string: '{"totalSize":1,"done":true,"records":[{"attributes":{"type":"CustomObject__c","url":"/services/data/v26.0/sobjects/CustomObject__c/a001a000001LMs9AAG"},"Id":"a001a000001LMs9AAG","SystemModstamp":"2015-04-08T17:25:20.000+0000","Name":"Sample
+        object","Example_Field__c":null}]}'
     http_version: 
-  recorded_at: Mon, 06 Apr 2015 16:24:43 GMT
+  recorded_at: Wed, 08 Apr 2015 17:25:19 GMT
 - request:
     method: delete
-    uri: https://<host>/services/data/v26.0/sobjects/CustomObject__c/a001a000001LH2uAAG
+    uri: https://<host>/services/data/v26.0/sobjects/CustomObject__c/a001a000001LMs9AAG
     body:
       encoding: US-ASCII
       string: ''
@@ -131,7 +131,7 @@ http_interactions:
       User-Agent:
       - Faraday v0.9.1
       Authorization:
-      - OAuth 00D1a000000H3O9!AQ4AQFhXX0t0My8qCHdrUMfRwg3B5FPFTjOwddPzvTaHu0t9H1xiDVKOSpDxKItHiqnvYyMKqZVwaC5AIJvYk_bzVt8m7Vil
+      - OAuth 00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -142,17 +142,17 @@ http_interactions:
       message: No Content
     headers:
       Date:
-      - Mon, 06 Apr 2015 16:24:44 GMT
+      - Wed, 08 Apr 2015 17:25:20 GMT
       Set-Cookie:
-      - BrowserId=xFiEOfdbRdiL5E8KUkTLsg;Path=/;Domain=.salesforce.com;Expires=Fri,
-        05-Jun-2015 16:24:44 GMT
+      - BrowserId=vEmT_p9fRFiuV4_9cudymw;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:20 GMT
       Expires:
       - Thu, 01 Jan 1970 00:00:00 GMT
       Sforce-Limit-Info:
-      - api-usage=36/15000
+      - api-usage=1/15000
     body:
       encoding: UTF-8
       string: ''
     http_version: 
-  recorded_at: Mon, 06 Apr 2015 16:24:44 GMT
+  recorded_at: Wed, 08 Apr 2015 17:25:19 GMT
 recorded_with: VCR 2.9.3

data/test/cassettes/Restforce_DB_Strategies_Always/_build_/given_a_Salesforce_record/with_a_corresponding_database_record/does_not_want_to_build_a_new_record.yml

@@ -0,0 +1,158 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://<host>/services/oauth2/token
+    body:
+      encoding: US-ASCII
+      string: grant_type=password&client_id=<client_id>&client_secret=<client_secret>&username=<username>&password=<password><security_token>
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Wed, 08 Apr 2015 17:25:17 GMT
+      Set-Cookie:
+      - BrowserId=lengI2EHTRub2Ko8hohJlQ;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:17 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Pragma:
+      - no-cache
+      Cache-Control:
+      - no-cache, no-store
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"https://login.salesforce.com/id/00D1a000000H3O9EAK/0051a000000UGT8AAO","issued_at":"1428513917270","token_type":"Bearer","instance_url":"https://<host>","signature":"EQGJyzSNyv8NhiCakDKNBRYnVOwnkS5/GgopPeymCdM=","access_token":"00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe"}'
+    http_version: 
+  recorded_at: Wed, 08 Apr 2015 17:25:16 GMT
+- request:
+    method: post
+    uri: https://<host>/services/data/v26.0/sobjects/CustomObject__c
+    body:
+      encoding: UTF-8
+      string: '{"Name":"Sample object"}'
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Content-Type:
+      - application/json
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Date:
+      - Wed, 08 Apr 2015 17:25:17 GMT
+      Set-Cookie:
+      - BrowserId=zaP7cAcjRAO83Rd04ogCbg;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:17 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=1/15000
+      Location:
+      - "/services/data/v26.0/sobjects/CustomObject__c/a001a000001LMs4AAG"
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"a001a000001LMs4AAG","success":true,"errors":[]}'
+    http_version: 
+  recorded_at: Wed, 08 Apr 2015 17:25:16 GMT
+- request:
+    method: get
+    uri: https://<host>/services/data/v26.0/query?q=select%20Id,%20SystemModstamp,%20Name,%20Example_Field__c%20from%20CustomObject__c%20where%20Id%20=%20%27a001a000001LMs4AAG%27
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Wed, 08 Apr 2015 17:25:17 GMT
+      Set-Cookie:
+      - BrowserId=WXSf9tl1QHmxrtYD_ZRVmA;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:17 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=1/15000
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"totalSize":1,"done":true,"records":[{"attributes":{"type":"CustomObject__c","url":"/services/data/v26.0/sobjects/CustomObject__c/a001a000001LMs4AAG"},"Id":"a001a000001LMs4AAG","SystemModstamp":"2015-04-08T17:25:17.000+0000","Name":"Sample
+        object","Example_Field__c":null}]}'
+    http_version: 
+  recorded_at: Wed, 08 Apr 2015 17:25:16 GMT
+- request:
+    method: delete
+    uri: https://<host>/services/data/v26.0/sobjects/CustomObject__c/a001a000001LMs4AAG
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQCyefAUUsnWlCVp8nuCPw5FHOg4Bv_Grcp4GTCMkt22gpGUL_iimYlj.5dHJYoGbAKCuPttEXOKeigHMy9VPNErhVDRe
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 204
+      message: No Content
+    headers:
+      Date:
+      - Wed, 08 Apr 2015 17:25:18 GMT
+      Set-Cookie:
+      - BrowserId=Jr37xurySTWA9GLgtkUEsA;Path=/;Domain=.salesforce.com;Expires=Sun,
+        07-Jun-2015 17:25:18 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=1/15000
+    body:
+      encoding: UTF-8
+      string: ''
+    http_version: 
+  recorded_at: Wed, 08 Apr 2015 17:25:17 GMT
+recorded_with: VCR 2.9.3

data/test/lib/restforce/db/associations/active_record_test.rb

@@ -15,12 +15,12 @@ describe Restforce::DB::Associations::ActiveRecord do
     let(:associated_record) { association.build(salesforce_record) }
 
     before do
-      mapping = Restforce::DB::Mapping.new(
-        User,
-        "Contact",
-        through: "Friend__c",
-        fields: { email: "Email" },
-      )
+      mapping = Restforce::DB::Mapping.new(User, "Contact").tap do |m|
+        m.through = "Friend__c"
+        m.fields  = { email: "Email" }
+      end
+      Restforce::DB::Registry << mapping
+
       salesforce_record_type = mapping.salesforce_record_type
 
       # Stub out the `#find` method on the record type

data/test/lib/restforce/db/attribute_map_test.rb

@@ -16,7 +16,11 @@ describe Restforce::DB::AttributeMap do
   let(:attribute_map) { Restforce::DB::AttributeMap.new(database_model, salesforce_model, fields) }
 
   describe "#attributes" do
-    let(:mapping) { Restforce::DB::Mapping.new(database_model, salesforce_model, fields: fields) }
+    let(:mapping) do
+      Restforce::DB::Mapping.new(database_model, salesforce_model).tap do |m|
+        m.fields = fields
+      end
+    end
 
     it "builds a normalized Hash of database attribute values" do
       attributes = attribute_map.attributes(database_model) do |attribute|

data/test/lib/restforce/db/dsl_test.rb

@@ -0,0 +1,80 @@
+require_relative "../../../test_helper"
+
+describe Restforce::DB::DSL do
+
+  let(:database_model) { CustomObject }
+  let(:salesforce_model) { "CustomObject__c" }
+  let(:strategy) { :always }
+  let(:dsl) { Restforce::DB::DSL.new(database_model, salesforce_model, strategy) }
+  let(:mapping) { dsl.mapping }
+
+  before { dsl }
+
+  describe "#initialize" do
+
+    it "registers a mapping for the passed models" do
+      expect(Restforce::DB::Registry[database_model]).to_equal [mapping]
+      expect(Restforce::DB::Registry[salesforce_model]).to_equal [mapping]
+    end
+
+    describe "when a strategy of :always is specified" do
+      let(:strategy) { :always }
+
+      it "respects the declared strategy" do
+        expect(dsl.mapping.strategy).to_be_instance_of(Restforce::DB::Strategies::Always)
+      end
+    end
+
+    describe "when a strategy of :passive is specified" do
+      let(:strategy) { :passive }
+
+      it "respects the declared strategy" do
+        expect(dsl.mapping.strategy).to_be_instance_of(Restforce::DB::Strategies::Passive)
+      end
+    end
+  end
+
+  describe "#where" do
+    let(:conditions) { %w(some list of query conditions) }
+
+    before do
+      dsl.where(*conditions)
+    end
+
+    it "sets a list of conditions for the mapping" do
+      expect(mapping.conditions).to_equal conditions
+    end
+  end
+
+  describe "#belongs_to" do
+    before do
+      dsl.belongs_to :some_association, through: "Some_Field__c"
+    end
+
+    it "adds an association to the created mapping" do
+      expect(mapping.associations).to_equal some_association: "Some_Field__c"
+    end
+  end
+
+  describe "#has_one" do
+    before do
+      dsl.has_one :other_association, through: "Other_Field__c"
+    end
+
+    it "sets the `through` attribute for the created mapping" do
+      expect(mapping.through).to_equal "Other_Field__c"
+    end
+  end
+
+  describe "#maps" do
+    let(:fields) { { some: "Fields__c", to: "Sync__c" } }
+
+    before do
+      dsl.maps fields
+    end
+
+    it "sets the fields for the created mapping" do
+      expect(mapping.fields).to_equal fields
+    end
+  end
+end

data/test/lib/restforce/db/initializer_test.rb

@@ -26,8 +26,9 @@ describe Restforce::DB::Initializer do
         salesforce_id
       end
 
-      describe "for a root mapping" do
+      describe "for an Always strategy" do
         before do
+          mapping.strategy = Restforce::DB::Strategies::Always.new
           initializer.run
         end
 
@@ -40,10 +41,9 @@ describe Restforce::DB::Initializer do
         end
       end
 
-      describe "for a non-root mapping" do
-        let(:through) { "SomeField__c" }
-
+      describe "for a Passive strategy" do
         before do
+          mapping.strategy = Restforce::DB::Strategies::Passive.new
           initializer.run
         end
 
@@ -61,8 +61,9 @@ describe Restforce::DB::Initializer do
         database_record
       end
 
-      describe "for a root mapping" do
+      describe "for an Always strategy" do
         before do
+          mapping.strategy = Restforce::DB::Strategies::Always.new
           initializer.run
           Salesforce.records << [salesforce_model, salesforce_id]
         end
@@ -75,10 +76,9 @@ describe Restforce::DB::Initializer do
         end
       end
 
-      describe "for a non-root mapping" do
-        let(:through) { "SomeField__c" }
-
+      describe "for a Passive strategy" do
         before do
+          mapping.strategy = Restforce::DB::Strategies::Passive.new
           initializer.run
         end