Recalls 0.1

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in gem_template.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,65 @@
+PATH
+  remote: .
+  specs:
+    Recalls (0.0)
+      faraday (~> 0.5.3)
+      faraday_middleware (~> 0.3.0)
+      hashie (~> 0.4.0)
+      multi_json (~> 0.0.5)
+      multi_xml (~> 0.2.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.5.0)
+    addressable (2.2.5)
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    faraday (0.5.7)
+      addressable (~> 2.2.4)
+      multipart-post (~> 1.1.0)
+      rack (< 2, >= 1.1.0)
+    faraday_middleware (0.3.2)
+      faraday (~> 0.5.4)
+    hashie (0.4.0)
+    json (1.5.1)
+    maruku (0.6.0)
+      syntax (>= 1.0.0)
+    multi_json (0.0.5)
+    multi_xml (0.2.2)
+    multipart-post (1.1.1)
+    nokogiri (1.4.4)
+    rack (1.2.2)
+    rake (0.8.7)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.1)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+    simplecov (0.4.2)
+      simplecov-html (~> 0.4.4)
+    simplecov-html (0.4.4)
+    syntax (1.0.0)
+    webmock (1.6.2)
+      addressable (>= 2.2.2)
+      crack (>= 0.1.7)
+    yard (0.6.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  Recalls!
+  ZenTest (~> 4.4)
+  bundler (~> 1.0)
+  json (~> 1.4)
+  maruku (~> 0.6)
+  nokogiri (~> 1.4)
+  rake (~> 0.8)
+  rspec (~> 2.1)
+  simplecov (~> 0.3)
+  webmock (~> 1.5)
+  yard (~> 0.6)

data/LICENSE.mkd

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Code for America Laboratories
+
+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.mkd

@@ -0,0 +1,64 @@
+Recalls API
+=======
+A Ruby wrapper for the USA Search Product Recall API at http://search.usa.gov/api.
+
+Does your project or organization use this gem?
+------------------------------------------
+Add it to the [apps](http://github.com/codeforamerica/recalls_ruby/wiki/apps) wiki!
+
+Installation
+------------
+    $ [sudo] gem install recalls
+
+Usage Examples
+--------------
+    require 'recalls'
+    
+    Recalls.configure do |config|
+      config.api_key = 'yourkeyforpostrequests'
+    end
+    
+    # Return product recalls with the keywords cheese
+    #   Recalls.search(:query => "cheese")
+    
+Contributing
+------------
+In the spirit of [free software](http://www.fsf.org/licensing/essays/free-sw.html), **everyone** is encouraged to help improve this project.
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code (**no patch is too small**: fix typos, add comments, clean up inconsistent whitespace)
+* by refactoring code
+* by resolving [issues](http://github.com/cfalabs/Recalls/issues)
+* by reviewing patches
+
+Submitting an Issue
+-------------------
+We use the [GitHub issue tracker](http://github.com/cfalabs/Recalls/issues) to track bugs and
+features. Before submitting a bug report or feature request, check to make sure it hasn't already
+been submitted. You can indicate support for an existing issuse by voting it up. When submitting a
+bug report, please include a [Gist](http://gist.github.com/) that includes a stack trace and any
+details that may be necessary to reproduce the bug, including your gem version, Ruby version, and
+operating system. Ideally, a bug report should include a pull request with failing specs.
+
+Submitting a Pull Request
+-------------------------
+1. Fork the project.
+2. Create a topic branch.
+3. Implement your feature or bug fix.
+4. Add documentation for your feature or bug fix.
+5. Run <tt>bundle exec rake doc:yard</tt>. If your changes are not 100% documented, go back to step 4.
+6. Add specs for your feature or bug fix.
+7. Run <tt>bundle exec rake spec</tt>. If your changes are not 100% covered, go back to step 6.
+8. Commit and push your changes.
+9. Submit a pull request. Please do not include changes to the gemspec, version, or history file. (If you want to create your own version for some reason, please do so in a separate commit.)
+
+Copyright
+---------
+Copyright (c) 2010 Code for America Laboratories
+See [LICENSE](https://github.com/cfalabs/Recalls/blob/master/LICENSE.mkd) for details.

data/Rakefile

@@ -0,0 +1,16 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :test => :spec
+
+require 'yard'
+namespace :doc do
+  YARD::Rake::YardocTask.new do |task|
+    task.files   = ['LICENSE.md', 'lib/**/*.rb']
+    task.options = ['--markup', 'markdown']
+  end
+end

data/autotest/discover.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/lib/faraday/multipart.rb

@@ -0,0 +1,29 @@
+require 'faraday'
+
+# @api private
+module Faraday
+  class Request::Multipart < Faraday::Middleware
+    def call(env)
+      if env[:body].is_a?(Hash)
+        env[:body].each do |key, value|
+          if value.is_a?(File)
+            env[:body][key] = Faraday::UploadIO.new(value, mime_type(value), value.path)
+          end
+        end
+      end
+
+      @app.call(env)
+    end
+
+    private
+
+    def mime_type(file)
+      case file.path
+        when /\.jpe?g/i then 'image/jpeg'
+        when /\.gif$/i then 'image/gif'
+        when /\.png$/i then 'image/png'
+        else 'application/octet-stream'
+      end
+    end
+  end
+end

data/lib/faraday/raise_error.rb

@@ -0,0 +1,31 @@
+require 'faraday'
+
+# @api private
+module Faraday
+  class Response::RaiseError < Response::Middleware
+    def on_complete(response)
+      case response[:status].to_i
+      when 400
+        raise Open311::BadRequest, error_message(response)
+      when 401
+        raise Open311::Unauthorized, error_message(response)
+      when 403
+        raise Open311::Forbidden, error_message(response)
+      when 404
+        raise Open311::NotFound, error_message(response)
+      when 406
+        raise Open311::NotAcceptable, error_message(response)
+      when 500
+        raise Open311::InternalServerError, error_message(response)
+      when 502
+        raise Open311::BadGateway, error_message(response)
+      when 503
+        raise Open311::ServiceUnavailable, error_message(response)
+      end
+    end
+
+    def error_message(response)
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:response_headers]['status']}#{(': ' + response[:body]['error']) if response[:body] && response[:body]['error']}"
+    end
+  end
+end

data/lib/faraday/response/raise_error.rb

@@ -0,0 +1,31 @@
+require 'faraday'
+
+# @api private
+module Faraday
+  class Response::RaiseError < Response::Middleware
+    def on_complete(response)
+      case response[:status].to_i
+      when 400
+        raise Open311::BadRequest, error_message(response)
+      when 401
+        raise Open311::Unauthorized, error_message(response)
+      when 403
+        raise Open311::Forbidden, error_message(response)
+      when 404
+        raise Open311::NotFound, error_message(response)
+      when 406
+        raise Open311::NotAcceptable, error_message(response)
+      when 500
+        raise Open311::InternalServerError, error_message(response)
+      when 502
+        raise Open311::BadGateway, error_message(response)
+      when 503
+        raise Open311::ServiceUnavailable, error_message(response)
+      end
+    end
+
+    def error_message(response)
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:response_headers]['status']}#{(': ' + response[:body]['error']) if response[:body] && response[:body]['error']}"
+    end
+  end
+end

data/lib/recalls.rb

@@ -0,0 +1,51 @@
+require ::File.expand_path('../recalls/version', __FILE__)
+require ::File.expand_path('../recalls/configuration.rb', __FILE__)
+require ::File.expand_path('../recalls/client', __FILE__)
+
+module Recalls
+  extend Configuration
+
+  # Alias for Recalls::Client.new
+  #
+  # @return [Recalls::Client]
+  def self.client(options={})
+    Recalls::Client.new(options)
+  end
+
+  # Delegate to Recalls::Client
+  def self.method_missing(method, *args, &block)
+    return super unless client.respond_to?(method)
+    client.send(method, *args, &block)
+  end
+  
+  def self.respond_to?(method, include_private=false)
+    client.respond_to?(method, include_private) || super(method, include_private)
+  end
+
+  # Custom error class for rescuing from all Recalls errors
+  class Error < StandardError; end
+
+  # Raised when Recalls returns a 400 HTTP status code
+  class BadRequest < Error; end
+
+  # Raised when Recalls returns a 401 HTTP status code
+  class Unauthorized < Error; end
+
+  # Raised when Recalls returns a 403 HTTP status code
+  class Forbidden < Error; end
+
+  # Raised when Recalls returns a 404 HTTP status code
+  class NotFound < Error; end
+
+  # Raised when Recalls returns a 406 HTTP status code
+  class NotAcceptable < Error; end
+
+  # Raised when Recalls returns a 500 HTTP status code
+  class InternalServerError < Error; end
+
+  # Raised when Recalls returns a 502 HTTP status code
+  class BadGateway < Error; end
+
+  # Raised when Recalls returns a 503 HTTP status code
+  class ServiceUnavailable < Error; end
+end

data/lib/recalls/client.rb

@@ -0,0 +1,21 @@
+require ::File.expand_path('../client/connection', __FILE__)
+require ::File.expand_path('../client/request', __FILE__)
+require ::File.expand_path('../client/products.rb', __FILE__)
+
+
+module Recalls
+  class Client
+    attr_accessor *Configuration::VALID_OPTIONS_KEYS
+
+    def initialize(options={})
+      options = Recalls.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    include Recalls::Client::Connection
+    include Recalls::Client::Request
+    include Recalls::Client::Products     
+  end
+end

data/lib/recalls/client/connection.rb

@@ -0,0 +1,36 @@
+require 'faraday_middleware'
+Dir[File.expand_path('../../../faraday/*.rb', __FILE__)].each{|file| require file}
+
+module Recalls
+  class Client
+    # @private
+    module Connection
+      private
+
+      def connection(raw=false)
+        options = {
+          :headers => {'Accept' => 'application/json'},
+          :proxy => proxy,
+          :ssl => {:verify => false},
+          :url => 'http://search.usa.gov/search/recalls' + endpoint.to_s
+        }
+
+        Faraday::Connection.new(options) do |connection|
+          connection.use Faraday::Request::Multipart
+          unless raw
+            connection.use Faraday::Response::Mashify
+            case format.to_s.downcase
+            when 'json'
+              connection.use Faraday::Response::ParseJson
+            when 'xml'
+              connection.use Faraday::Response::ParseXml
+            end
+          end
+          connection.use Faraday::Response::RaiseError
+          connection.adapter(adapter)
+        end
+      end
+    end
+  end
+end
+

data/lib/recalls/client/products.rb

@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+
+module Recalls
+  class Client
+    module Products
+    include Recalls::Client::Connection
+    
+    # Returns a hash of products matching the search.
+    #
+    # @return {Hash}
+    # @param query
+    # @param start_date
+    # @param end_date
+    # @param organization opptions NHSTA, CPSC, CDC
+    # @param upc
+    # @param sort sort=date 
+    # @param page
+    # @param year only for NHSTA (Traffic)
+    # @param make only for NHSTA (Traffic)
+    # @param model only for NHSTA (Traffic)        
+    # @see http://search.usa.gov/api/recalls
+    # @example Returns results based upon queries
+    #   Recalls.search(:query => "bad cheese")
+    
+      def search(options = {})
+        options.merge!({:format => "json"})                
+        response = get('', options) rescue "Invalid API Key"  
+      end
+      
+    end
+  end
+end

data/lib/recalls/client/request.rb

@@ -0,0 +1,37 @@
+module Recalls
+  class Client
+    module Request
+      def get(path, options={}, raw=false)
+        request(:get, path, options, raw)
+      end
+
+      def post(path, options={}, raw=false)
+        request(:post, path, options, raw)
+      end
+
+      def put(path, options={}, raw=false)
+        request(:put, path, options, raw)
+      end
+
+      def delete(path, options={}, raw=false)
+        request(:delete, path, options, raw)
+      end
+
+      private
+
+      def request(method, path, options, raw)
+        response = connection(raw).send(method) do |request|
+          case method
+          when :get, :delete
+            request.url(path, options)
+          when :post, :put
+            request.path = path
+            request.body = options unless options.empty?
+          end
+        end
+        raw ? response : response.body
+      end
+
+    end
+  end
+end

data/lib/recalls/configuration.rb

@@ -0,0 +1,45 @@
+require 'faraday'
+
+module Recalls
+  module Configuration
+    VALID_OPTIONS_KEYS = [
+      :adapter,
+      :endpoint,
+      :user_agent,
+      :api_key,
+      :proxy,
+      :format].freeze
+
+    VALID_FORMATS = [:json].freeze
+
+    DEFAULT_ADAPTER      = Faraday.default_adapter
+    DEFAULT_ENDPOINT     = nil
+    DEFAULT_PROXY        = nil
+    DEFAULT_FORMAT       = :json
+    DEFAULT_API_KEY      = nil.freeze    
+    DEFAULT_USER_AGENT   = "Recalls Recalls Ruby Gem #{Recalls::VERSION}".freeze
+
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    def self.extended(base)
+      base.reset
+    end
+
+    def configure
+      yield self
+    end
+
+    def options
+      VALID_OPTIONS_KEYS.inject({}){|o,k| o.merge!(k => send(k)) }
+    end
+
+    def reset
+      self.adapter      = DEFAULT_ADAPTER
+      self.user_agent   = DEFAULT_USER_AGENT
+      self.endpoint     = DEFAULT_ENDPOINT
+      self.format       = DEFAULT_FORMAT
+      self.proxy        = DEFAULT_FORMAT
+      self.api_key      = DEFAULT_API_KEY      
+    end
+  end
+end

data/lib/recalls/version.rb

@@ -0,0 +1,3 @@
+module Recalls
+  VERSION = "0.1"
+end

data/recalls.gemspec

@@ -0,0 +1,36 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/recalls/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.add_development_dependency("bundler", "~> 1.0")
+  s.add_development_dependency("json", "~> 1.4")
+  s.add_development_dependency("maruku", "~> 0.6")
+  s.add_development_dependency("nokogiri", "~> 1.4")
+  s.add_development_dependency("rake", "~> 0.8")
+  s.add_development_dependency("rspec", "~> 2.1")
+  s.add_development_dependency("simplecov", "~> 0.3")
+  s.add_development_dependency("webmock", "~> 1.5")
+  s.add_development_dependency("yard", "~> 0.6")
+  s.add_development_dependency("ZenTest", "~> 4.4")
+  s.add_runtime_dependency("hashie", "~> 0.4.0")
+  s.add_runtime_dependency("faraday", "~> 0.5.3")
+  s.add_runtime_dependency("faraday_middleware", "~> 0.3.0")
+  s.add_runtime_dependency("multi_json", "~> 0.0.5")
+  s.add_runtime_dependency("multi_xml", "~> 0.2.0")
+  s.authors = ["Dan Melton", "Erik Michaels-Ober"]
+  s.summary = %q{A Ruby wrapper for the Recalls APIs.}
+  s.post_install_message =<<eos
+Using this gem in your project or organization? Add it to the apps wiki!
+https://github.com/codeforamerica/Recalls/wiki/apps
+eos
+  s.email = ["dan@codeforamerica.org"]
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.files = `git ls-files`.split("\n")
+  s.homepage = "http://rubygems.org/gems/recalls"
+  s.name = "Recalls"
+  s.platform = Gem::Platform::RUBY
+  s.require_paths = ["lib"]
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.3.6") if s.respond_to? :required_rubygems_version=
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.version = Recalls::VERSION
+end

data/spec/fixtures/recalls_search_response.json

@@ -0,0 +1 @@
+{"success":{"total":21840,"results":[{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207989.htm","description":"H-E-B, committed to the safety of customers, is issuing a precautionary recall for H-E-B French Onion Dip. H-E-B is expanding the recall announced Thursday. In addition to the product with code dates of 4/15/2010 and 4/20/2010, new affected code dates are 4/23/2010 and 4/24/2010 in the 8 ounce, 16 ounce and 24 ounce sizes.","summary":"Consumer Alert Precautionary Recall issued for H-E-B French Onion Dip","recall_number":"cebeea25a5","organization":"CDC","recall_date":"2010-04-11"},{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207818.htm","description":"McCormick & Company, Incorporated (NYSE:MKC) has announced a voluntary recall of McCormick Fajitas Seasoning Mix, with UPC Code 5210002121 and “BEST BY” dates of JAN 16 12 AH and JAN 16 12 CH.  McCormick Fajitas Seasoning Mix packages with these date codes contain undeclared wheat and milk ingredients.","summary":"Mccormick & Company Recalls Mccormick Fajitas Seasoning Mix Due To Unlabeled Wheat And Milk Ingredients","recall_number":"3cee757aca","organization":"CDC","recall_date":"2010-04-08"},{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207627.htm","description":"Del Bueno of Grandview, WA is recalling all size packages of Queso Fresco Fresh Cheese because it has the potential to be contaminated with Listeria monocytogenes, an organism which can cause serious and sometimes fatal infections in young children, frail or elderly people, and others with weakened immune systems. Although healthy individuals may suffer only short-term symptoms such as high fever, severe headache, stiffness, nausea, abdominal pain and diarrhea, Listeria infection can cause miscarriages and stillbirths among pregnant women.","summary":"Del Bueno Amends Recall of Queso Fresco Cheese Because of Possible Health Risk","recall_number":"090bbb3708","organization":"CDC","recall_date":"2010-04-06"},{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207494.htm","description":"Del Bueno of Grandview, WA is recalling 16oz. packages of Queso Fresco Fresh Cheese because it has the potential to be contaminated with Listeria monocytogenes, an organism which can cause serious and sometimes fatal infections in young children, frail or elderly people, and others with weakened immune systems.  Although healthy individuals may suffer only short-term symptoms such as high fever, severe headache, stiffness, nausea, abdominal pain and diarrhea, Listeria infection can cause miscarriages and stillbirths among pregnant women.","summary":"Del Bueno Recalls Queso Fresco Because of Possible Health Risk","recall_number":"4e3e0b8c82","organization":"CDC","recall_date":"2010-04-06"},{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207588.htm","description":"The Kroger Co. said today it is recalling Kroger California Seasoning Blend Garlic Powder and Kroger Special Seasoning Blend Lemon Pepper sold in its retail stores because the Company has been made aware by a supplier that an ingredient in the product may have been contaminated with Salmonella.","summary":"Kroger Recalls Two Seasonings Due to Possible Health Risk","recall_number":"6ea2fe8c4c","organization":"CDC","recall_date":"2010-04-06"},{"recall_url":"http://www.fsis.usda.gov/News_&_Events/Recall_023_2010_Release/index.asp","description":"North American Bison Co-Op, a New Rockford, N.D., establishment is recalling approximately 25,000 pounds of whole beef heads containing tongues that may not have had the tonsils completely removed, which is not compliant with regulations that require the removal of tonsils from cattle of all ages, the U.S. Department of Agriculture's Food Safety and Inspection Service (FSIS) announced today.","summary":"North Dakota Firm Recalls Whole Beef Head Products That Contain Prohibited Materials","recall_number":"e78b0b98d6","organization":"CDC","recall_date":"2010-04-05"},{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207477.htm","description":"Whole Foods Market announced the recall of its Whole Catch Yellow fin Tuna Steaks (frozen) with a best by date of Dec 5th, 2010 because of possible elevated levels of histamine that may result in symptoms that generally appear within minutes to an hour after eating the affected fish.  No other Whole Foods Market, Whole Catch, 365 or 365 Organic products are affected.","summary":"Whole Foods Market Voluntarily Recalls Frozen Whole Catch Yellow Fin Tuna Steaks Due to Possible Health Risks","recall_number":"ae7929d12f","organization":"CDC","recall_date":"2010-04-05"},{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207345.htm","description":"Chino, California  (April 2, 2010) -- Golden Pacific Foods, Inc. is recalling Marco Polo Brand Shrimp Snacks sold as Original, Onion & Garlic Flavored and Bar-B-Que Flavored, because they may contain undeclared milk and soy. People who have allergies to milk and soy run the risk of serious or life-threatening reaction if they consume these products.","summary":"Golden Pacific Foods, Inc. Issues Allergy Alert for Undeclared Milk and Soy in Marco Polo Brand Shrimp Snacks","recall_number":"2d45140998","organization":"CDC","recall_date":"2010-04-04"},{"recall_url":"http://www.fsis.usda.gov/News_&_Events/Recall_022_2010_Release/index.asp","description":"Lorentz Meats, a Cannon Falls, Minn., establishment, is recalling approximately 100 pounds of ham products that may be contaminated with Listeria monocytogenes. The ham products were produced on March 12, 2010, and were distributed to retail establishments in Minneapolis/St. Paul, and the surrounding area.","summary":"Minnesota Firm Recalls Ham Products for Possible Listeria Contamination","recall_number":"ac0c5020e5","organization":"CDC","recall_date":"2010-04-04"},{"recall_url":"http://www.fda.gov/Safety/Recalls/ucm207340.htm","description":"NY GOURMET SALADS INC. of Brooklyn, NY, is recalling 60 lbs. of its 5 lb. tubs of CHICK PEA SALAD because it has the potential to be contaminated with Listeria monocytogenes, an organism which can cause serious and sometimes fatal infections in young children, frail or elderly people, and others with weakened immune systems.  Although healthy individuals may suffer only short-term symptoms such as high fever, severe headache, stiffness, nausea, abdominal pain and diarrhea, Listeria infection can cause miscarriages and stillbirths among pregnant women.","summary":"NY Gourmet Salads Inc. Recalls Chick Pea Salad Because of Possible Health Risk","recall_number":"6b2bfa457d","organization":"CDC","recall_date":"2010-04-02"}]}}

data/spec/helper.rb

@@ -0,0 +1,23 @@
+require 'simplecov'
+SimpleCov.start do
+  add_group 'Recalls', 'lib/recalls'
+  add_group 'Faraday', 'lib/faraday'
+end
+
+require File.expand_path('../../lib/recalls', __FILE__)
+require 'rspec'
+require 'webmock/rspec'
+
+require 'recalls'
+
+RSpec.configure do |config|
+  config.include WebMock::API
+end
+
+def fixture_path
+  File.expand_path("../fixtures", __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end

data/spec/recalls_spec.rb

@@ -0,0 +1,39 @@
+require 'helper'
+
+describe Recalls do
+  before do
+    Recalls.configure do |config|
+      config.api_key = "badcheese"
+    end
+  end
+
+  describe "search" do
+    context "when a search returns a success" do
+      before do
+        stub_request(:get, "http://search.usa.gov/search/recalls/?format=json").
+         with(:headers => {'Accept'=>'application/json'}).
+         to_return(:status => 200, :body => fixture('recalls_search_response.json'), :headers => {})
+      end
+      
+      it "should return a hash with the results" do
+        response = Recalls.search
+        response.is_a?(Hash).should be_true
+        response["success"]["total"].should == 21840
+      end
+    end
+    
+    context "when a search returns an error" do
+      before do
+        stub_request(:get, "http://search.usa.gov/search/recalls/?format=json").
+         with(:headers => {'Accept'=>'application/json'}).
+         to_return(:status => 401, :body => "Invalid API Key", :headers => {})
+      end
+      
+      it "should return an error" do
+        response = Recalls.search
+        response.is_a?(String).should be_true
+        response.should == "Invalid API Key"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,246 @@
+--- !ruby/object:Gem::Specification 
+name: Recalls
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: "0.1"
+platform: ruby
+authors: 
+- Dan Melton
+- Erik Michaels-Ober
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-19 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.4"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: maruku
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.6"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.4"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.8"
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.1"
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: simplecov
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.3"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.5"
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.6"
+  type: :development
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: ZenTest
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "4.4"
+  type: :development
+  version_requirements: *id010
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  prerelease: false
+  requirement: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.4.0
+  type: :runtime
+  version_requirements: *id011
+- !ruby/object:Gem::Dependency 
+  name: faraday
+  prerelease: false
+  requirement: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.5.3
+  type: :runtime
+  version_requirements: *id012
+- !ruby/object:Gem::Dependency 
+  name: faraday_middleware
+  prerelease: false
+  requirement: &id013 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.3.0
+  type: :runtime
+  version_requirements: *id013
+- !ruby/object:Gem::Dependency 
+  name: multi_json
+  prerelease: false
+  requirement: &id014 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.0.5
+  type: :runtime
+  version_requirements: *id014
+- !ruby/object:Gem::Dependency 
+  name: multi_xml
+  prerelease: false
+  requirement: &id015 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.2.0
+  type: :runtime
+  version_requirements: *id015
+description: 
+email: 
+- dan@codeforamerica.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.mkd
+- README.mkd
+- Rakefile
+- autotest/discover.rb
+- lib/faraday/multipart.rb
+- lib/faraday/raise_error.rb
+- lib/faraday/response/raise_error.rb
+- lib/recalls.rb
+- lib/recalls/client.rb
+- lib/recalls/client/connection.rb
+- lib/recalls/client/products.rb
+- lib/recalls/client/request.rb
+- lib/recalls/configuration.rb
+- lib/recalls/version.rb
+- recalls.gemspec
+- spec/fixtures/recalls_search_response.json
+- spec/helper.rb
+- spec/recalls_spec.rb
+homepage: http://rubygems.org/gems/recalls
+licenses: []
+
+post_install_message: |
+  Using this gem in your project or organization? Add it to the apps wiki!
+  https://github.com/codeforamerica/Recalls/wiki/apps
+
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper for the Recalls APIs.
+test_files: 
+- spec/fixtures/recalls_search_response.json
+- spec/helper.rb
+- spec/recalls_spec.rb
+has_rdoc: