fed_spending 0.0.1

data/.autotest

@@ -0,0 +1 @@
+require 'autotest/bundler'

data/.gitignore

@@ -0,0 +1,41 @@
+!.gitignore
+*.gem
+*.rbc
+*.sw[a-p]
+*.tmproj
+*.tmproject
+*.un~
+*~
+.DS_Store
+.Spotlight-V100
+.Trashes
+._*
+.bundle
+.config
+.directory
+.elc
+.redcar
+.yardoc
+/.emacs.desktop
+/.emacs.desktop.lock
+Desktop.ini
+Gemfile.lock
+Icon?
+InstalledFiles
+Session.vim
+Thumbs.db
+\#*\#
+_yardoc
+auto-save-list
+coverage
+doc/
+lib/bundler/man
+pkg
+pkg/*
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tmtags
+tramp

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format=nested
+--backtrace

data/.yardopts

@@ -0,0 +1,3 @@
+--markup markdown
+-
+LICENSE.md

data/Gemfile

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

data/LICENSE.md

@@ -0,0 +1,10 @@
+Copyright (c) 2011, Code for America
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of Code for America nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,83 @@
+# The Fed Spending Ruby Gem
+
+A thin wrapper for the FedSpending API sponsored by Code for America.
+
+Please see [FedSpending.org](http://www.fedspending.org/apidoc.php) for a full list of options
+
+
+Usage
+-----
+```ruby
+
+	require 'fed_spending'
+	FedSpending.rcv({:detail => -1, :recipient_state => 'IA'})
+	# Returns a hash of the summary of modified recovery data on Federal contracts for the state of Iowa
+	
+	FedSpending.faads({:detail => -1, :recipient_name => 'Smith', :fiscal_year => 2006})
+	# Returns a hash of FAADS Contracts from 2006 with the recipient name of Smith
+	
+	FedSpending.fpds({:detail => -1, :state => 'AL'})
+	# Returns a hash of the modified FPDS data on Federal contracts from the state of Alabama
+	
+```
+
+
+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](https://github.com/codeforamerica/fed_spending_ruby/issues)
+* by reviewing patches
+
+Submitting an Issue
+-------------------
+We use the [GitHub issue
+tracker](https://github.com/codeforamerica/fed_spending_ruby/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](https://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) 2011 Code for America
+See
+[LICENSE](https://github.com/codeforamerica/fed_spending_ruby/blob/master/LICENSE.md)
+for details.
+
+[![Code for America
+Tracker](http://stats.codeforamerica.org/codeforamerica/fed_spending_ruby.png)](http://stats.codeforamerica.org/projects/fed_spending_ruby)

data/Rakefile

@@ -0,0 +1,18 @@
+#!/usr/bin/env rake
+
+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/fed_spending.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/fed_spending/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name        = 'fed_spending'
+  gem.version     = FedSpending::VERSION
+  gem.author      = "blakeshall"
+  gem.email       = 'blake@codeforamerica.org'
+  gem.homepage    = ''
+  gem.summary     = %q{A Ruby wrapper for the FedSpending API}
+  gem.description = %q{A Code for America sponsored Ruby wrapper for the FedSpending API. See FedSpending.org for more information.}
+
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  gem.require_paths = ['lib']
+
+    gem.add_development_dependency 'ZenTest', '~> 4.5'
+    gem.add_development_dependency 'maruku', '~> 0.6'
+    gem.add_development_dependency 'rake', '~> 0.9'
+    gem.add_development_dependency 'rspec', '~> 2.6'
+    gem.add_development_dependency 'simplecov', '~> 0.4'
+    gem.add_development_dependency 'yard', '~> 0.7'
+    gem.add_development_dependency 'webmock', '~> 1.6'
+
+    gem.add_runtime_dependency 'faraday', '~> 0.6.1'
+    gem.add_runtime_dependency 'faraday_middleware', '~> 0.6.3'
+    gem.add_runtime_dependency 'hashie', '~> 1.0.0'
+    #gem.add_runtime_dependency 'multi_json', '~> 1.0.2'
+    gem.add_runtime_dependency 'multi_xml', '~> 0.2.2'
+    gem.add_runtime_dependency 'rash', '~> 0.3.0'
+  end

data/lib/fed_spending.rb

@@ -0,0 +1,19 @@
+require 'fed_spending/client'
+
+module FedSpending
+  
+  def self.client(options={})
+      FedSpending::Client.new(options)
+    end
+
+    # Delegate to MicrosoftOpenData::Client.new
+    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
+    
+end

data/lib/fed_spending/client.rb

@@ -0,0 +1,14 @@
+require 'fed_spending/client'
+require 'fed_spending/client/connection'
+require 'fed_spending/client/request'
+require 'fed_spending/client/api'
+
+
+module FedSpending
+  class Client
+    include FedSpending::Client::Connection
+    include FedSpending::Client::Request
+    include FedSpending::Client::Api
+
+  end
+end

data/lib/fed_spending/client/api.rb

@@ -0,0 +1,99 @@
+module FedSpending
+  class Client
+    module Api
+      
+      # Allows access to modified FPDS data on Federal contracts.
+      # @param params [Hash] The parameters for the lookup
+      # @param options [Hash] A customizable set of options. 
+      # @return {Hash}
+      # @see http://www.fedspending.org/api_fpds.php
+      # @example
+      #   fpds({:detail => -1, :state => 'AL'})
+      
+      def fpds(params={}, options={})
+        if !params[:zip_code].nil?
+          params["ZIPCode"] = params[:zip_code]
+          params.delete(:zip_code)
+        end
+        if !params[:vendor_country_code].nil?
+          params["vendorCountryCode"] = params[:vendor_country_code]
+          params.delete(:vendor_country_code)
+        end
+        if !params[:state_code].nil?
+          params["stateCode"] = params[:state_code]
+          params.delete(:state_code)
+        end
+        if !params[:place_of_performance_zip_code].nil?
+          params["placeOfPerformanceZIPCode"] = params[:place_of_performance_zip_code]
+          params.delete(:place_of_performance_zip_code)
+        end
+        if !params[:place_of_performance_country_code].nil?
+          params["placeOfPerformanceCountryCode"] = params[:place_of_performance_country_code]
+          params.delete(:place_of_performance_country_code)
+        end
+        if !params[:description_of_contract_requirement].nil?
+          params["descriptionOfContractRequirement"] = params[:description_of_contract_requirement]
+          params.delete(:description_of_contract_requirement)
+        end
+        if !params[:piid].nil?
+          params["PIID"] = params[:piid]
+          params.delete(:piid)
+        end
+        if !params[:sort_by].nil?
+          params["sortby"] = params[:sort_by]
+          params.delete(:sort_by)
+        end
+        request = []
+        params.each do|key, value|
+          request << "#{key.to_s}=#{value.to_s}"
+        end
+        get("fpds/fpds.php?datype=X&#{request.join('&')}")
+      end
+      
+      # Allows access to modified FAADS data on Federal contracts.
+      # @param params [Hash] The parameters for the lookup
+      # @param options [Hash] A customizable set of options. 
+      # @return {Hash}
+      # @see http://www.fedspending.org/api_faads.php
+      # @example
+      #   faads({:detail => -1, :recipient_name => 'Smith', :fiscal_year => 2006})
+      
+      def faads(params={}, options={})
+        if !params[:sort_by].nil?
+          params["sortby"] = params[:sort_by]
+          params.delete(:sort_by)
+        end
+        request = []
+        params.each do|key, value|
+          request << "#{key.to_s}=#{value.to_s}"
+        end
+        get("faads/faads.php?datype=X&#{request.join('&')}")
+      end
+      
+      # Allows access to modified recovery data on Federal contracts.
+      # @param params [Hash] The parameters for the lookup
+      # @param options [Hash] A customizable set of options. 
+      # @return {Hash}
+      # @see http://www.fedspending.org/api_rcv.php
+      # @example
+      #   rcv({:detail => -1, :recipient_state => 'IA'})
+      
+      def rcv(params={}, options={})
+        if !params[:sort_by].nil?
+          params["sortp"] = params[:sort_by]
+          params.delete(:sort_by)
+        end
+        if !params[:recipient_state].nil?
+          params["recipient_st"] = params[:recipient_state]
+          params.delete(:recipient_state)
+        end
+        request = []
+        params.each do|key, value|
+          request << "#{key.to_s}=#{value.to_s}"
+        end
+        get("rcv/rcv.php?datype=X&#{request.join('&')}")
+      end
+      
+    end
+  end
+end

data/lib/fed_spending/client/connection.rb

@@ -0,0 +1,20 @@
+require 'faraday_middleware'
+
+module FedSpending
+  class Client
+    module Connection
+      private
+
+      def connection
+        Faraday.new(:url => 'http://www.fedspending.org/') do |connection|
+          connection.use Faraday::Request::UrlEncoded
+          connection.use Faraday::Response::RaiseError
+          connection.use Faraday::Response::Rashify
+          connection.use Faraday::Response::ParseXml
+          #connection.use Faraday::Response::ParseJson
+          connection.adapter(Faraday.default_adapter)
+        end
+      end
+    end
+  end
+end

data/lib/fed_spending/client/request.rb

@@ -0,0 +1,18 @@
+module FedSpending
+  class Client
+    module Request
+      def get(path, options={})
+        request(:get, path, options)
+      end
+
+      private
+
+      def request(method, path, options)
+        response = connection.send(method) do |request|
+          request.url(path, options)
+        end
+        response.body
+      end
+    end
+  end
+end

data/lib/fed_spending/version.rb

@@ -0,0 +1,3 @@
+module FedSpending
+  VERSION = "0.0.1"
+end

data/spec/fed_spending/api_spec.rb

@@ -0,0 +1,50 @@
+require 'helper'
+
+describe FedSpending::Client::Api do
+
+  before do
+    @client = FedSpending::Client.new
+  end
+  
+  describe ".fpds" do
+    before do
+      stub_get("fpds/fpds.php?datype=X&detail=-1&state=AL").
+        to_return(:status => 200, :body => fixture("fedspending_search_results.xml"))
+    end
+    
+    it "Should return the correct item" do
+      test = @client.fpds({:detail => -1, :state => 'AL'})
+      a_get("fpds/fpds.php?datype=X&detail=-1&state=AL").should have_been_made
+      test.fedspendingSearchResults.data.record.totals.rank_among_states.should == "20"
+    end
+  end
+    
+  describe ".faads" do
+    before do
+      stub_get("faads/faads.php?datype=X&detail=-1&recipient_name=Smith&fiscal_year=2006").
+        to_return(:status => 200, :body => fixture("faads.xml"))
+    end
+    
+    it "Should return the correct item" do
+      test = @client.faads({:detail => -1, :recipient_name => 'Smith', :fiscal_year => 2006})
+      a_get("faads/faads.php?datype=X&detail=-1&recipient_name=Smith&fiscal_year=2006").should have_been_made
+      test.fedspendingSearchResults.data.record.totals.fed_total.should == "131582977"
+    end
+  end
+  
+  describe ".rcv" do
+    before do
+      stub_get("rcv/rcv.php?datype=X&detail=-1&recipient_st=IA").
+        to_return(:status => 200, :body => fixture("rcv.xml"))
+    end
+    
+    it "Should return the correct item" do
+      test = @client.rcv({:detail => -1, :recipient_state => 'IA'})
+      a_get("rcv/rcv.php?datype=X&detail=-1&recipient_st=IA").should have_been_made
+      test.fedspendingSearchResults.data.record.totals.total_net_amount_retained.should == "$1,645,373,746"
+    end
+  end
+  
+    
+  
+end

data/spec/fed_spending_spec.rb

@@ -0,0 +1,10 @@
+# -*- encoding: utf-8 -*-
+require 'helper'
+
+describe FedSpending do
+  describe ".client" do
+    it "should be a FedSpending::Client" do
+      FedSpending.client.should be_a FedSpending::Client
+    end
+  end
+end

data/spec/fixtures/faads.xml

@@ -0,0 +1,69 @@
+<?xml version="1.0"?>
+<fedspendingSearchResults xml_format_version="0.7" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.fedspending.org//_summary.xsd">
+  <search_criteria>
+    <search_criterion field="Recipient Name" value="Smith"/>
+    <search_criterion field="Federal Fiscal Year" value="2006"/>
+    <search_criterion field="Sort By" value="Recipient Name"/>
+    <search_criterion field="Number of records" value="All records for each year"/>
+    <search_criterion field="Level of Detail" value="Summary"/>
+    <search_criterion field="Type of Report Output" value="XML"/>
+  </search_criteria>
+  <data compiled_from_government_data_last_released_on="2009-03-18" database="" description="U.S. Federal grants and other assistance" max_records="1000">
+    <record detail="summary" description="summary record for search" database="FAADS">
+      <totals>
+        <fiscal_year>2006</fiscal_year>
+        <fed_total>131582977</fed_total>
+        <number_of_recipients>653</number_of_recipients>
+        <number_of_transactions>1223</number_of_transactions>
+      </totals>
+      <top_known_congressional_districts description="Top congressional districts where recipients are located" ranked_by="total obligated amount in dollars" maximum_shown="5">
+        <congressional_district rank="1" total_obligatedAmount="18126237">Arkansas 3 (John Boozman)</congressional_district>
+        <congressional_district rank="2" total_obligatedAmount="10026463">Texas 14 (Ron Paul)</congressional_district>
+        <congressional_district rank="3" total_obligatedAmount="9344563">Mississippi 4 (Gene Taylor)</congressional_district>
+        <congressional_district rank="4" total_obligatedAmount="6339939">Arkansas 2 (Vic Snyder)</congressional_district>
+        <congressional_district rank="5" total_obligatedAmount="4991756">Nebraska 3 (Tom Osborne)</congressional_district>
+      </top_known_congressional_districts>
+      <top_cfda_programs ranked_by="total obligated amount in dollars" maximum_shown="5">
+        <cfda_program rank="1" total_obligatedAmount="20187100">59.008: Physical Disaster Loans</cfda_program>
+        <cfda_program rank="2" total_obligatedAmount="19210725">84.268: Federal Direct Student Loans</cfda_program>
+        <cfda_program rank="3" total_obligatedAmount="16710440">84.063: Federal Pell Grant Program</cfda_program>
+        <cfda_program rank="4" total_obligatedAmount="13254485">10.407: Farm Ownership Loans</cfda_program>
+        <cfda_program rank="5" total_obligatedAmount="9952963">93.600: Head Start</cfda_program>
+      </top_cfda_programs>
+      <top_agencies_providing_assistance ranked_by="total obligated amount in dollars" maximum_shown="5">
+        <agency rank="1" total_obligatedAmount="26648200">Small Business Administration</agency>
+        <agency rank="2" total_obligatedAmount="19968358">EDUCATION, Department of</agency>
+        <agency rank="3" total_obligatedAmount="19525273">DOED - Student Financial Assistance Programs</agency>
+        <agency rank="4" total_obligatedAmount="13697635">Dept. Ag. - Farm Service Agency</agency>
+        <agency rank="5" total_obligatedAmount="9952963">HHS - Secy. of Health and Human Services</agency>
+      </top_agencies_providing_assistance>
+      <top_recipients ranked_by="total obligated amount in dollars" maximum_shown="10">
+        <recipient rank="1" total_obligatedAmount="22020829">JOHNSON C SMITH UNIVERSITY</recipient>
+        <recipient rank="2" total_obligatedAmount="9952963">WM SMITH SR TRI COUNTY CHILD DEV COUNCIL</recipient>
+        <recipient rank="3" total_obligatedAmount="8883094">UNIVERSITY OF ARKANSAS FORT SMITH</recipient>
+        <recipient rank="4" total_obligatedAmount="8520151">TRUSTEES OF THE SMITH COLLEGE</recipient>
+        <recipient rank="5" total_obligatedAmount="6893909">SMITH-KETTLEWELL EYE RESEARCH FOUNDATION</recipient>
+        <recipient rank="6" total_obligatedAmount="5663699">PHILANDER SMITH COLLEGE</recipient>
+        <recipient rank="7" total_obligatedAmount="4743235">FORT SMITH</recipient>
+        <recipient rank="8" total_obligatedAmount="3916000">SMITH, DOLLY V</recipient>
+        <recipient rank="9" total_obligatedAmount="2509756">SMITH COLLEGE</recipient>
+        <recipient rank="10" total_obligatedAmount="1747861">SMITH BERETANIA APARTMENTS</recipient>
+      </top_recipients>
+      <assistance_types description="total Federal obligated dollars for each type of governmental assistance">
+        <direct_payments_both_specified_and_unrestricted>29235220</direct_payments_both_specified_and_unrestricted>
+        <grants_and_cooperative_agreements>57420521</grants_and_cooperative_agreements>
+        <insurance>0</insurance>
+        <loans_both_direct_and_guaranteed>44927236</loans_both_direct_and_guaranteed>
+        <other>0</other>
+      </assistance_types>
+      <recipient_types description="total Federal obligated dollars for each type of recipient">
+        <for_profits>3197953</for_profits>
+        <government>15475240</government>
+        <higher_education>43987696</higher_education>
+        <individuals>45374957</individuals>
+        <nonprofits>20128357</nonprofits>
+        <other>3418774</other>
+      </recipient_types>
+    </record>
+  </data>
+</fedspendingSearchResults>

data/spec/fixtures/fedspending_search_results.xml

@@ -0,0 +1,74 @@
+<?xml version="1.0"?>
+<fedspendingSearchResults xml_format_version="0.7" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.fedspending.org//_summary.xsd">
+  <search_criteria>
+    <search_criterion field="Contractor State" value="Alabama"/>
+    <search_criterion field="Sort By" value="Parent Name"/>
+    <search_criterion field="Number of records" value="All records for each year"/>
+    <search_criterion field="Level of Detail" value="Summary"/>
+    <search_criterion field="Output" value="XML"/>
+  </search_criteria>
+  <data compiled_from_government_data_last_released_on="2009-05-28" database="" description="U.S. Federal contracts" max_records="1000">
+    <record detail="summary" description="summary record for search" database="FPDS">
+      <totals>
+        <total_ObligatedAmount>53742289960.22</total_ObligatedAmount>
+        <rank_among_states>20</rank_among_states>
+        <number_of_contractors>5536</number_of_contractors>
+        <number_of_transactions>256722</number_of_transactions>
+      </totals>
+      <extent_of_competition description="total obligated amount dollars by extent of competition in contracts">
+        <full_and_open_competition>19966979383.48</full_and_open_competition>
+        <full_and_open_competition_but_only_one_bid>10601941343.48</full_and_open_competition_but_only_one_bid>
+        <competition_after_exclusion_of_sources>12857546087.54</competition_after_exclusion_of_sources>
+        <follow_on_contract>241625000.28</follow_on_contract>
+        <not_available_for_competition>3860366283.17</not_available_for_competition>
+        <not_competed>5651740475.22</not_competed>
+        <unknown>562091387.05</unknown>
+      </extent_of_competition>
+      <top_known_congressional_districts description="Top congressional districts where work is performed" ranked_by="total obligated amount in dollars" maximum_shown="5">
+        <congressional_district rank="1" total_obligatedAmount="13312641030.32">Alabama 5 (Robert E. (Bud) Cramer Jr. / Parker Griffith / Mo Brooks)</congressional_district>
+        <congressional_district rank="2" total_obligatedAmount="890079121.52">Alabama 3 (Bob Riley / Mike Rogers)</congressional_district>
+        <congressional_district rank="3" total_obligatedAmount="804311083.77">Alabama 6 (Spencer Bachus)</congressional_district>
+        <congressional_district rank="4" total_obligatedAmount="676939044.45">Alabama 7 (Earl F. Hilliard / Artur Davis / Terri A. Sewell)</congressional_district>
+        <congressional_district rank="5" total_obligatedAmount="639960252.75">Alabama 1 (Sonny Callahan / Jo Bonner)</congressional_district>
+      </top_known_congressional_districts>
+      <top_products_or_services_sold ranked_by="total obligated amount in dollars" maximum_shown="5">
+        <product_or_service_category rank="1" total_obligatedAmount="7302258627.77">Other Defense -- Advanced Development (R&amp;D)</product_or_service_category>
+        <product_or_service_category rank="2" total_obligatedAmount="4218584280.22">Engineering and Technical Services</product_or_service_category>
+        <product_or_service_category rank="3" total_obligatedAmount="3403350158.25">Defense Missile and Space Systems -- Advanced Development (R&amp;D)</product_or_service_category>
+        <product_or_service_category rank="4" total_obligatedAmount="2160072562.22">Construction of Structures and Facilities -- Office Buildings</product_or_service_category>
+        <product_or_service_category rank="5" total_obligatedAmount="1986834049.19">Construction of Structures and Facilities -- Miscellaneous Buildings</product_or_service_category>
+      </top_products_or_services_sold>
+      <top_contracting_agencies ranked_by="total obligated amount in dollars" maximum_shown="5">
+        <agency rank="1" total_obligatedAmount="26900259463.69">ARMY, Department of the (except Corps of Engineers Civil Program Financing)</agency>
+        <agency rank="2" total_obligatedAmount="7609430750.41">Missile Defense Agency</agency>
+        <agency rank="3" total_obligatedAmount="3822142153.11">NAVY, Department of the</agency>
+        <agency rank="4" total_obligatedAmount="2686240587.14">STATE, Department of</agency>
+        <agency rank="5" total_obligatedAmount="2655716745.56">AIR FORCE, Department of the (Headquarters, USAF)</agency>
+      </top_contracting_agencies>
+      <top_contractor_parent_companies ranked_by="total obligated amount in dollars" maximum_shown="10">
+        <contractor_parent_company rank="1" total_obligatedAmount="7800674430.89">BOEING CO.</contractor_parent_company>
+        <contractor_parent_company rank="2" total_obligatedAmount="2811211906.30">CADDELL CONSTRUCTION CO INC</contractor_parent_company>
+        <contractor_parent_company rank="3" total_obligatedAmount="2404175424.41">BILL HARBERT INTERNATIONAL CONSTRUCTION</contractor_parent_company>
+        <contractor_parent_company rank="4" total_obligatedAmount="2099752796.44">BAE SYSTEMS</contractor_parent_company>
+        <contractor_parent_company rank="5" total_obligatedAmount="1521997684.37">COMPUTER SCIENCES CORP.</contractor_parent_company>
+        <contractor_parent_company rank="6" total_obligatedAmount="1227524728.49">CAS INC</contractor_parent_company>
+        <contractor_parent_company rank="7" total_obligatedAmount="1166174300.87">JVYS</contractor_parent_company>
+        <contractor_parent_company rank="8" total_obligatedAmount="1155635142.12">TELEDYNE TECHNOLOGIES, INC.</contractor_parent_company>
+        <contractor_parent_company rank="9" total_obligatedAmount="1004686434.56">NEW MOUNTAIN CAPITAL LLC</contractor_parent_company>
+        <contractor_parent_company rank="10" total_obligatedAmount="868976643.76">QUANTUM RESEARCH INTL</contractor_parent_company>
+      </top_contractor_parent_companies>
+      <fiscal_years description="total obligated amount in dollars by year">
+        <fiscal_year year="2000">3095382695.72</fiscal_year>
+        <fiscal_year year="2001">2993455625.26</fiscal_year>
+        <fiscal_year year="2002">4137376279.35</fiscal_year>
+        <fiscal_year year="2003">4110313413.23</fiscal_year>
+        <fiscal_year year="2004">7228024381.85</fiscal_year>
+        <fiscal_year year="2005">5287124586.64</fiscal_year>
+        <fiscal_year year="2006">5908807663.16</fiscal_year>
+        <fiscal_year year="2007">9066557726.43</fiscal_year>
+        <fiscal_year year="2008">9543096909.34</fiscal_year>
+        <fiscal_year year="2009">2372150679.24</fiscal_year>
+      </fiscal_years>
+    </record>
+  </data>
+</fedspendingSearchResults>

data/spec/fixtures/rcv.xml

@@ -0,0 +1,95 @@
+<?xml version="1.0"?>
+<fedspendingSearchResults xml_format_version="0.7" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.fedspending.org//_summary.xsd">
+  <search_criteria>
+    <search_criterion field="Recipient State" value="Iowa"/>
+    <search_criterion field="Sort By" value="Award or Payment Amount"/>
+    <search_criterion field="Number of records" value="All records for each year"/>
+    <search_criterion field="Cumulative or Quarterly Dataset" value="Cumulative"/>
+    <search_criterion field="Level of Detail" value="Summary"/>
+    <search_criterion field="Type of Report Output" value="XML"/>
+  </search_criteria>
+  <data compiled_from_government_data_last_released_on="2011-01-30" database="" description="U.S. Recovery funding data" max_records="1000">
+    <record detail="summary" description="summary record for search" database="Recovery">
+      <totals>
+        <total_net_amount_retained>$1,645,373,746</total_net_amount_retained>
+        <net_amount_calculation>
+          <received_as_prime_recipients>
+            <amount_awarded_from_federal_government>$2,066,346,669</amount_awarded_from_federal_government>
+            <amount_awarded_to_sub_recipients>$-989,908,912</amount_awarded_to_sub_recipients>
+            <payments_to_vendors>$-319,244,886</payments_to_vendors>
+            <net_amount_retained_by_prime_recipients>$757,192,870</net_amount_retained_by_prime_recipients>
+          </received_as_prime_recipients>
+          <received_as_sub_recipients>
+            <amount_awarded_from_prime_recipients>$1,017,785,372</amount_awarded_from_prime_recipients>
+            <payments_to_vendors>$-135,558,416</payments_to_vendors>
+            <net_amount_retained_by_sub_recipients>$882,226,957</net_amount_retained_by_sub_recipients>
+          </received_as_sub_recipients>
+          <received_as_vendors>
+            <amount_paid_by_prime_and_sub_recipients_to_vendors>$5,953,919</amount_paid_by_prime_and_sub_recipients_to_vendors>
+          </received_as_vendors>
+          <total_for_this_search>$1,645,373,746</total_for_this_search>
+        </net_amount_calculation>
+        <total_arra_funds_received_by_primes>1,420,572,755</total_arra_funds_received_by_primes>
+        <total_number_of_awards>1,313</total_number_of_awards>
+        <total_number_of_recipients>1,225</total_number_of_recipients>
+        <total_number_of_FTEs>5,052.22</total_number_of_FTEs>
+      </totals>
+      <received_as_prime_recipients>
+        <amount_awarded>$2,066,346,669</amount_awarded>
+        <net_amount_retained>$757,192,870</net_amount_retained>
+        <contracts_awarded>$168,599,685</contracts_awarded>
+        <grants_awarded>$1,819,544,662</grants_awarded>
+        <loans_awarded>$78,202,321</loans_awarded>
+        <number_of_awards>1,200</number_of_awards>
+        <number_of_recipients>414</number_of_recipients>
+      </received_as_prime_recipients>
+      <received_as_sub_recipients>
+        <amount_awarded>$1,017,785,372</amount_awarded>
+        <net_amount_retained>$882,226,957</net_amount_retained>
+        <contracts_awarded>$75,192,416</contracts_awarded>
+        <grants_awarded>$942,419,722</grants_awarded>
+        <loans_awarded>$173,234</loans_awarded>
+        <number_of_awards>299</number_of_awards>
+        <number_of_recipients>918</number_of_recipients>
+      </received_as_sub_recipients>
+      <received_as_vendors>
+        <amount_of_payments>$5,953,919</amount_of_payments>
+        <number_of_payments>9</number_of_payments>
+        <number_of_vendors>12</number_of_vendors>
+      </received_as_vendors>
+      <top_recipients ranked_by="total award amount in dollars" maximum_shown="5">
+        <recipient rank="1" award_amount="472339542">EXECUTIVE OFFICE OF THE STATE OF IOWA</recipient>
+        <recipient rank="2" award_amount="384378918.1">TRANSPORTATION, IOWA DEPT OF</recipient>
+        <recipient rank="3" award_amount="211779381">EDUCATION, IOWA DEPARTMENT OF</recipient>
+        <recipient rank="4" award_amount="112328927.17">UNIVERSITY OF IOWA, THE</recipient>
+        <recipient rank="5" award_amount="91655809">HUMAN RIGHTS, IOWA DEPARTMENT</recipient>
+        <recipient rank="6" award_amount="82990798">NATURAL RESOURCES, IOWA DEPARTMENT OF</recipient>
+        <recipient rank="7" award_amount="62574079">IOWA STATE UNIVERSITY</recipient>
+        <recipient rank="8" award_amount="53495993">IOWA OFFICE OF ENERGY INDEPENDENCE</recipient>
+        <recipient rank="9" award_amount="46542195.34">GROOMS &amp; CO. CONSTRUCTION, INC.</recipient>
+        <recipient rank="10" award_amount="37882090.38">DES MOINES INDEPENDENT SCHOOL DISTRICT</recipient>
+      </top_recipients>
+      <top_place_of_performance_congressional_districts description="Top congressional districts where work is performed" ranked_by="total net amount retained in dollars" maximum_shown="5">
+        <congressional_district rank="1" award_amount="496355778.15">Iowa 3 (Leonard L. Boswell)</congressional_district>
+        <congressional_district rank="2" award_amount="363122765.77">Iowa 2 (David Loebsack)</congressional_district>
+        <congressional_district rank="3" award_amount="317027572.33">Iowa 4 (Tom Latham)</congressional_district>
+        <congressional_district rank="4" award_amount="210133169.09">Iowa 5 (Steve King)</congressional_district>
+        <congressional_district rank="5" award_amount="209621393.77">Iowa 1 (Bruce L. Braley)</congressional_district>
+      </top_place_of_performance_congressional_districts>
+      <top_awarding_agencies ranked_by="total award amount in dollars" maximum_shown="5">
+        <agency rank="1" award_amount="1007659101.23">Office of Elementary and Secondary Education</agency>
+        <agency rank="2" award_amount="430564703.6">Federal Highway Administration</agency>
+        <agency rank="3" award_amount="275638255.41">ENERGY, Department of</agency>
+        <agency rank="4" award_amount="267383416">Office of Special Education and Rehabilitative Services</agency>
+        <agency rank="5" award_amount="160655103">ENVIRONMENTAL PROTECTION AGENCY</agency>
+      </top_awarding_agencies>
+      <top_cities ranked_by="total award amount in dollars" maximum_shown="5">
+        <city rank="1" award_amount="375194236.97">Des Moines, IA</city>
+        <city rank="2" award_amount="124374073.72">Iowa City, IA</city>
+        <city rank="3" award_amount="89548624.69">Ames, IA</city>
+        <city rank="4" award_amount="70702458">Ottumwa, IA</city>
+        <city rank="5" award_amount="56888626.02">Cedar Rapids, IA</city>
+      </top_cities>
+    </record>
+  </data>
+</fedspendingSearchResults>

data/spec/helper.rb

@@ -0,0 +1,48 @@
+$:.unshift File.expand_path('..', __FILE__)
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'simplecov'
+SimpleCov.start
+require 'fed_spending'
+require 'rspec'
+
+require 'webmock/rspec'
+
+def a_delete(path)
+  a_request(:delete, 'http://www.fedspending.org/' + path)
+end
+
+def a_get(path)
+  a_request(:get, 'http://www.fedspending.org/' + path)
+end
+
+def a_post(path)
+  a_request(:post, 'http://www.fedspending.org/' + path)
+end
+
+def a_put(path)
+  a_request(:put, 'http://www.fedspending.org/' + path)
+end
+
+def stub_delete(path)
+  stub_request(:delete, 'http://www.fedspending.org/' + path)
+end
+
+def stub_get(path)
+  stub_request(:get, 'http://www.fedspending.org/' + path)
+end
+
+def stub_post(path)
+  stub_request(:post, 'http://www.fedspending.org/' + path)
+end
+
+def stub_put(path)
+  stub_request(:put, 'http://www.fedspending.org/' + path)
+end
+
+def fixture_path
+  File.expand_path('../fixtures', __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end

metadata

@@ -0,0 +1,205 @@
+--- !ruby/object:Gem::Specification
+name: fed_spending
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- blakeshall
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-26 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ZenTest
+  requirement: &2156526680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.5'
+  type: :development
+  prerelease: false
+  version_requirements: *2156526680
+- !ruby/object:Gem::Dependency
+  name: maruku
+  requirement: &2156526060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: *2156526060
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2156525500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: *2156525500
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2156524900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *2156524900
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &2156524380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: *2156524380
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &2156523520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: *2156523520
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &2156523000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: *2156523000
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: &2156522480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156522480
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: &2156522000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156522000
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: &2156521460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156521460
+- !ruby/object:Gem::Dependency
+  name: multi_xml
+  requirement: &2156521000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156521000
+- !ruby/object:Gem::Dependency
+  name: rash
+  requirement: &2156520500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156520500
+description: A Code for America sponsored Ruby wrapper for the FedSpending API. See
+  FedSpending.org for more information.
+email: blake@codeforamerica.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .autotest
+- .gemtest
+- .gitignore
+- .rspec
+- .yardopts
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- fed_spending.gemspec
+- lib/fed_spending.rb
+- lib/fed_spending/client.rb
+- lib/fed_spending/client/api.rb
+- lib/fed_spending/client/connection.rb
+- lib/fed_spending/client/request.rb
+- lib/fed_spending/version.rb
+- spec/fed_spending/api_spec.rb
+- spec/fed_spending_spec.rb
+- spec/fixtures/faads.xml
+- spec/fixtures/fedspending_search_results.xml
+- spec/fixtures/rcv.xml
+- spec/helper.rb
+homepage: ''
+licenses: []
+post_install_message: 
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper for the FedSpending API
+test_files:
+- spec/fed_spending/api_spec.rb
+- spec/fed_spending_spec.rb
+- spec/fixtures/faads.xml
+- spec/fixtures/fedspending_search_results.xml
+- spec/fixtures/rcv.xml
+- spec/helper.rb