usatoday-census 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

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

data/README.md

@@ -0,0 +1,70 @@
+# usatoday-census
+
+
+* [Source](http://github.com/dwillis/usatoday-census)
+
+## DESCRIPTION:
+
+Simple ruby wrapper for the [USA TODAY Census API](http://developer.usatoday.com/docs/read/Census). You'll need an API key.
+
+## INSTALL:
+
+* <tt>gem install usatoday-census</tt>
+
+## USAGE:
+
+    require 'rubygems'
+    require 'usatoday-census'
+    include Usatoday::Census
+
+You'll want to set your API key as an environment variable in order to run the tests. Otherwise, you'll need to set it like so:
+
+    Base.api_key = YOUR_API_KEY
+  
+or via an environment variable:
+
+    API_KEY = ENV['USAT_CENSUS_API_KEY']
+    Base.api_key = API_KEY
+  
+The gem queries the USA TODAY Census API to return information about a state's population, ethnicity, housing, racial composition and other geographic details, including the USA TODAY Diversity Index. The initial version of the gem supports state-level requests, so the results will be for states only. Future support for other geographic levels (National, County and City or Town) will be added soon. Users can search for a state by its postal abbreviation or name:
+
+    Location.search('va') # find demographic information about Virginia
+    Ethnicity.search("Virginia", "Placename") # can also search by full state name using the Placename attribute.
+    Race.search("51", 'FIPS') # Or search by FIPS code, too.
+
+Check out the tests for further examples. Run the tests via rake test. Note: you'll need to set your API key as an environment variable before running the tests. The API has a limit of two queries per second, so the test requests are delayed by one second to ensure passage.
+
+## Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2011 Derek Willis
+
+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/Rakefile

@@ -0,0 +1,21 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "campaign_cash #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/usatoday-census.rb

@@ -0,0 +1,5 @@
+%w(base exceptions location ethnicity housing population race).each do |f|
+  require File.join(File.dirname(__FILE__), 'usatoday-census', f)
+end
+
+

data/lib/usatoday-census/base.rb

@@ -0,0 +1,86 @@
+require 'open-uri'
+require 'json'
+require 'htmlentities'
+
+module Usatoday
+  module Census
+    class Base
+      
+      API_SERVER = "api.usatoday.com"
+      API_NAME = "census"
+      API_BASE = "/open/#{API_NAME}"
+      
+      @@api_key = nil
+      @@debug = false
+      @@decode_html_entities = true
+      
+      def self.api_key=(key)
+        @@api_key = key
+      end
+
+      def self.api_key
+        @@api_key
+      end
+    
+      def self.build_request_url(method, params)
+        URI::HTTP.build :host => API_SERVER, 
+        :path => API_BASE + '/' + method, 
+        :query => params.map {|k,v| "#{URI.escape(k)}=#{URI.escape(v.to_s)}"}.join('&')
+      end
+    
+      def self.text_field(value)
+        return nil if value.nil?
+        @@decode_html_entities ? HTMLEntities.new.decode(value) : value
+      end
+    
+      def self.integer_field(value)
+        return nil if value.nil?
+        value.to_i
+      end
+      
+      def self.float_field(value)
+        return nil if value.nil?
+        value.to_f
+      end
+    
+      def self.prepare_params(method, keyname=nil)
+        params = {"keypath" => method }
+        params["keyname"] = keyname if keyname
+        params
+      end
+
+      
+      def self.invoke(method, params={})
+        begin
+          raise AuthenticationError, "You must initialize the API key before you run any API queries" if @@api_key.nil?
+          
+          full_params = params.merge 'api_key' => @@api_key
+          uri = build_request_url(method, full_params)	
+          puts "REQUEST: #{uri}" if @@debug
+          
+          reply = uri.read
+          parsed_reply = JSON.parse reply
+          
+          raise BadResponseError, "Empty reply returned from API" if parsed_reply.nil?
+          parsed_reply['response'].first
+        rescue OpenURI::HTTPError => e
+          case e.message
+            when /^400/
+              raise BadRequestError
+            when /^403/
+              raise AuthenticationError
+            when /^404/
+              return nil
+            when /^500/
+              raise ServerError
+            else
+              raise ConnectionError
+            end
+          raise "Error connecting to URL #{uri} #{e}"
+        rescue JSON::ParserError => e
+          raise BadResponseError, "Invalid JSON returned from API:\n#{reply}"          
+        end
+      end
+    end
+  end
+end

data/lib/usatoday-census/ethnicity.rb

@@ -0,0 +1,40 @@
+module Usatoday
+  module Census
+    class Ethnicity < Base
+      
+      TEXT_FIELDS = %w(place_name state_postal)
+      NUMERIC_FIELDS = %w(fips gnis)
+      DECIMAL_FIELDS = %w(pct_hispanic pct_non_hispanic_white usat_diversity_index)
+      
+      ALL_FIELDS = TEXT_FIELDS + DECIMAL_FIELDS + NUMERIC_FIELDS
+      
+      attr_reader *ALL_FIELDS
+      
+      def initialize(params={})
+				params.each_pair do |k,v|
+					instance_variable_set("@#{k}", v)
+				end
+			end
+      
+      def self.init_from_api(params)
+        ethnicity = Ethnicity.new(
+        :place_name => text_field(params['Placename']),
+        :state_postal => text_field(params['StatePostal']),
+        :fips => integer_field(params['FIPS']),
+        :gnis => integer_field(params['GNIS']),
+        :pct_hispanic => float_field(params['PctHisp']),
+        :pct_non_hispanic_white => float_field(params['PctNonHispWhite']),
+        :usat_diversity_index => float_field(params['USATDiversityIndex'])
+        )
+        ethnicity
+      end
+      
+      def self.search(keypat, keyname=nil)
+        params = prepare_params(keypat, keyname)
+  			response = invoke('ethnicity', params)
+  			init_from_api(response)
+      end   
+      
+    end
+  end
+end

data/lib/usatoday-census/exceptions.rb

@@ -0,0 +1,38 @@
+module Usatoday
+  module Census
+		##
+		# The generic Error class from which all other Errors are derived.
+		class Error < ::RuntimeError
+		end
+		
+		##
+		# This error is thrown if there are problems authenticating your API key.
+		class AuthenticationError < Error
+		end
+		
+		##
+		# This error is thrown if the request was not parsable by the API server.
+		class BadRequestError < Error
+		end
+		
+		##
+		# This error is thrown if the response from the API server is not parsable.
+		class BadResponseError < Error
+		end
+		
+		##
+		# This error is thrown if there is an error connecting to the API server.
+		class ServerError < Error
+		end
+		
+		##
+		# This error is thrown if there is a timeout connecting to the server (to be implemented).
+		class TimeoutError < Error
+		end
+		
+		##
+		# This error is thrown for general connection errors to the API server.
+		class ConnectionError < Error
+		end
+	end
+end

data/lib/usatoday-census/housing.rb

@@ -0,0 +1,39 @@
+module Usatoday
+  module Census
+    class Housing < Base
+      
+      TEXT_FIELDS = %w(place_name state_postal)
+      NUMERIC_FIELDS = %w(fips gnis housing_units)
+      DECIMAL_FIELDS = %w(pct_vacant)
+      
+      ALL_FIELDS = TEXT_FIELDS + DECIMAL_FIELDS + NUMERIC_FIELDS
+      
+      attr_reader *ALL_FIELDS
+      
+      def initialize(params={})
+				params.each_pair do |k,v|
+					instance_variable_set("@#{k}", v)
+				end
+			end
+      
+      def self.init_from_api(params)
+        housing = Housing.new(
+        :place_name => text_field(params['Placename']),
+        :state_postal => text_field(params['StatePostal']),
+        :fips => integer_field(params['FIPS']),
+        :gnis => integer_field(params['GNIS']),
+        :pct_vacant => float_field(params['PctHisp']),
+        :housing_units => integer_field(params['HousingUnits'])
+        )
+        housing
+      end
+      
+      def self.search(keypat, keyname=nil)
+        params = prepare_params(keypat, keyname)
+  			response = invoke('housing', params)
+  			init_from_api(response)
+      end   
+      
+    end
+  end
+end

data/lib/usatoday-census/location.rb

@@ -0,0 +1,59 @@
+module Usatoday
+  module Census
+    class Location < Base
+      
+      TEXT_FIELDS = %w(place_name place_name_full state_ap state_postal)
+      NUMERIC_FIELDS = %w(fips gnis population housing_units)
+      DECIMAL_FIELDS = %w(pct_change pct_hispanic pct_non_hispanic pct_white pct_non_hispanic_white pct_black pct_american_indian pct_asian pct_native_hawaiian pct_two_or_more pct_other usat_diversity_index population_density land_square_miles water_square_miles total_square_miles latitude longitude pct_vacant)
+      
+      ALL_FIELDS = TEXT_FIELDS + DECIMAL_FIELDS + NUMERIC_FIELDS
+      
+      attr_reader *ALL_FIELDS
+      
+      def initialize(params={})
+				params.each_pair do |k,v|
+					instance_variable_set("@#{k}", v)
+				end
+			end
+      
+      def self.init_from_api(params)
+        location = Location.new(
+        :place_name => text_field(params['Placename']),
+        :place_name_full => text_field(params['PlacenameFull']),
+        :state_ap => text_field(params['StateAP']),
+        :state_postal => text_field(params['StatePostal']),
+        :fips => integer_field(params['FIPS']),
+        :gnis => integer_field(params['GNIS']),
+        :population => integer_field(params['Pop']),
+        :housing_units => integer_field(params['HousingUnits']),
+        :pct_change => float_field(params['PctChange']),
+        :pct_hispanic => float_field(params['PctHisp']),
+        :pct_non_hispanic => float_field(params['PctNonHisp']),
+        :pct_white => float_field(params['PctWhite']),
+        :pct_non_hispanic_white => float_field(params['PctNonHispWhite']),
+        :pct_black => float_field(params['PctBlack']),
+        :pct_american_indian => float_field(params['PctAmInd']),
+        :pct_asian => float_field(params['PctAsian']),
+        :pct_native_hawaiian => float_field(params['PctNatHawOth']),
+        :pct_two_or_more => float_field(params['PctTwoOrMore']),
+        :pct_other => float_field(params['PctOther']),
+        :usat_diversity_index => float_field(params['USATDiversityIndex']),
+        :population_density => float_field(params['PopSqMi']),
+        :land_square_miles => float_field(params['LandSqMi']),
+        :water_square_miles => float_field(params['WaterSqMi']),
+        :total_square_miles => float_field(params['TotSqMi']),
+        :latitude => float_field(params['Lat']),
+        :longitude => float_field(params['Long']),
+        :pct_vacant => float_field(params['PctVacant'])
+        )
+        location
+      end
+    
+      def self.search(keypat, keyname=nil)
+        params = prepare_params(keypat, keyname)
+  			response = invoke('locations', params)
+  			init_from_api(response)
+      end
+    end
+  end
+end

data/lib/usatoday-census/population.rb

@@ -0,0 +1,40 @@
+module Usatoday
+  module Census
+    class Population < Base
+      
+      TEXT_FIELDS = %w(place_name state_postal)
+      NUMERIC_FIELDS = %w(fips gnis population)
+      DECIMAL_FIELDS = %w(pct_change population_density)
+      
+      ALL_FIELDS = TEXT_FIELDS + DECIMAL_FIELDS + NUMERIC_FIELDS
+      
+      attr_reader *ALL_FIELDS
+      
+      def initialize(params={})
+				params.each_pair do |k,v|
+					instance_variable_set("@#{k}", v)
+				end
+			end
+      
+      def self.init_from_api(params)
+        population = Population.new(
+        :place_name => text_field(params['Placename']),
+        :state_postal => text_field(params['StatePostal']),
+        :fips => integer_field(params['FIPS']),
+        :gnis => integer_field(params['GNIS']),
+        :pct_change => float_field(params['PctChange']),
+        :population => integer_field(params['Pop']),
+        :population_density => float_field(params['PopSqMi'])
+        )
+        population
+      end
+      
+      def self.search(keypat, keyname=nil)
+        params = prepare_params(keypat, keyname)
+  			response = invoke('population', params)
+  			init_from_api(response)
+      end   
+      
+    end
+  end
+end

data/lib/usatoday-census/query.rb

@@ -0,0 +1,28 @@
+require 'digest'
+
+module Usatoday
+  module Census
+	  ##
+	  # The Query class represents a single query to the Census API.  Supports
+	  # all of the named parameters to C.search as accessor methods.
+	  #
+	  class Query
+      FIELDS = [:only_facets, :except_facets, :begin_date, :end_date, :since, 
+	              :before, :fee, :has_thumbnail, :facets, :fields, :query, :offset] + Article::TEXT_FIELDS.map{|f| f.to_sym}
+      FIELDS.each {|f| attr_accessor f}
+      
+      # Produce a hash which uniquely identifies this query
+      def hash
+        strs = FIELDS.collect {|f| "#{f}:#{send(f).inspect}"}
+        Digest::SHA256.hexdigest(strs.join(' '))
+      end
+      
+      # Perform this query.  Returns result of Article.search
+      def perform
+        params = {}
+        FIELDS.each {|f| params[f] = send(f) unless send(f).nil?}
+        Article.search(params)
+      end
+    end
+  end
+end

data/lib/usatoday-census/race.rb

@@ -0,0 +1,43 @@
+module Usatoday
+  module Census
+    class Race < Base
+      
+      TEXT_FIELDS = %w(place_name state_postal)
+      NUMERIC_FIELDS = %w(fips gnis)
+      DECIMAL_FIELDS = %w(pct_white pct_black pct_american_indian pct_asian pct_native_hawaiian pct_two_or_more)
+      
+      ALL_FIELDS = TEXT_FIELDS + DECIMAL_FIELDS + NUMERIC_FIELDS
+      
+      attr_reader *ALL_FIELDS
+      
+      def initialize(params={})
+				params.each_pair do |k,v|
+					instance_variable_set("@#{k}", v)
+				end
+			end
+      
+      def self.init_from_api(params)
+        race = Race.new(
+        :place_name => text_field(params['Placename']),
+        :state_postal => text_field(params['StatePostal']),
+        :fips => integer_field(params['FIPS']),
+        :gnis => integer_field(params['GNIS']),
+        :pct_white => float_field(params['PctWhite']),
+        :pct_black => float_field(params['PctBlack']),
+        :pct_american_indian => float_field(params['PctAmInd']),
+        :pct_asian => float_field(params['PctAsian']),
+        :pct_native_hawaiian => float_field(params['PctNatHawOth']),
+        :pct_two_or_more => float_field(params['PctTwoOrMore'])
+        )
+        race
+      end
+      
+      def self.search(keypat, keyname=nil)
+        params = prepare_params(keypat, keyname)
+  			response = invoke('race', params)
+  			init_from_api(response)
+      end   
+      
+    end
+  end
+end

data/lib/usatoday-census/version.rb

@@ -0,0 +1,5 @@
+module Usatoday
+  module Census
+    VERSION = "0.0.1"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,17 @@
+require 'test/unit'
+require 'rubygems'
+require 'shoulda'
+require 'json'
+
+%w(base exceptions location ethnicity housing population race).each do |f|
+  require File.join(File.dirname(__FILE__), '../lib/usatoday-census', f)
+end
+
+include Usatoday::Census
+
+# set your USAT Census API key as an environment variable to run the tests
+API_KEY = ENV['USAT_CENSUS_API_KEY']
+Base.api_key = API_KEY
+
+module TestUsatoday
+end

data/test/usatoday-census/test_ethnicity.rb

@@ -0,0 +1,36 @@
+class TestUsatoday::TestEthnicity < Test::Unit::TestCase
+	include Usatoday::Census
+	
+	context "Ethnicity.new" do
+		setup do
+		  sleep(1)
+		  response = Base.invoke('ethnicity', {'keypat' => 'pa'})
+			@ethnicity = Ethnicity.init_from_api(response)
+		end
+		
+		should "return an object of the Ethnicity type" do
+			assert_kind_of(Ethnicity, @ethnicity)
+		end
+  end
+  
+  context "Ethnicity.new with placename" do
+    setup do
+      sleep(1)
+      @ethnicity = Ethnicity.search('Virginia', 'Placename')
+    end
+		should "return an object of the Ethnicity type" do
+			assert_kind_of(Ethnicity, @ethnicity)
+		end
+	end
+	
+  context "Ethnicity.new with FIPS" do
+    setup do
+      sleep(1)
+      @ethnicity = Ethnicity.search(51, 'FIPS')
+    end
+		should "return an object of the Ethnicity type" do
+			assert_kind_of(Ethnicity, @ethnicity)
+		end
+	end
+	
+end

data/test/usatoday-census/test_housing.rb

@@ -0,0 +1,36 @@
+class TestUsatoday::TestHousing < Test::Unit::TestCase
+	include Usatoday::Census  
+	context "Housing.new" do
+		setup do
+		  sleep(1)
+		  response = Base.invoke('housing', {'keypat' => 'va'})
+			@housing = Housing.init_from_api(response)
+		end
+		
+		should "return an object of the Housing type" do
+			assert_kind_of(Housing, @housing)
+		end
+  end
+  
+  context "Housing.new with placename" do
+    setup do
+      sleep(1)
+      @housing = Housing.search('Virginia', 'Placename')
+    end
+		should "return an object of the Housing type" do
+			assert_kind_of(Housing, @housing)
+		end
+	end
+
+  context "Housing.new with FIPS" do
+    setup do
+      sleep(1)
+      @housing = Housing.search(51, 'FIPS')
+    end
+		should "return an object of the Housing type" do
+			assert_kind_of(Housing, @housing)
+		end
+	end
+
+
+end

data/test/usatoday-census/test_location.rb

@@ -0,0 +1,36 @@
+class TestUsatoday::TestLocation < Test::Unit::TestCase
+	include Usatoday::Census  
+	context "Location.new" do
+		setup do
+		  sleep(1)
+		  response = Base.invoke('locations', {'keypat' => 'va'})
+			@location = Location.init_from_api(response)
+		end
+		
+		should "return an object of the Location type" do
+			assert_kind_of(Location, @location)
+		end
+  end
+  
+  context "Location.new with placename" do
+    setup do
+      sleep(1)
+      @location = Location.search('Virginia', 'Placename')
+    end
+		should "return an object of the Location type" do
+			assert_kind_of(Location, @location)
+		end
+	end
+
+  context "Location.new with FIPS" do
+    setup do
+      sleep(1)
+      @location = Location.search(51, 'FIPS')
+    end
+		should "return an object of the Location type" do
+			assert_kind_of(Location, @location)
+		end
+	end
+
+
+end

data/test/usatoday-census/test_population.rb

@@ -0,0 +1,36 @@
+class TestUsatoday::TestPopulation < Test::Unit::TestCase
+	include Usatoday::Census  
+	context "Population.new" do
+		setup do
+		  sleep(1)
+		  response = Base.invoke('population', {'keypat' => 'va'})
+			@population = Population.init_from_api(response)
+		end
+		
+		should "return an object of the Population type" do
+			assert_kind_of(Population, @population)
+		end
+  end
+  
+  context "Population.new with placename" do
+    setup do
+      sleep(1)
+      @population = Population.search('Virginia', 'Placename')
+    end
+		should "return an object of the Population type" do
+			assert_kind_of(Population, @population)
+		end
+	end
+
+  context "Population.new with FIPS" do
+    setup do
+      sleep(1)
+      @population = Population.search(51, 'FIPS')
+    end
+		should "return an object of the Population type" do
+			assert_kind_of(Population, @population)
+		end
+	end
+
+
+end

data/test/usatoday-census/test_race.rb

@@ -0,0 +1,36 @@
+class TestUsatoday::TestRace < Test::Unit::TestCase
+	include Usatoday::Census  
+	context "Race.new" do
+		setup do
+		  sleep(1)
+		  response = Base.invoke('race', {'keypat' => 'va'})
+			@race = Race.init_from_api(response)
+		end
+		
+		should "return an object of the Race type" do
+			assert_kind_of(Race, @race)
+		end
+  end
+  
+  context "Race.new with placename" do
+    setup do
+      sleep(1)
+      @race = Race.search('Virginia', 'Placename')
+    end
+		should "return an object of the Race type" do
+			assert_kind_of(Race, @race)
+		end
+	end
+
+  context "Race.new with FIPS" do
+    setup do
+      sleep(1)
+      @race = Race.search(51, 'FIPS')
+    end
+		should "return an object of the Race type" do
+			assert_kind_of(Race, @race)
+		end
+	end
+
+
+end

data/usatoday-census.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "usatoday-census/version"
+
+Gem::Specification.new do |s|
+  s.name        = "usatoday-census"
+  s.version     = Usatoday::Census::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Derek Willis"]
+  s.email       = ["dwillis@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Wrapper for USA Today Census API}
+  s.description = %q{Retrieves state population and demographic information.}
+
+  s.rubyforge_project = "usatoday-census"
+  
+  s.add_dependency "shoulda"
+  s.add_dependency "json"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification 
+name: usatoday-census
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Derek Willis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-31 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: Retrieves state population and demographic information.
+email: 
+- dwillis@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- lib/usatoday-census.rb
+- lib/usatoday-census/base.rb
+- lib/usatoday-census/ethnicity.rb
+- lib/usatoday-census/exceptions.rb
+- lib/usatoday-census/housing.rb
+- lib/usatoday-census/location.rb
+- lib/usatoday-census/population.rb
+- lib/usatoday-census/query.rb
+- lib/usatoday-census/race.rb
+- lib/usatoday-census/version.rb
+- test/test_helper.rb
+- test/usatoday-census/test_ethnicity.rb
+- test/usatoday-census/test_housing.rb
+- test/usatoday-census/test_location.rb
+- test/usatoday-census/test_population.rb
+- test/usatoday-census/test_race.rb
+- usatoday-census.gemspec
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: usatoday-census
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: Wrapper for USA Today Census API
+test_files: 
+- test/test_helper.rb
+- test/usatoday-census/test_ethnicity.rb
+- test/usatoday-census/test_housing.rb
+- test/usatoday-census/test_location.rb
+- test/usatoday-census/test_population.rb
+- test/usatoday-census/test_race.rb