campaign_cash 1.3 → 1.5

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2011 The New York Times Company
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this library except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.rdoc

@@ -1,7 +1,6 @@
 = campaign_cash
 
-* Docs[http://dwillis.github.com/campaign_cash/]
-* Source[http://github.com/dwillis/campaign_cash]
+* Source[http://github.com/nytimes/campaign_cash]
 
 == DESCRIPTION:
 
@@ -9,7 +8,7 @@ Simple ruby wrapper for The New York Times Campaign Finance API[http://developer
 
 == INSTALL:
 
-* <tt>sudo gem install campaign_cash</tt>
+* <tt>gem install campaign_cash</tt>
 
 == USAGE:
 
@@ -20,12 +19,14 @@ You'll want to set your API key as an environment variable in order to run the t
 
   Base.api_key = YOUR_API_KEY
   
-Currently there are methods to support retrieving candidates and committees, and every method requires at least one parameter,
-the election cycle. Some examples (provided you've done include CampaignCash):
+Currently there are methods to support retrieving candidates, committees, electronic filings, committee contributions and independent expenditures. Almost every method requires at least one parameter, the election cycle. Some examples (provided you've done include CampaignCash):
 
-  Candidate.find("H4NY07011", 2010)  # find Gary Ackerman's details for the 2010 cycle
-  Committee.search("Growth", 2010) # find all committees in the 2010 cycle with the word 'Growth' in the name.
+  Candidate.find("H4NY07011", 2012)  # find Gary Ackerman's details for the 2012 cycle
+  Committee.search("Growth", 2012) # find all committees in the 2012 cycle with the word 'Growth' in the name.
   Candidate.search("Udall", 2010) # find all candidates in the 2010 cycle with the name 'Udall'
+  Filing.today  # find all the electronic filings made today.
+  Contribution.find("C00458588",2010,"H0NC02059") # find all contributions by the committee to the candidate in the 2010 cycle.
+  IndependentExpenditure.candidate("P60003654", 2012) # find independent expenditures about Newt Gingrich in the 2012 cycle.
 
 Check out the tests for further examples.
 
@@ -39,27 +40,10 @@ Check out the tests for further examples.
   (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:
+== Authors
 
-(The MIT License)
+Derek Willis, dwillis@nytimes.com
 
-Copyright (c) 2010 Derek Willis
+== Copyright
 
-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.
+Copyright (c) 2011 The New York Times Company. See LICENSE for details.

data/Rakefile

@@ -1,4 +1,5 @@
 require 'bundler'
+include Rake::DSL
 Bundler::GemHelper.install_tasks
 
 require 'rake/testtask'
@@ -9,13 +10,3 @@ Rake::TestTask.new(:test) do |test|
 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/campaign_cash/committee.rb

@@ -2,11 +2,11 @@ module CampaignCash
   class Committee < Base
     
     attr_reader :name, :id, :state, :district, :party, :fec_uri, :candidate, 
-                :city, :address, :state, :zip, :relative_uri,
+                :city, :address, :state, :zip, :relative_uri, :sponsor_name,
                 :total_receipts, :total_contributions, :total_from_individuals, 
                 :total_from_pacs, :candidate_loans, :total_disbursements,
                 :total_refunds, :debts_owed, :begin_cash, :end_cash,
-                :date_coverage_to, :date_coverage_from, :other_cycles
+                :date_coverage_to, :date_coverage_from, :other_cycles, :super_pac
     
     def initialize(params={})
       params.each_pair do |k,v|
@@ -49,7 +49,10 @@ module CampaignCash
 		           :party => params['party'],
 		           :relative_uri => params['relative_uri'],
 		           :candidate => params['candidate'],
-		           :treasurer => params['treasurer']
+		           :treasurer => params['treasurer'],
+		           :fec_uri => params['fec_uri'],
+		           :super_pac => params['super_pac'],
+		           :sponsor_name => params['sponsor_name']
 		  
 		end
     
@@ -71,9 +74,10 @@ module CampaignCash
       results.map{|c| create(c)}      
     end
     
-    def contributions
-      reply = invoke("#{cycle}/committees/#{id}/contributions")
-      
+    def self.superpacs(cycle=CURRENT_CYCLE)
+      reply = invoke("#{cycle}/committees/superpacs")
+			results = reply['results']      
+      results.map{|c| create_from_search_results(c)}
     end
     
   end

data/lib/campaign_cash/independent_expenditure.rb

@@ -0,0 +1,73 @@
+module CampaignCash
+  class IndependentExpenditure < Base
+    
+    attr_reader :fec_committee_id, :district, :state, :fec_committee_name, :purpose, :fec_candidate_id, :support_or_oppose, :date, :amount, :office, :amendment, :date_received, :payee, :fec_uri
+    
+    def initialize(params={})
+      params.each_pair do |k,v|
+        instance_variable_set("@#{k}", v)
+      end
+    end
+    
+    def self.create(params={})
+      self.new :fec_committee_id => params['fec_committee'].split('/').last.split('.').first,
+               :fec_committee_name => params['fec_committee_name'],
+               :fec_candidate_id => params['fec_candidate'].split('/').last.split('.').first,
+               :office => params['office'],
+               :state => params['state'].strip,
+               :district => params['district'],
+               :date => date_parser(params['date']),
+               :support_or_oppose => params['support_or_oppose'],
+               :payee => params['payee'],
+               :purpose => params['purpose'],
+               :amount => params['amount'],
+               :fec_uri => params['fec_uri'],
+               :date_received => date_parser(params['date_received'])
+    end
+    
+    def self.latest
+      reply = Base.invoke("#{Base::CURRENT_CYCLE}/independent_expenditures")
+      results = reply['results']
+      @independent_expenditures = results.map{|c| IndependentExpenditure.create(c)}
+    end
+    
+    def self.date(date)
+      d = Date.parse(date)
+      cycle = cycle_from_date(d)
+      reply = Base.invoke("#{cycle}/independent_expenditures/#{d.year}/#{d.month}/#{d.day}")
+      results = reply['results']
+      @independent_expenditures = results.map{|c| IndependentExpenditure.create(c)}      
+    end
+    
+    def self.committee(id, cycle)
+      @independent_expenditures = []
+      reply = Base.invoke("#{cycle}/committees/#{id}/independent_expenditures")
+      results = reply['results']
+      comm = reply['fec_committee']
+      results.each do |result|
+        result['fec_committee'] = comm
+        @independent_expenditures << IndependentExpenditure.create(result)
+      end
+      @independent_expenditures
+    end
+    
+    def self.candidate(id, cycle)
+      @independent_expenditures = []
+      reply = Base.invoke("#{cycle}/candidates/#{id}/independent_expenditures")
+      results = reply['results']
+      cand = reply['fec_candidate']
+      results.each do |result|
+        result['fec_candidate'] = cand
+        @independent_expenditures << IndependentExpenditure.create(result)
+      end
+      @independent_expenditures
+    end
+    
+    def self.president(cycle=Base::CURRENT_CYCLE)
+      reply = Base.invoke("#{cycle}/president/independent_expenditures")
+      results = reply['results']
+      @independent_expenditures = results.map{|c| IndependentExpenditure.create(c)}
+    end
+    
+  end
+end

data/lib/campaign_cash/version.rb

@@ -1,3 +1,3 @@
 module CampaignCash
-  VERSION = "1.3"
+  VERSION = "1.5"
 end

data/lib/campaign_cash.rb

@@ -1,3 +1,3 @@
-%w(base candidate committee contribution filing form).each do |f|
+%w(base candidate committee contribution filing form independent_expenditure).each do |f|
   require File.join(File.dirname(__FILE__), '../lib/campaign_cash', f)
 end

data/test/campaign_cash/test_committee.rb

@@ -97,4 +97,17 @@ class TestCampaignCash::TestCommittee < Test::Unit::TestCase
 	    assert_equal @contribution.total_amount, 10000
 	  end
 	end
+	
+	context "superpacs" do
+	  setup do
+	    reply = Base.invoke('2012/committees/superpacs')
+	    @committees = reply['results'].map{|c| Committee.create_from_search_results(c) }
+	  end
+	  
+	  should "return an array of super pacs" do
+	    assert_equal([true], @committees.map{|c| c.super_pac }.uniq)
+	  end
+	  
+	end
+	
 end

data/test/campaign_cash/test_filing.rb

@@ -19,8 +19,12 @@ class TestCampaignCash::TestFiling < Test::Unit::TestCase
 			@filings = Filing.today
 	  end
 	  
-		should "return a list of objects of the Filing type" do
-			assert_kind_of(Filing, @filings.first)
+		should "return a list of objects of the Filing type or an empty list" do
+		  if @filings.size > 0
+			  assert_kind_of(Filing, @filings.first)
+			else
+			  assert_equal([], @filings)
+			end
 		end
 	end
 	

data/test/campaign_cash/test_independent_expenditure.rb

@@ -0,0 +1,58 @@
+require 'test_helper'
+
+class TestCampaignCash::TestIndependentExpenditure < Test::Unit::TestCase
+	include CampaignCash
+		
+	context "latest independent expenditures" do
+	  setup do
+			@independent_expenditures = IndependentExpenditure.latest
+	  end
+	  
+		should "return a list of objects of the IndependentExpenditure type" do
+			assert_kind_of(IndependentExpenditure, @independent_expenditures.first)
+		end
+	end
+	
+	context "independent expenditures by date" do
+	  setup do
+	    @independent_expenditures = IndependentExpenditure.date("12/13/2011")
+	  end
+	  
+	  should "return at least one independent expenditure against Barack Obama" do
+	    assert_equal("P80003338", @independent_expenditures.first.fec_candidate_id)
+	  end
+	end
+	
+	context "a committee's independent expenditures in a cycle" do
+	  setup do
+	    @independent_expenditures = IndependentExpenditure.committee("C00490045", 2012)
+	  end
+	  
+	  should "return an array of IEs in the presidential race" do
+	    assert_equal("President", @independent_expenditures.first.office)
+	  end
+	end
+	
+	context "independent expenditures about a given candidate" do
+	  setup do
+	    @independent_expenditures = IndependentExpenditure.candidate("P60003654", 2012)
+	    @candidate = Candidate.find('P60003654')
+	  end
+	  
+	  should "return an array of IEs about presidential candidate Newt Gingrich" do
+	    assert_equal("President", @independent_expenditures.first.office)
+	    assert_equal(@candidate.name, "GINGRICH, NEWT")
+	  end
+	end
+	
+	context "independent expenditures in the presidential campaign" do
+	 setup do
+	   @independent_expenditures = IndependentExpenditure.president
+	  end
+	  
+	  should "return an array of IEs about the presidential campaign" do
+	    assert_equal(['President'], @independent_expenditures.map{|i| i.office }.uniq)
+	  end
+	end
+	
+end

data/test/test_helper.rb

@@ -4,12 +4,10 @@ require 'shoulda'
 require 'json'
 require 'ostruct'
 
-%w(base candidate committee contribution filing form).each do |f|
+%w(base candidate committee contribution filing form independent_expenditure).each do |f|
   require File.join(File.dirname(__FILE__), '../lib/campaign_cash', f)
 end
 
-include CampaignCash
-
 # set your NYT Campaign Finance API key as an environment variable to run the tests
 API_KEY = ENV['NYT_CAMPFIN_API_KEY']
 CampaignCash::Base.api_key = API_KEY

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: campaign_cash
 version: !ruby/object:Gem::Version 
-  hash: 9
+  hash: 5
   prerelease: 
   segments: 
   - 1
-  - 3
-  version: "1.3"
+  - 5
+  version: "1.5"
 platform: ruby
 authors: 
 - Derek Willis
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-03 00:00:00 -04:00
+date: 2011-12-17 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -59,6 +59,7 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - Gemfile
+- LICENSE
 - README.rdoc
 - Rakefile
 - campaign_cash.gemspec
@@ -69,11 +70,13 @@ files:
 - lib/campaign_cash/contribution.rb
 - lib/campaign_cash/filing.rb
 - lib/campaign_cash/form.rb
+- lib/campaign_cash/independent_expenditure.rb
 - lib/campaign_cash/version.rb
 - test/campaign_cash/test_candidate.rb
 - test/campaign_cash/test_committee.rb
 - test/campaign_cash/test_filing.rb
 - test/campaign_cash/test_form.rb
+- test/campaign_cash/test_independent_expenditure.rb
 - test/test_helper.rb
 has_rdoc: true
 homepage: http://rubygems.org/gems/campaign_cash
@@ -107,7 +110,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: campaign_cash
-rubygems_version: 1.4.2
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Following the money.
@@ -116,4 +119,5 @@ test_files:
 - test/campaign_cash/test_committee.rb
 - test/campaign_cash/test_filing.rb
 - test/campaign_cash/test_form.rb
+- test/campaign_cash/test_independent_expenditure.rb
 - test/test_helper.rb