foundation_center 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 84e79a417918c7041d15f7bb9080765299b06504
+  data.tar.gz: 00979da9c96ac05332773ec312126cfcf9596dc3
+SHA512:
+  metadata.gz: 00478d03b3c4454eb4e3f8d5c4b8951d37fc3d745e7f8e51b40e604e23182073840b53bd9c5c3bcf45484e507ca4f91482cbe0a617e911f39396cb377f3a57f5
+  data.tar.gz: 35da0a00fcd4680074a228584904e0b26e7f133f2d70d93ae66881c41fdcdfa469c7908b79031ee18df72c0f73a790fc5520aa989060adf4f26412c6e52f569b

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

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

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+ruby '2.0.0'
+
+# Specify your gem's dependencies in foundation-center.gemspec
+gemspec

data/LICENSE.txt

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

data/README.md

@@ -0,0 +1,40 @@
+# FoundationCenter
+
+A Ruby interface to the Foundation Center grant recipients API
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'foundation_center'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install foundation_center
+
+## Usage
+
+Fetch a list of grant recipients:
+
+    >> FoundationCenter.recipients
+    => [
+         {"recipient_ein"=>27121965, "recipient_name"=>"Emard-Parker",
+          "longitude"=>-86.08014482580468, "latitude"=>42.20946211250427},
+
+         {"recipient_ein"=>102016794, "recipient_name"=>"Cummerata, Heaney and Ullrich",
+          "longitude"=>-81.5489744409065, "latitude"=>32.790804352283004},
+
+          ...
+       ]
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/foundation_center.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'foundation_center'
+
+Gem::Specification.new do |spec|
+  spec.name          = "foundation_center"
+  spec.version       = FoundationCenter::VERSION
+  spec.authors       = ["Dan Porter"]
+  spec.email         = ["wolfpakz@gmail.com"]
+  spec.description   = %q{A Ruby interface to the Foundation Center grant recipients API}
+  spec.summary       = %q{Provides a simple interface for fetching information about grant recipients and the grants they've received.}
+  spec.homepage      = "http://github.com/wolfpakz/foundation-center"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "rest-client", "~> 1.6.7"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake", "~> 10.0.4"
+  spec.add_development_dependency "rspec", "~> 2.13.0"
+  spec.add_development_dependency "shoulda-matchers", "~> 2.1.0"
+  spec.add_development_dependency "faker", "~> 1.1.2"
+end

data/lib/foundation_center.rb

@@ -0,0 +1,24 @@
+require 'foundation_center/version'
+
+module FoundationCenter
+
+  URL = 'http://gisdev.foundationcenter.org/sustainArts/webServices'
+
+  class << self
+
+    def get_recipients
+      response = resource['getRecipients.php'].get
+      JSON.parse response
+    end
+
+    def get_recipient_details(ein)
+      response = resource['getRecipientDetails.php'].get :params => {:ein => ein}
+      JSON.parse response
+    end
+
+    def resource
+      RestClient::Resource.new(URL)
+    end
+
+  end
+end

data/lib/foundation_center/version.rb

@@ -0,0 +1,3 @@
+module FoundationCenter
+  VERSION = "0.1.0"
+end

data/spec/foundation_center_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+
+describe 'Foundation Center' do
+
+  context 'Listing grant recipients' do
+    before(:each) do
+      # Fake the response json
+      @fake_json = fake_recipients_json
+
+      RestClient::Resource.any_instance.should_receive(:get) { @fake_json }
+    end
+
+    it 'returns an array' do
+      FoundationCenter.get_recipients.should be_kind_of(Array)
+    end
+
+    it 'returns a hash for every grant recipient' do
+      # Parse the fake JSON so we can count the recipients
+      fakes = JSON.parse @fake_json
+      fakes.should be_kind_of(Array)
+
+      # One for every recipient
+      recipients = FoundationCenter.get_recipients
+      recipients.length.should == fakes.length
+
+      # All of which are hashes
+      recipients.each do |r|
+        r.should be_kind_of(Hash)
+      end
+    end
+  end
+
+  context 'Recipient details' do
+    before(:each) do
+      # Fake the response json
+      @fake_json = fake_recipient_details_json
+
+      @parsed_json = JSON.parse @fake_json
+      @ein         = @parsed_json['recipients'].first['recip_ein']
+
+      RestClient::Resource.any_instance.should_receive(:get) { @fake_json }
+    end
+
+    it 'returns a hash' do
+      FoundationCenter.get_recipient_details(@ein).should be_kind_of(Hash)
+    end
+
+    it 'returns details about a grant recipient' do
+      results = FoundationCenter.get_recipient_details(@ein)
+
+      results.should include('recipients')
+      results['recipients'].should be_an(Array)
+
+      recipient = results['recipients'].first
+      recipient.should be_a(Hash)
+      recipient.should include('recip_ein')
+
+      recipient['recip_ein'].should == @ein
+    end
+
+    it 'returns details about the grants a recipient has received' do
+      results = FoundationCenter.get_recipient_details(@ein)
+
+      results.should include('grants')
+      results['grants'].should be_an(Array)
+
+      grants = results['grants']
+      grants.all? { |grant| grant.is_a?(Hash) }.should be_true
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,109 @@
+require 'json'
+require 'faker'
+require 'rest-client'
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+def fake_ein
+  '%09d' % (rand(999999998) + 1)
+end
+
+def fake_recipients_json
+  #
+  # Yanked this directly from Foundation Center's API
+  #
+  "\r\n\r\n[{\"recipient_ein\":10559608,\"recipient_name\":\"Allied Media Projects\",\"longitude\":-83.0522468,\"latitude\":42.4140992},{\"recipient_ein\":10885325,\"recipient_name\":\"Harriet Tubman Center for Recruitment and Development of Organizers\",\"longitude\":-83.0433412,\"latitude\":42.3345747},{\"recipient_ein\":20648595,\"recipient_name\":\"Michigan Avenue Business Association\",\"longitude\":-83.1306395,\"latitude\":42.3311259},{\"recipient_ein\":20701008,\"recipient_name\":\"'Sistahs Providing Intelligence, Creativity and Empowerment'\",\"longitude\":-83.0522468,\"latitude\":42.4140992},{\"recipient_ein\":20754855,\"recipient_name\":\"Detroit International Jazz Festival Foundation\",\"longitude\":-83.130645,\"latitude\":42.4685724},{\"recipient_ein\":20755116,\"recipient_name\":\"Belle Isle Womens Committee\",\"longitude\":-83.209149,\"latitude\":42.5462149},{\"recipient_ein\":30390058,\"recipient_name\":\"Ballet Renaissance\",\"longitude\":-83.0522468,\"latitude\":42.4140992}]"
+end
+
+def fake_grant_key
+  rand(99999998) + 1
+end
+
+def fake_gm_key
+  '%s%03d' % [Faker::Lorem.words(1).first.upcase, rand(98) + 1]
+end
+
+def fake_grant_amount
+  ('%d000' % (rand(998) + 1)).to_i
+end
+
+def fake_grant_details
+  {
+    "grant_key"               => fake_grant_key,
+    "gm_key"                  => fake_gm_key,
+    "gm_ein"                  => fake_ein,
+    "gm_name"                 => Faker::Company.name,
+    "gm_state"                => Faker::Address.state_abbr,
+    "amount"                  => fake_grant_amount,
+    "duration"                => 1,
+    "year_issued"             => [2007, 2008, 2009, 2010, 2011, 2012, 2013].sample,
+    "description"             => Faker::Lorem.paragraph(5),
+    "grant_activity_code"     => "A3D; W52; R20",
+    "grant_activity_tran"     => "'Media access and policy; Electronic communications/Internet; Civil/human rights, advocacy'",
+    "grant_pop_code"          => "E0; P0",
+    "grant_pop_tran"          => "Minorities; Economically disadvantaged",
+    "grant_area_served_tran"  => " ",
+    "grant_support_tran"      => "Management development/capacity building; Advocacy; Electronic media/online services; Research; Technical assistance",
+    "matching_support_flag"   => " ",
+    "continuing_support_flag" => " ",
+    "source_of_data"          => "04/11-06/11 EF",
+    "grant_country_tran"      => " ",
+    "edition"                 => 812,
+    "currency"                => " ",
+    "unconverted_amt"         => " ",
+    "fund_name"               => " ",
+    "fund_type"               => " ",
+    "fund_sub_type"           => " ",
+    "program_area"            => " ",
+    "activity_override"       => "A3D",
+    "activity_override_tran"  => "Media access and policy",
+    "domestic_foreign_flag"   => "D",
+    "county"                  => "Wayne ",
+    "area_name"               => "'Detroit-Warren-Livonia, MI'"
+  }
+end
+
+def fake_recipient_details
+  {
+    'recipient_key'      => rand(9999998) + 1,
+    'recip_ein'          => fake_ein,
+    'recip_name'         => Faker::Company.name,
+    'recip_street_addr'  => Faker::Address.street_address,
+    'recip_street_addr2' => Faker::Address.secondary_address,
+    'recip_city'         => Faker::Address.city,
+    'recip_state'        => Faker::Address.state_abbr,
+    'recip_zipcode'      => Faker::Address.zip_code,
+    'recip_county'       => "Wayne",
+    'recip_type_code'    => "A3E",
+    'recip_type_tran'    => "Media democracy",
+    'recip_auspice'      => "N",
+    'recip_pop_code'     => "E0; P0",
+    'recip_pop_tran'     => "Minorities; Economically disadvantaged",
+    'recip_unit'         => " ",
+    'longitude'          => -83.0522468,
+    'latitude'           => 42.4140992
+  }
+end
+
+def fake_recipient_details_json
+  {
+    :recipients => [fake_recipient_details],
+    :grants => (rand(4) + 1).times.map { fake_grant_details }
+  }.to_json
+end

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: foundation_center
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dan Porter
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.0.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.0.4
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+- !ruby/object:Gem::Dependency
+  name: shoulda-matchers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.2
+description: A Ruby interface to the Foundation Center grant recipients API
+email:
+- wolfpakz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- foundation_center.gemspec
+- lib/foundation_center.rb
+- lib/foundation_center/version.rb
+- spec/foundation_center_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/wolfpakz/foundation-center
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Provides a simple interface for fetching information about grant recipients
+  and the grants they've received.
+test_files:
+- spec/foundation_center_spec.rb
+- spec/spec_helper.rb