rcarvalho-jigsaw 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+group :development, :test do
+  gem "rspec", "~> 2.3.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov", ">= 0"
+  gem "webmock"
+end
+
+gem "httparty"
+gem "activesupport"
+gem "i18n"

data/Gemfile.lock

@@ -0,0 +1,43 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.1.0)
+      multi_json (~> 1.0)
+    addressable (2.2.6)
+    crack (0.1.8)
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    httparty (0.7.8)
+      crack (= 0.1.8)
+    i18n (0.6.0)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    multi_json (1.0.3)
+    rake (0.9.2)
+    rcov (0.9.10)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    webmock (1.7.6)
+      addressable (> 2.2.5, ~> 2.2)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  bundler (~> 1.0.0)
+  httparty
+  i18n
+  jeweler (~> 1.6.4)
+  rcov
+  rspec (~> 2.3.0)
+  webmock

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Matthew Bellantoni
+
+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.md

@@ -0,0 +1,113 @@
+# Jigsaw
+
+This gem provides a Ruby wrapper around the Jigsaw API, using HTTParty.  Currently, only Company Search is supported.
+
+
+## Obtaining an API key
+
+To be able to use this gem, you'll need a Jigsaw Developer API key. To request an API key, point your browser to
+http://developer.jigsaw.com/member/register and follow the instructions there.
+
+
+## Installing the gem
+
+To use this gem, install it with <tt>gem install jigsaw</tt> or add it to your Gemfile:
+
+    gem 'jigsaw'
+
+And install it with <tt>bundle install</tt>
+
+
+## Usage
+
+### Retrieving a list of companies
+
+You can search for companies and you'll receive three pieces of information:
+
+1. The number of hits found by this search.
+2. The number of records being returned.
+3. The actual records as an array of JigSaw::CompanyBasic objects.
+
+Searches are refined using these arguments.
+
+* *updated_since*: The format is yyyy-MM-dd, for example 2008-10-31
+* *name*:Oracle, IBM, www.jigsaw.com , AAPL
+* *country*: Country name.  See developer documentation for details.
+* *state*: Two letter state name abbreviations.  See developer documentation for details.
+* *metro_area*: Major metropolitan areas by name.  See developer documentation for details.
+* *area_code*: The digit area code.
+* *zip_code*: Five or nine digit zip code.
+* *industry*: Industry value. See developer documentation for details.
+* *sub_industry*: Sub-industry value. See developer documentation for details.
+* *employees*: Employee size range.  See developer documentation for details.
+* *revenue*: Company revenue range.  See developer documentation for details.
+* *ownership*: public, private, government, other
+* *website_type*: .com, .gov, .org, .biz, .info, .net, .edu, .mil
+* *fortune_rank*: 500, 1000
+* *include_graveyard*: Is this company dead? false (default), true
+* *order*: ASC, DESC, the default is no order
+* *order_by*: Company, City, State, updatedSince
+* *offset*: The start point for records that are returned.
+* *page_size*: The number of records that are returned per page. Default 50. Maximum 100.
+
+Details for argument values can be found in the [Data Keys and Values section](http://developer.jigsaw.com/documentation/search_and_get_api_guide/6_Data_Keys_and_Values) of
+the developer documentation.
+
+First register a new Client:
+
+    @client = Jigsaw::Client.new(API_KEY)
+
+Then retrieve a list of companies in zip code "02478":
+
+    @total_hits, @fetched_hits, @companies = @client.company_search({:zip_code => "02478"})
+
+Search by zip code and return a single page of 10 results:
+
+    @total_hits, @fetched_hits, @companies = @client.company_search({:zip_code => "02478", :page_size => 10, :offset => 0})
+
+Search by zip code and return all results:
+
+    @total_hits, @fetched_hits, @companies = @client.company_search({:zip_code => "02478"}, true)
+
+Search by zip code *and* return all results:
+
+    @total_hits, @fetched_hits, @companies = @client.company_search({:zip_code => "02478", :ownership => "private"}, true)
+
+### Retrieving company details
+
+Not yet implemented.
+
+### Retrieving a list of contacts
+
+Not yet implemented.
+
+### Retrieving contact details
+
+Not yet implemented.
+
+## To Do
+* Add lookup of detailed company info. (Planned for 0.2.0)
+* Handle errors at the Request level. (Planned for ???)
+* The rest of the API! (Planned for ???)
+
+## Acknowledgement
+
+This gem is patterned after Marcel de Graaf's [google_pages gem](https://github.com/marceldegraaf/google_places).
+
+## Contributing to jigsaw
+
+You're very welcome to add functionality to this gem. To do so, follow these steps:
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2011 Matthew Bellantoni. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "jigsaw"
+  gem.homepage = "http://github.com/mjbellantoni/jigsaw"
+  gem.license = "MIT"
+  gem.summary = %Q{ Jigsaw.com API.  Incomplete coverage.  }
+  gem.description = gem.summary
+  gem.email = "mjbellantoni@yahoo.com"
+  gem.authors = ["Matthew Bellantoni"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "jigsaw #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/jigsaw.gemspec

@@ -0,0 +1,80 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "rcarvalho-jigsaw"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Matthew Bellantoni"]
+  s.date = "2011-09-11"
+  s.description = "Jigsaw.com API.  Incomplete coverage."
+  s.email = "mjbellantoni@yahoo.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "jigsaw.gemspec",
+    "lib/jigsaw.rb",
+    "lib/jigsaw/client.rb",
+    "lib/jigsaw/company_search.rb",
+    "lib/jigsaw/contact_search.rb",
+    "lib/jigsaw/company.rb",
+    "lib/jigsaw/request.rb",
+    "spec/jigsaw/client_spec.rb",
+    "spec/jigsaw/company_basic_spec.rb",
+    "spec/jigsaw/request_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/webmock/company_search_webmock_helpers.rb"
+  ]
+  s.homepage = "http://github.com/mjbellantoni/jigsaw"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "Jigsaw.com API.  Incomplete coverage."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_runtime_dependency(%q<i18n>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<webmock>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<i18n>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<webmock>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<i18n>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<webmock>, [">= 0"])
+  end
+end
+

data/lib/jigsaw.rb

@@ -0,0 +1,5 @@
+require 'httparty'
+
+%w(client request company_search contact_search company).each do |file|
+  require File.join(File.dirname(__FILE__), 'jigsaw', file)
+end

data/lib/jigsaw/client.rb

@@ -0,0 +1,23 @@
+module Jigsaw
+  class Client
+
+    attr_reader :api_key
+
+    def initialize(api_key)
+      @api_key = api_key
+    end
+
+    def company_search(options = {}, fetch_all = false)
+      CompanySearch.list(@api_key, options, fetch_all)
+    end
+    
+    def contact_search(options = {}, fetch_all = false)
+      ContactSearch.list(@api_key, options, fetch_all)
+    end
+    
+    def company(id, options = {})
+      Company.find(@api_key, id, options)
+    end
+
+  end
+end

data/lib/jigsaw/company.rb

@@ -0,0 +1,57 @@
+require 'active_support/inflector'
+
+module Jigsaw
+
+  class Company
+    
+    attr_accessor :companyId, :name, :phone, :website, :stockSymbol, :stockExchange, :ownership, :employeeCount, :employeeRange, :revenue, :revenueRange, :industry1, :industry2, :industry3, :subIndustry1, :subIndustry2, :subIndustry3, :sicCode, :address, :city, :state, :zip, :country, :activeContact, :createdOn, :linkInJigsaw, :graveyarded, :updatedDate, :currentWiki, :currentLogo
+
+    def initialize(json_object)
+      @companyId        = json_object['companyId']  
+      @name             = json_object['name']         
+      @phone            = json_object['phone']        
+      @website          = json_object['website']      
+      @stockSymbol      = json_object['stockSymbol']  
+      @stockExchange    = json_object['stockExchange']
+      @ownership        = json_object['ownership']    
+      @employeeCount    = json_object['employeeCount']
+      @employeeRange    = json_object['employeeRange']
+      @revenue          = json_object['revenue']      
+      @revenueRange     = json_object['revenueRange'] 
+      @industry1        = json_object['industry1']    
+      @industry2        = json_object['industry2']    
+      @industry3        = json_object['industry3']    
+      @subIndustry1     = json_object['subIndustry1'] 
+      @subIndustry2     = json_object['subIndustry2'] 
+      @subIndustry3     = json_object['subIndustry3'] 
+      @sicCode          = json_object['sicCode']      
+      @address          = json_object['address']      
+      @city             = json_object['city']         
+      @state            = json_object['state']        
+      @zip              = json_object['zip']          
+      @country          = json_object['country']      
+      @activeContact    = json_object['activeContact']
+      @createdOn        = json_object['createdOn']    
+      @linkInJigsaw     = json_object['linkInJigsaw'] 
+      @graveyarded      = json_object['graveyarded']  
+      @updatedDate      = json_object['updatedDate']  
+      @currentWiki      = json_object['currentWiki']
+      @currentLogo      = json_object['currentLogo']
+    end    
+    
+    def self.find(api_key, id, options)
+      
+      options[:token] = api_key
+
+      response = Request.company(id, options)
+
+      company = self.new(response['companies'].first)
+      
+      # Return the hits info and the list of the company
+      company
+      
+    end
+    
+  end
+  
+end

data/lib/jigsaw/company_search.rb

@@ -0,0 +1,65 @@
+require 'active_support/inflector'
+
+module Jigsaw
+
+  class CompanySearch
+
+    attr_accessor :company_id, :name, :address, :city, :state, :zip, :country, :active_contacts, :graveyarded
+
+    def initialize(json_object)
+      @company_id      = json_object['companyId']
+      @name            = json_object['name']
+      @address         = json_object['address']
+      @city            = json_object['city']
+      @state           = json_object['state']
+      @zip             = json_object['zip']
+      @country         = json_object['country']
+      @active_contacts = json_object['activeContacts']
+      @graveyarded     = json_object['graveyarded']
+    end    
+
+
+    def self.list(api_key, options, fetch_all=false)
+
+      options[:token]     = api_key
+      options[:page_size] = options[:page_size] || 50 # 50 is the default.
+      options[:offset]    = options[:offset] || 0 # 0 is the default.
+
+      # Camelize options
+      camelized_options = {}
+      options.each do |key, value|
+        camelized_options[key.to_s.camelize(:lower)] = value
+      end
+
+      # Send one or more requests depending on the number of results, the
+      # page size and the value of fetch_all
+      companies = []
+      total_hits = nil
+      fetched_hits = 0
+      offset = options[:offset]
+
+      begin
+
+        response = Request.search_company(camelized_options)
+
+        total_hits = response['totalHits']
+        fetched_hits += response['companies'].size
+
+        companies << response['companies'].map do |result|
+          self.new(result)
+        end
+
+        #Calculate the next offset.
+        offset += options[:page_size]
+        camelized_options[:offset] = offset
+
+      end while fetch_all && (total_hits > offset)
+            
+      # Return the hits info and the list of companies
+      [total_hits, fetched_hits, companies.flatten]
+
+    end
+
+  end
+
+end

data/lib/jigsaw/contact_search.rb

@@ -0,0 +1,77 @@
+require 'active_support/inflector'
+
+module Jigsaw
+
+  class ContactSearch
+
+    attr_accessor :zip, :phone, :areaCode, :updatedDate, :seoContactURL, :state, :lastname, :firstname, :companyName, :contactURL, :contactSales, :country, :owned, :city, :title, :contactId, :email, :address, :graveyardStatus, :ownedType, :companyId
+    
+    def initialize(json_object)
+        @zip              = json_object['zip']
+        @phone            = json_object['phone']  
+        @areaCode         = json_object['areaCode']
+        @updatedDate      = json_object['updatedDate']
+        @seoContactURL    = json_object['seoContactUR']
+        @state            = json_object['state']
+        @lastname         = json_object['lastname']
+        @firstname        = json_object['firstname']
+        @companyName      = json_object['companyName']
+        @contactURL       = json_object['contactURL']
+        @contactSales     = json_object['contactSales']
+        @country          = json_object['country']
+        @owned            = json_object['owned']
+        @city             = json_object['city']
+        @title            = json_object['title']
+        @contactId        = json_object['contactId']
+        @email            = json_object['email']   
+        @address          = json_object['address']
+        @graveyardStatus  = json_object['graveyardStatus']
+        @ownedType        = json_object['ownedType']
+        @companyId        = json_object['companyId']
+    end    
+    
+    
+    def self.list(api_key, options, fetch_all=false)
+    
+      options[:token]     = api_key
+      options[:page_size] = options[:page_size] || 50 # 50 is the default.
+      options[:offset]    = options[:offset] || 0 # 0 is the default.
+    
+      # Camelize options
+      camelized_options = {}
+      options.each do |key, value|
+        camelized_options[key.to_s.camelize(:lower)] = value
+      end
+    
+      # Send one or more requests depending on the number of results, the
+      # page size and the value of fetch_all
+      contacts = []
+      total_hits = nil
+      fetched_hits = 0
+      offset = options[:offset]
+    
+      begin
+    
+        response = Request.search_contact(camelized_options)
+    
+        total_hits = response['totalHits']
+        fetched_hits += response['contacts'].size
+    
+        contacts << response['contacts'].map do |result|
+          self.new(result)
+        end
+    
+        #Calculate the next offset.
+        offset += options[:page_size]
+        camelized_options[:offset] = offset
+    
+      end while fetch_all && (total_hits > offset)
+            
+      # Return the hits info and the list of contacts
+      [total_hits, fetched_hits, contacts.flatten]
+    
+    end
+      
+  end
+
+end

data/lib/jigsaw/request.rb

@@ -0,0 +1,41 @@
+require "httparty"
+
+module Jigsaw
+
+  class Request
+
+    attr_accessor :response
+
+    include ::HTTParty
+    format :json
+
+    SEARCH_COMPANY_URL = 'https://www.jigsaw.com/rest/searchCompany.json'
+    SEARCH_CONTACT_URL = 'https://www.jigsaw.com/rest/searchContact.json'
+    COMPANY_URL        = 'https://www.jigsaw.com/rest/companies/'
+
+    def self.search_company(options = {})
+      request = new(SEARCH_COMPANY_URL, options)
+      request.parsed_response
+    end
+    
+    def self.search_contact(options = {})
+      request = new(SEARCH_CONTACT_URL, options)
+      request.parsed_response
+    end
+    
+    def self.company(id, options = {})
+      request = new(COMPANY_URL + id + ".json", options)
+      request.parsed_response
+    end
+
+    def initialize(url, options)
+      @response = self.class.get(url, :query => options)
+    end
+
+    def parsed_response
+      @response.parsed_response
+    end
+
+  end
+
+end

data/spec/jigsaw/client_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe Jigsaw::Client do
+
+  include CompanySearchWebmockHelpers
+
+  it "should not initialize without an api_key" do
+    lambda { Jigsaw::Client.new }.should raise_error
+  end
+
+  it "should initialize with an api_key" do
+    @client = Jigsaw::Client.new(api_key)
+    @client.api_key.should == api_key
+  end
+
+
+  context "a company search" do
+    
+    before(:each) do
+      stub_jigsaw_for_client_company_search
+      @client = Jigsaw::Client.new(api_key)
+      @total_hits, @fetched_hits, @companies = @client.company_search({:zip_code => "02478"}, false)      
+    end
+
+    it "tells how many hits it found " do
+      @total_hits.should == 3
+    end
+
+    it "tells how many hits it returns " do
+      @fetched_hits.should == 3
+    end
+
+    it "returns those hits " do
+      @companies.should have(3).items
+    end
+
+  end
+
+end

data/spec/jigsaw/company_basic_spec.rb

@@ -0,0 +1,54 @@
+require "spec_helper"
+
+
+
+describe Jigsaw::CompanyBasic do
+
+  include CompanySearchWebmockHelpers
+
+  context "with 9 hits and 5 hits per page" do
+    
+    before(:each) do
+      stub_jigsaw_for_page_test
+      @options = { :page_size => 5 }
+    end
+
+    context "when 'fetch_all' is true" do
+      before(:each) do
+        @total_hits, @fetched_hits, @companies = Jigsaw::CompanyBasic.list(api_key, @options, true)
+      end
+
+      it "finds 9 hits" do
+        @total_hits.should == 9
+      end
+
+      it "fetches 9 hits" do
+        @fetched_hits.should == 9
+      end
+
+      it "returns 9 companies" do
+        @companies.should have(9).items
+      end
+    end
+
+    context "when 'fetch_all' is false" do
+      before(:each) do
+        @total_hits, @fetched_hits, @companies = Jigsaw::CompanyBasic.list(api_key, @options, false)
+      end
+
+      it "finds 9 hits" do
+        @total_hits.should == 9
+      end
+
+      it "fetches 5 hits" do
+        @fetched_hits.should == 5
+      end
+
+      it "returns 5 companies" do
+        @companies.should have(5).items
+      end
+    end
+
+  end
+
+end

data/spec/jigsaw/request_spec.rb

@@ -0,0 +1,24 @@
+require "spec_helper"
+
+describe Jigsaw::Request do
+
+  include CompanySearchWebmockHelpers
+
+  context 'Listing companies' do
+
+    before(:each) do
+      stub_jigsaw_for_request
+    end
+
+    it 'should retrieve a list of companies' do
+      response = Jigsaw::Request.search_company(:token => api_key)
+      response['companies'].should_not be_empty
+    end
+
+    it 'should retrieve the number of matching companies' do
+      response = Jigsaw::Request.search_company(:token => api_key)
+      response['totalHits'].should_not be_nil
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'jigsaw'
+require 'webmock/rspec'
+
+JIGSAW_API_KEY = "abc123"
+def api_key
+  JIGSAW_API_KEY
+end
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+
+RSpec.configure do |config|
+  
+end

data/spec/support/webmock/company_search_webmock_helpers.rb

@@ -0,0 +1,140 @@
+require 'active_support/json'
+
+
+module CompanySearchWebmockHelpers
+
+  BASIC_COMPANIES = [
+    {
+      "zip" => "02142-1108",
+      "address" => "500 Kendall St",
+      "name" => "Genzyme Corporation",
+      "activeContacts" => 3514,
+      "state" => "MA",
+      "companyId" => 211909,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1453",
+      "address" => "14 Cambridge Ctr",
+      "name" => "Biogen Idec Inc.",
+      "activeContacts" => 1991,
+      "state" => "MA",
+      "companyId" => 213499,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1100",
+      "address" => "1 Broadway",
+      "name" => "Patni Americas, Inc.",
+      "activeContacts" => 867,
+      "state" => "MA",
+      "companyId" => 50666,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1413",
+      "address" => "8 Cambridge Ctr",
+      "name" => "Akamai Technologies, Inc.",
+      "activeContacts" => 535,
+      "state" => "MA",
+      "companyId" => 36097,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1519",
+      "address" => "101 Main St",
+      "name" => "Pegasystems Inc.",
+      "activeContacts" => 517,
+      "state" => "MA",
+      "companyId" => 42602,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1519",
+      "address" => "101 Main St",
+      "name" => "Endeca Technologies, Inc.",
+      "activeContacts" => 230,
+      "state" => "MA",
+      "companyId" => 143901,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1531",
+      "address" => "1 Main St",
+      "name" => "Art Technology Group, Inc. (ATG Group)",
+      "activeContacts" => 200,
+      "state" => "MA",
+      "companyId" => 90312,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1313",
+      "address" => "1 Memorial Dr",
+      "name" => "InterSystems Corp.",
+      "activeContacts" => 190,
+      "state" => "MA",
+      "companyId" => 24687,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1605",
+      "address" => "1 Cambridge Ctr",
+      "name" => "Brightcove, Inc.",
+      "activeContacts" => 144,
+      "state" => "MA",
+      "companyId" => 65820,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"},
+    {
+      "zip" => "02142-1401",
+      "address" => "9 Cambridge Ctr",
+      "name" => "Whitehead Institute for Biomedical Research",
+      "activeContacts" => 129,
+      "state" => "MA",
+      "companyId" => 68825,
+      "graveyarded" => false,
+      "city" => "Cambridge",
+      "country" => "United States"} ]
+
+
+  def stub_jigsaw_for_request
+    stub_request(:get, "http://www.jigsaw.com/rest/searchCompany.json?token=abc123").to_return(
+        :status => 200,
+        :body => ActiveSupport::JSON.encode({"totalHits" => BASIC_COMPANIES.size, "companies" => BASIC_COMPANIES }),
+        :headers => { :content_type => 'application/json' })
+  end
+
+
+  def stub_jigsaw_for_client_company_search
+    stub_request(:get, "http://www.jigsaw.com/rest/searchCompany.json?offset=0&pageSize=50&token=abc123&zipCode=02478").
+      to_return(
+        :status => 200,
+        :body => ActiveSupport::JSON.encode({"totalHits" => 3, "companies" => BASIC_COMPANIES[0..2] }),
+        :headers => { :content_type => 'application/json' })
+  end
+
+
+  def stub_jigsaw_for_page_test
+    # 9 hits, return the first 5
+    stub_request(:get, "http://www.jigsaw.com/rest/searchCompany.json?offset=0&pageSize=5&token=abc123").to_return(
+        :status => 200,
+        :body => ActiveSupport::JSON.encode({"totalHits" => 9, "companies" => BASIC_COMPANIES[0..4] }),
+        :headers => { :content_type => 'application/json' })
+
+    # 9 hits, return the last 4
+    stub_request(:get, "http://www.jigsaw.com/rest/searchCompany.json?offset=5&pageSize=5&token=abc123").to_return(
+        :status => 200,
+        :body => ActiveSupport::JSON.encode({"totalHits" => 9, "companies" => BASIC_COMPANIES[5..8] }),
+        :headers => { :content_type => 'application/json' })
+  end
+
+end

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification 
+name: rcarvalho-jigsaw
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Matthew Bellantoni
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-11 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: i18n
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 6
+        - 4
+        version: 1.6.4
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id008
+description: Jigsaw.com API.  Incomplete coverage.
+email: mjbellantoni@yahoo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.md
+files: 
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- jigsaw.gemspec
+- lib/jigsaw.rb
+- lib/jigsaw/client.rb
+- lib/jigsaw/company_search.rb
+- lib/jigsaw/contact_search.rb
+- lib/jigsaw/company.rb
+- lib/jigsaw/request.rb
+- spec/jigsaw/client_spec.rb
+- spec/jigsaw/company_basic_spec.rb
+- spec/jigsaw/request_spec.rb
+- spec/spec_helper.rb
+- spec/support/webmock/company_search_webmock_helpers.rb
+has_rdoc: true
+homepage: http://github.com/mjbellantoni/jigsaw
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Jigsaw.com API.  Incomplete coverage.
+test_files: []
+