soapforce 0.1.1

data/soapforce.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'soapforce/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "soapforce"
+  gem.version       = Soapforce::VERSION
+  gem.authors       = ["Joe Heth"]
+  gem.email         = ["joeheth@gmail.com"]
+  gem.description   = %q{A ruby client for the Salesforce SOAP API based on Savon.}
+  gem.summary       = %q{Wraps Savon with helper methods and custom types for interacting with the Salesforce SOAP API.}
+  gem.homepage      = "https://github.com/TinderBox/soapforce"
+
+  ignores  = File.readlines('.gitignore').grep(/\S+/).map(&:chomp)
+  dotfiles = %w[.gitignore .travis.yml]
+
+  all_files_without_ignores = Dir['**/*'].reject { |f|
+    File.directory?(f) || ignores.any? { |i| File.fnmatch(i, f) }
+  }
+
+  gem.files = (all_files_without_ignores + dotfiles).sort
+
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency("savon", "~>2.3.0")
+
+  gem.add_development_dependency 'rspec', '~> 2.14.0'
+  gem.add_development_dependency 'webmock', '~> 1.13.0'
+  gem.add_development_dependency 'simplecov', '~> 0.7.1'
+end

data/spec/fixtures/create_response.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com">
+<soapenv:Body>
+    <createResponse>
+        <result>
+            <id>006A000000LbiizIAB</id>
+            <success>true</success>
+        </result>
+    </createResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/delete_response.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com">
+<soapenv:Body>
+    <deleteResponse>
+        <result>
+            <id>006A000000LbiizIAB</id>
+            <success>true</success>
+        </result>
+    </deleteResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/describe_global_response.xml

@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<soapenv:Body>
+    <describeGlobalResponse>
+        <result>
+            <encoding>UTF-8</encoding>
+            <maxBatchSize>200</maxBatchSize>
+            <sobjects>
+                <activateable>false</activateable>
+                <createable>true</createable>
+                <custom>false</custom>
+                <customSetting>false</customSetting>
+                <deletable>true</deletable>
+                <deprecatedAndHidden>false</deprecatedAndHidden>
+                <feedEnabled>true</feedEnabled>
+                <keyPrefix>001</keyPrefix>
+                <label>Account</label>
+                <labelPlural>Accounts</labelPlural>
+                <layoutable>true</layoutable>
+                <mergeable>true</mergeable>
+                <name>Account</name>
+                <queryable>true</queryable>
+                <replicateable>true</replicateable>
+                <retrieveable>true</retrieveable>
+                <searchable>true</searchable>
+                <triggerable>true</triggerable>
+                <undeletable>true</undeletable>
+                <updateable>true</updateable>
+            </sobjects>
+            <sobjects>
+                <activateable>false</activateable>
+                <createable>true</createable>
+                <custom>false</custom>
+                <customSetting>false</customSetting>
+                <deletable>true</deletable>
+                <deprecatedAndHidden>false</deprecatedAndHidden>
+                <feedEnabled>false</feedEnabled>
+                <keyPrefix>02Z</keyPrefix>
+                <label>Account Contact Role</label>
+                <labelPlural>Account Contact Role</labelPlural>
+                <layoutable>false</layoutable>
+                <mergeable>false</mergeable>
+                <name>AccountContactRole</name>
+                <queryable>true</queryable>
+                <replicateable>true</replicateable>
+                <retrieveable>true</retrieveable>
+                <searchable>false</searchable>
+                <triggerable>false</triggerable>
+                <undeletable>false</undeletable>
+                <updateable>true</updateable>
+            </sobjects>
+        </result>
+    </describeGlobalResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/describe_s_object_response.xml

@@ -0,0 +1,9 @@
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <soapenv:Body>
+    <describeSObjectResponse>
+      <result>
+      </result>
+    </describeSObjectResponse>
+  </soapenv:Body>
+</soapenv:Envelope>
+

data/spec/fixtures/describe_s_objects_response.xml

@@ -0,0 +1,9 @@
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <soapenv:Body>
+    <describeSObjectsResponse>
+      <result>
+      </result>
+    </describeSObjectsResponse>
+  </soapenv:Body>
+</soapenv:Envelope>
+

data/spec/fixtures/get_user_info_response.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<soapenv:Body>
+    <getUserInfoResponse>
+        <result>
+            <accessibilityMode>false</accessibilityMode>
+            <currencySymbol>$</currencySymbol>
+            <orgAttachmentFileSizeLimit>5242880</orgAttachmentFileSizeLimit>
+            <orgDefaultCurrencyIsoCode>USD</orgDefaultCurrencyIsoCode>
+            <orgDisallowHtmlAttachments>false</orgDisallowHtmlAttachments>
+            <orgHasPersonAccounts>false</orgHasPersonAccounts>
+            <organizationId>00DA0000000YpZ4MAK</organizationId>
+            <organizationMultiCurrency>false</organizationMultiCurrency>
+            <organizationName>Developer</organizationName>
+            <profileId>00eA0000000AAAAIA2</profileId>
+            <roleId xsi:nil="true"/>
+            <sessionSecondsValid>7200</sessionSecondsValid>
+            <userDefaultCurrencyIsoCode xsi:nil="true"/>
+            <userEmail>johndoe@email.com</userEmail>
+            <userFullName>John Doe</userFullName>
+            <userId>005A000000AAAAY</userId>
+            <userLanguage>en_US</userLanguage>
+            <userLocale>en_US</userLocale>
+            <userName>john.doe@email.com</userName>
+            <userTimeZone>America/Panama</userTimeZone>
+            <userType>Standard</userType>
+            <userUiSkin>Theme3</userUiSkin>
+        </result>
+    </getUserInfoResponse>
+</soapenv:Body>
+</soapenv:Envelope>
+

data/spec/fixtures/login_response.xml

@@ -0,0 +1,39 @@
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <soapenv:Body>
+    <loginResponse>
+      <result>
+        <metadataServerUrl>https://na7.salesforce.com/services/Soap/m/28.0/00DA0000000YpZ4</metadataServerUrl>
+        <passwordExpired>false</passwordExpired>
+        <sandbox>false</sandbox>
+        <serverUrl>https://na7.salesforce.com/services/Soap/u/28.0/00DA0000000YpZ4</serverUrl>
+        <sessionId>00DA0000000YpZ4!ARAAQEH.613sgjdpLDPsev9EBTxM0PMhEzbaCE505DYFCSm8tBkdDBl.NFsmPEISjp7Ccd.t9BTTFa1DRmtbxkikZPI8FqDj</sessionId>
+        <userId>005A000000AAAAAIAY</userId>
+        <userInfo>
+          <accessibilityMode>false</accessibilityMode>
+          <currencySymbol>$</currencySymbol>
+          <orgAttachmentFileSizeLimit>5242880</orgAttachmentFileSizeLimit>
+          <orgDefaultCurrencyIsoCode>USD</orgDefaultCurrencyIsoCode>
+          <orgDisallowHtmlAttachments>false</orgDisallowHtmlAttachments>
+          <orgHasPersonAccounts>false</orgHasPersonAccounts>
+          <organizationId>00DA0000000YpZ4MAK</organizationId>
+          <organizationMultiCurrency>false</organizationMultiCurrency>
+          <organizationName>Developer</organizationName>
+          <profileId>00eA0000000AAAAAA2</profileId>
+          <roleId xsi:nil="true"/>
+          <sessionSecondsValid>7200</sessionSecondsValid>
+          <userDefaultCurrencyIsoCode xsi:nil="true"/>
+          <userEmail>john.doe@email.com</userEmail>
+          <userFullName>John Doe</userFullName>
+          <userId>005A000000AAAAAIAY</userId>
+          <userLanguage>en_US</userLanguage>
+          <userLocale>en_US</userLocale>
+          <userName>john.doe@email.com</userName>
+          <userTimeZone>America/Panama</userTimeZone>
+          <userType>Standard</userType>
+          <userUiSkin>Theme3</userUiSkin>
+        </userInfo>
+      </result>
+    </loginResponse>
+  </soapenv:Body>
+</soapenv:Envelope>
+

data/spec/fixtures/org_id_response.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sf="urn:sobject.partner.soap.sforce.com">
+<soapenv:Body>
+    <queryResponse>
+        <result xsi:type="QueryResult">
+            <done>true</done>
+            <queryLocator xsi:nil="true"/>
+            <records xsi:type="sf:sObject">
+                <sf:type>Organization</sf:type>
+                <sf:Id>00DA0000000YpZ4MAK</sf:Id>
+                <sf:Id>00DA0000000YpZ4MAK</sf:Id>
+            </records>
+            <size>1</size>
+        </result>
+    </queryResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/query_all_response.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sf="urn:sobject.partner.soap.sforce.com">
+<soapenv:Body>
+    <queryAllResponse>
+        <result xsi:type="QueryResult">
+            <done>true</done>
+            <queryLocator xsi:nil="true"/>
+            <records xsi:type="sf:sObject">
+                <sf:type>Opportunity</sf:type>
+                <sf:Id>006A000000LZhwNIAT</sf:Id>
+                <sf:Id>006A000000LZhwNIAT</sf:Id>
+                <sf:Name>Opportunity 1</sf:Name>
+                <sf:StageName>Prospecting</sf:StageName>
+            </records>
+            <records xsi:type="sf:sObject">
+                <sf:type>Opportunity</sf:type>
+                <sf:Id>006A000000LaF4xIAF</sf:Id>
+                <sf:Id>006A000000LaF4xIAF</sf:Id>
+                <sf:Name>Opportunity 2</sf:Name>
+                <sf:StageName>Value Proposition</sf:StageName>
+            </records>
+            <size>2</size>
+        </result>
+    </queryAllResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/query_more_response.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sf="urn:sobject.partner.soap.sforce.com">
+<soapenv:Body>
+    <queryMoreResponse>
+        <result xsi:type="QueryResult">
+            <done>true</done>
+            <queryLocator xsi:nil="true"/>
+            <records xsi:type="sf:sObject">
+                <sf:type>Opportunity</sf:type>
+                <sf:Id>006A000000LZhwNIAT</sf:Id>
+                <sf:Id>006A000000LZhwNIAT</sf:Id>
+                <sf:Name>Opportunity 1</sf:Name>
+                <sf:StageName>Prospecting</sf:StageName>
+            </records>
+            <records xsi:type="sf:sObject">
+                <sf:type>Opportunity</sf:type>
+                <sf:Id>006A000000LaF4xIAF</sf:Id>
+                <sf:Id>006A000000LaF4xIAF</sf:Id>
+                <sf:Name>Opportunity 2</sf:Name>
+                <sf:StageName>Value Proposition</sf:StageName>
+            </records>
+            <size>2</size>
+        </result>
+    </queryMoreResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/query_response.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sf="urn:sobject.partner.soap.sforce.com">
+<soapenv:Body>
+    <queryResponse>
+        <result xsi:type="QueryResult">
+            <done>true</done>
+            <queryLocator xsi:nil="true"/>
+            <records xsi:type="sf:sObject">
+                <sf:type>Opportunity</sf:type>
+                <sf:Id>006A000000LZhwNIAT</sf:Id>
+                <sf:Id>006A000000LZhwNIAT</sf:Id>
+                <sf:Name>Opportunity 1</sf:Name>
+                <sf:StageName>Prospecting</sf:StageName>
+            </records>
+            <records xsi:type="sf:sObject">
+                <sf:type>Opportunity</sf:type>
+                <sf:Id>006A000000LaF4xIAF</sf:Id>
+                <sf:Id>006A000000LaF4xIAF</sf:Id>
+                <sf:Name>Opportunity 2</sf:Name>
+                <sf:StageName>Value Proposition</sf:StageName>
+            </records>
+            <size>2</size>
+        </result>
+    </queryResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/retrieve_response.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:sf="urn:sobject.partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<soapenv:Body>
+    <retrieveResponse>
+        <result xsi:type="sf:sObject">
+            <sf:type>Opportunity</sf:type>
+            <sf:Id>006A000000LbkT5IAJ</sf:Id>
+            <sf:Name>SOAPForce Opportunity</sf:Name>
+            <sf:Description xsi:nil="true"/>
+            <sf:StageName>Prospecting</sf:StageName>
+        </result>
+    </retrieveResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/search_response.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com">
+<soapenv:Body>
+    <searchResponse>
+        <result/>
+    </searchResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/update_response.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com">
+<soapenv:Body>
+    <updateResponse>
+        <result>
+            <id>006A000000LbiizIAB</id>
+            <success>true</success>
+        </result>
+    </updateResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/fixtures/upsert_response.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com">
+<soapenv:Body>
+    <upsertResponse>
+        <result>
+        	<created>true</created>
+            <id>006A000000LbiizIAB</id>
+            <success>true</success>
+        </result>
+        <result>
+        	<created>false</created>
+            <id>006A000000LbiizIAB</id>
+            <success>true</success>
+        </result>
+    </upsertResponse>
+</soapenv:Body>
+</soapenv:Envelope>

data/spec/lib/client_spec.rb

@@ -0,0 +1,301 @@
+require 'spec_helper'
+
+describe Soapforce::Client do
+  let(:endpoint) { 'https://na15.salesforce.com' }
+
+  describe "#operations" do
+    it "should return list of operations from the wsdl" do
+      subject.operations.should be_a(Array)
+      subject.operations.should include(:login, :logout, :query, :create)
+    end
+  end
+
+  describe "#login" do
+    it "authenticates with username and password_and_token" do
+
+      body = "<tns:login><tns:username>testing</tns:username><tns:password>password_and_token</tns:password></tns:login>"
+      stub = stub_login_request({with_body: body})
+      stub.to_return(:status => 200, :body => fixture("login_response")) #, :headers => {})
+
+      subject.login(username: 'testing', password: 'password_and_token')
+    end
+
+    it "authenticates with session_id and instance_url" do
+
+      body = "<tns:getUserInfo></tns:getUserInfo>"
+      stub = stub_login_request({
+        server_url: 'https://na15.salesforce.com',
+        headers: {session_id: 'abcde12345'},
+        with_body: body}
+        )
+      stub.to_return(:status => 200, :body => fixture("get_user_info_response"))
+
+      user_info = subject.login(session_id: 'abcde12345', server_url: 'https://na15.salesforce.com')
+
+      user_info[:user_email].should == "johndoe@email.com"
+      user_info[:user_full_name].should == "John Doe"
+    end
+
+    it "should raise arugment error when no parameters are passed" do
+      expect { subject.login(session_id: 'something') }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "list_sobjects" do
+    it "should return array of object names" do
+
+      body = "<tns:describeGlobal></tns:describeGlobal>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'describe_global_response'})
+
+      subject.list_sobjects.should == ['Account', 'AccountContactRole']
+    end
+  end
+
+  describe "org_id" do
+    it "should return organization id" do
+
+      body = "<tns:query><tns:queryString>select id from Organization</tns:queryString></tns:query>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'org_id_response'})
+
+      subject.org_id.should == "00DA0000000YpZ4MAK"
+    end
+  end
+
+  describe "#descibeSObject" do
+
+    it "supports single sobject name" do
+
+      body = "<tns:describeSObject><tns:sObjectType>Opportunity</tns:sObjectType></tns:describeSObject>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'describe_s_object_response'})
+
+      subject.describe("Opportunity")
+
+      # Hit cache.
+      subject.describe("Opportunity")
+    end
+
+    it "supports array of sobject names" do
+
+      body = "<tns:describeSObjects><tns:sObjectType>Account</tns:sObjectType><tns:sObjectType>Opportunity</tns:sObjectType></tns:describeSObjects>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'describe_s_objects_response'})
+
+      subject.describe(["Account", "Opportunity"])
+    end
+  end
+
+  describe "#retrieve" do
+
+    it "should retrieve object by id" do
+      fields = {:fields => [{:name => "Id"},{:name => "Name"},{:name => "Description"},{:name => "StageName"}]}
+      # retrieve calls describe to get the list of available fields.
+      subject.should_receive(:describe).with("Opportunity").and_return(fields)
+
+      body = "<tns:retrieve><tns:fieldList>Id,Name,Description,StageName</tns:fieldList><tns:sObjectType>Opportunity</tns:sObjectType><tns:ids>006A000000LbkT5IAJ</tns:ids></tns:retrieve>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'retrieve_response'})
+
+      sobject = subject.retrieve("Opportunity", "006A000000LbkT5IAJ")
+
+      sobject.should be_a(Soapforce::SObject)
+      sobject.type.should == "Opportunity"
+      sobject.Id.should == "006A000000LbkT5IAJ"
+      sobject.Name.should == "SOAPForce Opportunity"
+      sobject.Description.should be_nil
+      sobject.StageName.should == "Prospecting"
+    end
+  end
+
+  describe "#find" do
+    it "should retrieve object by id" do
+
+      fields = {:fields => [{:name => "Id"},{:name => "Name"},{:name => "Description"},{:name => "StageName"}]}
+      # retrieve calls describe to get the list of available fields.
+      subject.should_receive(:describe).with("Opportunity").and_return(fields)
+
+      body = "<tns:retrieve><tns:fieldList>Id,Name,Description,StageName</tns:fieldList><tns:sObjectType>Opportunity</tns:sObjectType><tns:ids>006A000000LbkT5IAJ</tns:ids></tns:retrieve>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'retrieve_response'})
+
+      sobject = subject.find("Opportunity", "006A000000LbkT5IAJ")
+
+      sobject.should be_a(Soapforce::SObject)
+      sobject.type.should == "Opportunity"
+      sobject.Id.should == "006A000000LbkT5IAJ"
+      sobject.Name.should == "SOAPForce Opportunity"
+      sobject.Description.should be_nil
+      sobject.StageName.should == "Prospecting"
+    end
+
+  end
+
+  describe "#find_by_field" do
+
+    it "should retrieve object by string field" do
+      fields = {:fields => [{:name => "Id"},{:name => "Name"},{:name => "Description"},{:name => "StageName"}]}
+      # retrieve calls describe to get the list of available fields.
+      subject.should_receive(:describe).exactly(2).with("Opportunity").and_return(fields)
+
+      body = "<tns:query><tns:queryString>Select Id, Name, Description, StageName From Opportunity Where StageName = 'Prospecting'</tns:queryString></tns:query>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_response'})
+
+      subject.find_by_field("Opportunity", "Prospecting", "StageName")
+    end
+
+    it "should retrieve object by number field" do
+      fields = {:fields => [{:name => "Id"},{:name => "Name"},{:name => "Description"},{:name => "Amount", :type => "double"}]}
+      # retrieve calls describe to get the list of available fields.
+      subject.should_receive(:describe).exactly(2).with("Opportunity").and_return(fields)
+
+      body = "<tns:query><tns:queryString>Select Id, Name, Description, Amount From Opportunity Where Amount = 0.0</tns:queryString></tns:query>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_response'})
+
+      subject.find_by_field("Opportunity", 0.0, "Amount")
+    end
+
+  end
+
+  describe "#find_where" do
+
+    let(:fields) { {:fields => [{:name => "Id"},{:name => "Name"},{:name => "Description"},{:name => "StageName"}]} }
+    let(:body) { "<tns:query><tns:queryString>Select Id, Name, Description, StageName From Opportunity Where Id = '006A000000LbkT5IAJ' AND Amount = 0.0</tns:queryString></tns:query>" }
+
+    after(:each) do
+      @result.should be_a(Soapforce::QueryResult)
+      @result.size.should == 2
+      @result.first.Name == "Opportunity 1"
+      @result.last.Name == "Opportunity 2"
+    end
+
+    it "should retrieve records from hash conditions" do
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_response'})
+      # retrieve calls describe to get the list of available fields.
+      subject.should_receive(:describe).with("Opportunity").and_return(fields)
+
+      @result = subject.find_where("Opportunity", {Id: "006A000000LbkT5IAJ", Amount: 0.0})
+    end
+
+    it "should retrieve records from hash condition using IN clause" do
+      body = "<tns:query><tns:queryString>Select Id, Name, Description, StageName From Opportunity Where Id IN ('006A000000LbkT5IAJ', '006A000000AbkTcIAQ')</tns:queryString></tns:query>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_response'})
+
+      # retrieve calls describe to get the list of available fields.
+      subject.should_receive(:describe).with("Opportunity").and_return(fields)
+
+      @result = subject.find_where("Opportunity", {Id: ["006A000000LbkT5IAJ", "006A000000AbkTcIAQ"]})
+    end
+
+    it "should retrieve records from string condition" do
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_response'})
+      # retrieve calls describe to get the list of available fields.
+      subject.should_receive(:describe).with("Opportunity").and_return(fields)
+
+      @result = subject.find_where("Opportunity", "Id = '006A000000LbkT5IAJ' AND Amount = 0.0")
+    end
+
+    it "should retrieve records from string condition and specify fields" do
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_response'})
+      subject.should_not_receive(:describe)
+
+      @result = subject.find_where("Opportunity", "Id = '006A000000LbkT5IAJ' AND Amount = 0.0", ["Id", "Name", "Description", "StageName"])
+    end
+
+  end
+
+  describe "query methods" do
+
+    after(:each) do
+      @result.should be_a(Soapforce::QueryResult)
+      @result.size.should == 2
+      @result.first.Name == "Opportunity 1"
+      @result.last.Name == "Opportunity 2"
+    end
+
+    it "#query" do
+      body = "<tns:query><tns:queryString>Select Id, Name, StageName from Opportunity</tns:queryString></tns:query>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_response'})
+
+      @result = subject.query("Select Id, Name, StageName from Opportunity")
+    end
+
+    it "#query_all" do
+      body = "<tns:queryAll><tns:queryString>Select Id, Name, StageName from Opportunity</tns:queryString></tns:queryAll>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_all_response'})
+
+      @result = subject.query_all("Select Id, Name, StageName from Opportunity")
+    end
+
+    it "#query_more" do
+      body = "<tns:queryMore><tns:queryLocator>some_locator_string</tns:queryLocator></tns:queryMore>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'query_more_response'})
+
+      @result = subject.query_more("some_locator_string")
+    end
+
+  end
+
+  describe "#search" do
+
+    it "should return search results" do
+
+      sosl = "FIND 'Name*' IN ALL FIELDS RETURNING Account (Id, Name), Contact, Opportunity, Lead"
+
+      body = "<tns:search><tns:searchString>#{sosl}</tns:searchString></tns:search>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'search_response'})
+
+      subject.search(sosl)
+    end
+
+  end
+
+  describe "#create" do
+    it "should create new object" do
+
+      body = "<tns:create><tns:sObjects><ins0:type>Opportunity</ins0:type><tns:Name>SOAPForce Opportunity</tns:Name><tns:CloseDate>2013-08-12</tns:CloseDate><tns:StageName>Prospecting</tns:StageName></tns:sObjects></tns:create>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'create_response'})
+      
+      params = { Name: "SOAPForce Opportunity", CloseDate: '2013-08-12', StageName: 'Prospecting' }
+      response = subject.create("Opportunity", params)
+
+      response[:success].should be_true
+      response[:id].should == "006A000000LbiizIAB"
+    end
+  end
+
+  describe "#update" do
+    it "should update existing object" do
+
+      body = "<tns:update><tns:sObjects><ins0:type>Opportunity</ins0:type><ins0:Id>003ABCDE</ins0:Id><tns:Name>SOAPForce Opportunity</tns:Name><tns:CloseDate>2013-08-12</tns:CloseDate><tns:StageName>Closed Won</tns:StageName></tns:sObjects></tns:update>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'update_response'})
+
+      params = { Id: '003ABCDE', Name: "SOAPForce Opportunity", CloseDate: '2013-08-12', StageName: 'Closed Won' }
+      response = subject.update("Opportunity", params)
+
+      response[:success].should be_true
+      response[:id].should == "006A000000LbiizIAB"
+    end
+  end
+
+  describe "#upsert" do
+    it "should insert new and update existing objects" do
+
+      body = "<tns:upsert><tns:externalIDFieldName>External_Id__c</tns:externalIDFieldName><tns:sObjects><ins0:type>Opportunity</ins0:type><tns:Name>New Opportunity</tns:Name><tns:CloseDate>2013-08-12</tns:CloseDate><tns:StageName>Prospecting</tns:StageName></tns:sObjects><tns:sObjects><ins0:type>Opportunity</ins0:type><ins0:Id>003ABCDE</ins0:Id><tns:Name>Existing Opportunity</tns:Name><tns:CloseDate>2013-08-12</tns:CloseDate><tns:StageName>Closed Won</tns:StageName></tns:sObjects></tns:upsert>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'upsert_response'})
+
+      objects = [
+        { Name: "New Opportunity", CloseDate: '2013-08-12', StageName: 'Prospecting' },
+        { Id: '003ABCDE', Name: "Existing Opportunity", CloseDate: '2013-08-12', StageName: 'Closed Won' }
+      ]
+      subject.upsert("Opportunity", "External_Id__c", objects)
+    end
+  end
+
+  describe "#delete" do
+    it "should delete existing objects" do
+      body = "<tns:delete><tns:ids>003ABCDE</tns:ids></tns:delete>"
+      stub = stub_api_request(endpoint, {with_body: body, fixture: 'delete_response'})
+      response = subject.delete("003ABCDE")
+
+      response[:success].should be_true
+      response[:id].should == "006A000000LbiizIAB"
+    end
+  end
+
+end