aq1018-rforce 0.5.1

data/.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+rforce.tmproj
+

data/History.txt

@@ -0,0 +1,38 @@
+== 0.5.1 2010-12-02
+
+* Increased default batch size to 2000 (Salesforce's maximum)
+* Using Nokogiri based SOAP response handler
+
+== 0.4.2 2010-12-01
+
+* Dropping dependency of facet
+
+== 0.4.1 2010-01-21
+
+* 1 minor enhancement:
+  * Fixed bug in search for XML libraries
+
+== 0.4.0 2010-01-21
+
+* 1 minor enhancement:
+  * Moved RubyGems dependencies into the gemspec where they belong
+
+== 0.3.0 2009-04-16
+
+* 1 minor enhancement:
+  * Updated for Ruby 1.9
+
+== 0.2.1 2008-07-04
+
+* 1 minor enhancement:
+  * Updated examples for SalesForce API v10
+
+== 0.2.0 2008-07-03
+
+* 1 major enhancement:
+  * Incorporated fixes from ActiveSalesforce project
+
+== 0.1.0 2005-09-02
+
+* 1 major enhancement:
+  * Initial release

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2005-2010 Ian Dees and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,49 @@
+= rforce
+
+* http://github.com/aq1018/rforce
+
+== DESCRIPTION:
+
+RForce is a simple, usable binding to the SalesForce API.
+
+== FEATURES/PROBLEMS:
+
+Rather than enforcing adherence to the sforce.com schema, RForce assumes you are familiar with the API. Ruby method names become SOAP method names. Nested Ruby hashes become nested XML elements.
+
+== SYNOPSIS:
+
+  binding = RForce::Binding.new \
+    'https://www.salesforce.com/services/Soap/u/10.0'
+
+  binding.login \
+    'email', 'password_with_token'
+
+  answer = binding.search \
+    :searchString =>
+      'find {McFakerson Co} in name fields returning account(id)'
+
+  account = answer.searchResponse.result.searchRecords.record
+  account = account.first if account.is_a? Array  
+
+  account_id = account.Id
+  account_id = account_id.first if account_id.is_a? Array
+
+  opportunity = [
+                 :type, 'Opportunity',
+                 :accountId, account_id,
+                 :amount, '10.00',
+                 :name, 'Fakey McFakerson',
+                 :closeDate, '2008-07-04',
+                 :stageName, 'Closed Won'
+                ]
+
+  binding.create :sObject => opportunity
+  
+== REQUIREMENTS:
+
+* Builder gem
+* A SalesForce Enterprise or Developer account
+
+== INSTALL:
+
+* sudo gem install aq1018-rforce

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "aq1018-rforce"
+    gem.summary = %Q{A simple, usable binding to the SalesForce API.}
+    gem.description = %Q{Rather than enforcing adherence to the sforce.com schema, RForce assumes you are familiar with the API. Ruby method names become SOAP method names. Nested Ruby hashes become nested XML elements.}
+    gem.email = "aq1018@gmail.com"
+    gem.homepage = "http://github.com/aq1018/rforce"
+    gem.authors = ["Ian Dees", "Logan (henriquez)", "Aaron Qian", "Moritz Heidkamp"]
+    gem.add_dependency "builder", ">= 2.0.0"
+    gem.add_dependency "nokogiri", "~> 1.4.4"
+    gem.add_dependency 'oauth'
+    gem.add_development_dependency "rspec", ">= 1.3"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "rforce #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.5.1

data/aq1018-rforce.gemspec

@@ -0,0 +1,101 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{aq1018-rforce}
+  s.version = "0.5.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ian Dees", "Logan (henriquez)", "Aaron Qian", "Moritz Heidkamp"]
+  s.date = %q{2010-12-02}
+  s.description = %q{Rather than enforcing adherence to the sforce.com schema, RForce assumes you are familiar with the API. Ruby method names become SOAP method names. Nested Ruby hashes become nested XML elements.}
+  s.email = %q{aq1018@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "History.txt",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "aq1018-rforce.gemspec",
+     "bugs/issue-09d998dc3f9d6e8928598fd5d9c6627102dedd65.yaml",
+     "bugs/issue-1b668248120eb4fd055f0ea6b75ff807f6955936.yaml",
+     "bugs/issue-3ef7a7c5c7e38fb76e1f53e1b67f45559e21b104.yaml",
+     "bugs/issue-a7a87cb98d29943a49d1608adb68475838ad2e65.yaml",
+     "bugs/issue-c92d34e10038ba6b9acfd7e3dfb2b154e463baba.yaml",
+     "bugs/project.yaml",
+     "lib/rforce.rb",
+     "lib/rforce/binding.rb",
+     "lib/rforce/method_keys.rb",
+     "lib/rforce/soap_pullable.rb",
+     "lib/rforce/soap_response.rb",
+     "lib/rforce/soap_response_expat.rb",
+     "lib/rforce/soap_response_hpricot.rb",
+     "lib/rforce/soap_response_nokogiri.rb",
+     "lib/rforce/soap_response_rexml.rb",
+     "lib/rforce/version.rb",
+     "spec/rforce_spec.rb",
+     "spec/soap-response.xml",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "tasks/timing.rake",
+     "test/oauth_tests.rb",
+     "wsdl/README.html",
+     "wsdl/README.txt",
+     "wsdl/ca.pem",
+     "wsdl/default.rb",
+     "wsdl/defaultDriver.rb",
+     "wsdl/orderedhash.rb",
+     "wsdl/partner.wsdl.xml",
+     "wsdl/partner.wsdl.xml.old",
+     "wsdl/sample/create.rb",
+     "wsdl/sample/describeGlobal.rb",
+     "wsdl/sample/describeSObjects.rb",
+     "wsdl/sample/getServerTimestamp.rb",
+     "wsdl/sample/query.rb",
+     "wsdl/sample/queryMore.rb",
+     "wsdl/sample/retrieve.rb",
+     "wsdl/sforceDriver.rb",
+     "wsdl/soap/property",
+     "wsdl/wsdl.rb"
+  ]
+  s.homepage = %q{http://github.com/aq1018/rforce}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{A simple, usable binding to the SalesForce API.}
+  s.test_files = [
+    "spec/rforce_spec.rb",
+     "spec/spec_helper.rb",
+     "test/oauth_tests.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<builder>, [">= 2.0.0"])
+      s.add_runtime_dependency(%q<nokogiri>, ["~> 1.4.4"])
+      s.add_runtime_dependency(%q<oauth>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 1.3"])
+    else
+      s.add_dependency(%q<builder>, [">= 2.0.0"])
+      s.add_dependency(%q<nokogiri>, ["~> 1.4.4"])
+      s.add_dependency(%q<oauth>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 1.3"])
+    end
+  else
+    s.add_dependency(%q<builder>, [">= 2.0.0"])
+    s.add_dependency(%q<nokogiri>, ["~> 1.4.4"])
+    s.add_dependency(%q<oauth>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 1.3"])
+  end
+end
+

data/bugs/issue-09d998dc3f9d6e8928598fd5d9c6627102dedd65.yaml

@@ -0,0 +1,18 @@
+--- !ditz.rubyforge.org,2008-03-06/issue 
+title: Investigate libxml
+desc: The libxml-ruby project just released an updated gem, and it's reputed to be fast and stable.  We should investigate it as an alternative parser.
+type: :feature
+component: rforce
+release: 
+reporter: Luigi Montanez <luigi.montanez@gmail.com>
+status: :unstarted
+disposition: 
+creation_time: 2008-07-23 17:15:33.479204 Z
+references: []
+
+id: 09d998dc3f9d6e8928598fd5d9c6627102dedd65
+log_events: 
+- - 2008-07-23 17:15:36.027132 Z
+  - Ian Dees <undees@gmail.com>
+  - created
+  - ""

data/bugs/issue-1b668248120eb4fd055f0ea6b75ff807f6955936.yaml

@@ -0,0 +1,22 @@
+--- !ditz.rubyforge.org,2008-03-06/issue 
+title: Ruby 1.9 compatibility
+desc: Syntax, specs, and functional.
+type: :task
+component: rforce
+release: "0.3"
+reporter: Ian Dees <undees@gmail.com>
+status: :closed
+disposition: :fixed
+creation_time: 2009-04-16 06:27:47.790789 Z
+references: []
+
+id: 1b668248120eb4fd055f0ea6b75ff807f6955936
+log_events: 
+- - 2009-04-16 06:27:51.734012 Z
+  - Ian Dees <undees@gmail.com>
+  - created
+  - ""
+- - 2009-04-16 19:27:46.187665 Z
+  - Ian Dees <undees@gmail.com>
+  - closed with disposition fixed
+  - Support REXML and Hpricot on 1.9, degrade gracefully.

data/bugs/issue-3ef7a7c5c7e38fb76e1f53e1b67f45559e21b104.yaml

@@ -0,0 +1,18 @@
+--- !ditz.rubyforge.org,2008-03-06/issue 
+title: Do something with expand()
+desc: expand() was just dumped into the RForce namespace as a minimal step in the direction of testability.  There's probably a much better home for it.
+type: :task
+component: rforce
+release: 
+reporter: Ian Dees <undees@gmail.com>
+status: :unstarted
+disposition: 
+creation_time: 2008-07-23 17:16:45.714702 Z
+references: []
+
+id: 3ef7a7c5c7e38fb76e1f53e1b67f45559e21b104
+log_events: 
+- - 2008-07-23 17:16:47.083713 Z
+  - Ian Dees <undees@gmail.com>
+  - created
+  - ""

data/bugs/issue-a7a87cb98d29943a49d1608adb68475838ad2e65.yaml

@@ -0,0 +1,22 @@
+--- !ditz.rubyforge.org,2008-03-06/issue 
+title: Binding#call_remote should use parse()
+desc: Search for uses of the old API (SoapResponse#new) and replace with the new API (SoapResponse#parse).
+type: :bugfix
+component: rforce
+release: "0.3"
+reporter: Ian Dees <undees@gmail.com>
+status: :closed
+disposition: :fixed
+creation_time: 2008-07-28 05:37:21.978938 Z
+references: []
+
+id: a7a87cb98d29943a49d1608adb68475838ad2e65
+log_events: 
+- - 2008-07-28 05:37:24.755692 Z
+  - Ian Dees <undees@gmail.com>
+  - created
+  - ""
+- - 2008-07-28 05:39:29.817686 Z
+  - Ian Dees <undees@gmail.com>
+  - closed issue with disposition fixed
+  - Done.

data/bugs/issue-c92d34e10038ba6b9acfd7e3dfb2b154e463baba.yaml

@@ -0,0 +1,29 @@
+--- !ditz.rubyforge.org,2008-03-06/issue 
+title: Select XML parser at runtime
+desc: |-
+  XML parsing is done by three different classes: SoapResponse, SoapResponseHpricot, and SoapResponseExpat.  The Binding class, in a holdover from the old days, is hard-coded to use SoapResponse.
+  
+  At the very least, we should scan the installed libraries / gems and choose the fastest one available.  We might also allow Binding's initializer to pass in a specific parser.
+type: :task
+component: rforce
+release: "0.3"
+reporter: Ian Dees <undees@gmail.com>
+status: :closed
+disposition: :fixed
+creation_time: 2008-07-23 17:10:22.283059 Z
+references: []
+
+id: c92d34e10038ba6b9acfd7e3dfb2b154e463baba
+log_events: 
+- - 2008-07-23 17:10:29.352269 Z
+  - Ian Dees <undees@gmail.com>
+  - created
+  - ""
+- - 2008-07-28 05:37:48.378891 Z
+  - Ian Dees <undees@gmail.com>
+  - assigned to release 0.3 from unassigned
+  - ""
+- - 2008-07-28 05:39:05.294916 Z
+  - Ian Dees <undees@gmail.com>
+  - closed issue with disposition fixed
+  - Used the simple fix of seeing which constants are defined and assigning SoapResponse based on that.

data/bugs/project.yaml

@@ -0,0 +1,16 @@
+--- !ditz.rubyforge.org,2008-03-06/project 
+name: rforce
+version: "0.3"
+components: 
+- !ditz.rubyforge.org,2008-03-06/component 
+  name: rforce
+releases: 
+- !ditz.rubyforge.org,2008-03-06/release 
+  name: "0.3"
+  status: :unreleased
+  release_time: 
+  log_events: 
+  - - 2008-07-28 05:35:54.153742 Z
+    - Ian Dees <undees@gmail.com>
+    - created
+    - Will be ready for ActiveSalesforce.

data/lib/rforce.rb

@@ -0,0 +1,88 @@
+=begin
+Copyright (c) 2005-2010 Ian Dees and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+=end
+
+#  RForce is a simple Ruby binding to the SalesForce CRM system.
+#  Rather than enforcing adherence to the sforce.com schema,
+#  RForce assumes you are familiar with the API.  Ruby method names
+#  become SOAP method names.  Nested Ruby hashes become nested
+#  XML elements.
+#
+#  Example:
+#
+#    binding = RForce::Binding.new 'https://www.salesforce.com/services/Soap/u/10.0'
+#    binding.login 'username', 'password'
+#    answer = binding.search(
+#      :searchString =>
+#        'find {Some Account Name} in name fields returning account(id)')
+#    account_id = answer.searchResponse.result.searchRecords.record.Id
+#
+#    opportunity = {
+#      :accountId => account_id,
+#      :amount => "10.00",
+#      :name => "New sale",
+#      :closeDate => "2005-09-01",
+#      :stageName => "Closed Won"
+#    }
+#
+#    binding.create 'sObject {"xsi:type" => "Opportunity"}' => opportunity
+#
+
+require 'rforce/binding'
+require 'rforce/soap_response'
+
+
+module RForce
+  # Expand Ruby data structures into XML.
+  def expand(builder, args, xmlns = nil)
+    # Nest arrays: [:a, 1, :b, 2] => [[:a, 1], [:b, 2]]
+    if (args.class == Array)
+      args.each_index{|i| args[i, 2] = [args[i, 2]]}
+    end
+
+    args.each do |key, value|
+      attributes = xmlns ? {:xmlns => xmlns} : {}
+
+      # If the XML tag requires attributes,
+      # the tag name will contain a space
+      # followed by a string representation
+      # of a hash of attributes.
+      #
+      # e.g. 'sObject {"xsi:type" => "Opportunity"}'
+      # becomes <sObject xsi:type="Opportunity>...</sObject>
+      if key.is_a? String
+        key, modifier = key.split(' ', 2)
+
+        attributes.merge!(eval(modifier)) if modifier
+      end
+
+      # Create an XML element and fill it with this
+      # value's sub-items.
+      case value
+      when Hash, Array then
+        builder.tag!(key, attributes) do expand builder, value; end
+
+      when String then
+        builder.tag!(key, attributes) { builder.text! value }
+      end
+    end
+  end
+end