campaign_cash 1.8 → 2.0

data/README.rdoc

@@ -1,6 +1,10 @@
-= campaign_cash
 
-* Source[http://github.com/nytimes/campaign_cash]
+    ____                            _                ____          _     
+   / ___|__ _ _ __ ___  _ __   __ _(_) __ _ _ __    / ___|__ _ ___| |__  
+  | |   / _` | '_ ` _ \| '_ \ / _` | |/ _` | '_ \  | |   / _` / __| '_ \ 
+  | |__| (_| | | | | | | |_) | (_| | | (_| | | | | | |__| (_| \__ \ | | |
+   \____\__,_|_| |_| |_| .__/ \__,_|_|\__, |_| |_|  \____\__,_|___/_| |_|
+                       |_|            |___/
 
 == DESCRIPTION:
 
@@ -18,25 +22,161 @@ For use in a Rails 3 application, put the following in your Gemfile:
 
 then issue the 'bundle install' command. Campaign Cash has been tested under Ruby 1.8.7 and 1.9.2.
 
-== USAGE:
+== GETTING STARTED:
 
   require 'rubygems'
   require 'campaign_cash'
 
 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:
 
+  include CampaignCash
   Base.api_key = YOUR_API_KEY
   
-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):
+Currently there are methods to support retrieving candidates, presidential candidates, committees, electronic filings, committee contributions and independent expenditures. Almost every method requires at least one parameter, the election cycle.
 
-  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.
+== Candidates
 
-Check out the tests for further examples.
+Candidate objects can be created in several ways. To locate a candidate by last name, supply the name and cycle:
+
+  Candidate.search("Bass", 2012)
+  #=> [#<CampaignCash::Candidate:0x101bb3d00 @name="BASS, CHARLES F.", @state="NH", @party="REP", @district=2, @committee_id="C00302570", @office="house", @id="H0NH02017">, #<CampaignCash::Candidate:0x101bb2f90 @name="BASS, KAREN", @state="CA", @party="DEM", @district=33, @committee_id="C00476523", @office="house", @id="H0CA33117">]
+
+Search returns an array of basic information about candidates, including the unique Federal Election Commission-provided identifier, which begins with an "H" for House candidates, "S" for Senate candidates and "P" for presidential candidates. The id, along with the election cycle, can be used to retrieve more information about a candidate:
+
+  Candidate.find("H0NH02017", 2012)
+  #=> #<CampaignCash::Candidate:0x101b9af80 @name="BASS, CHARLES F.", @state="NH", @fec_uri="http://query.nictusa.com/cgi-bin/fecimg/?H0NH02017", @total_disbursements=120650.0, @total_contributions=570853.0, @mailing_address="PO BOX 210", @begin_cash=31676.0, @party="REP", @candidate_loans=nil, @total_receipts=577512.0, @date_coverage_from="2011-01-01", @mailing_city="PETERBOROUGH", @debts_owed=nil, @district=2, @total_from_pacs=414250.0, @mailing_zip="03458", @date_coverage_to="2011-09-30", @committee_id="C00302570", @total_refunds=nil, @office="house", @total_from_individuals=156603.0, @id="H0NH02017", @mailing_state="NH", @end_cash=488538.0, @status="I">
+  
+Candidate.find returns an object containing more detailed information for a candidate, including the latest financial summary from the F.E.C. and the candidate's committee ID, which can be used to make other method calls.
+
+Several other canned queries are available. To list the top 20 candidates in terms of one of the financial categories (available by calling Candidate.categories or listed at http://developer.nytimes.com/docs/read/campaign_finance_api#h3-candidate-leaders), supply the category and cycle:
+
+  Candidate.leaders('end-cash', 2012)
+  #=> [#<CampaignCash::Candidate:0x101b76b80 @name="OBAMA, BARACK", @state=nil, @fec_uri=nil, @total_disbursements=29327600.0, @total_contributions=65393200.0, @mailing_address=nil, @begin_cash=2303400.0, @party="DEM", @candidate_loans=nil, @total_receipts=nil, @date_coverage_from="2011-01-01", @mailing_city=nil, @debts_owed=1709300.0, @district=0, @total_from_pacs=nil, @mailing_zip=nil, @date_coverage_to="2011-09-30", @committee_id="C00430892", @total_refunds=944100.0, @office=nil, @total_from_individuals=65393200.0, @id=nil, @mailing_state=nil, @end_cash=61400700.0, @status="I">, #<CampaignCash::Candidate:0x101b75730 @name="SHELBY, RICHARD C", @state="AL", @fec_uri=nil, @total_disbursements=1508100.0, @total_contributions=4693320.0, @mailing_address=nil, @begin_cash=13381000.0, @party="REP", @candidate_loans=nil, @total_receipts=nil, @date_coverage_from="2009-01-01", @mailing_city=nil, @debts_owed=nil, @district=0, @total_from_pacs=1671200.0, @mailing_zip=nil, @date_coverage_to="2010-12-31", @committee_id="C00193623", @total_refunds=25800.0, @office=nil, @total_from_individuals=3022120.0, @id=nil, @mailing_state=nil, @end_cash=17156600.0, @status="I"> ...]
+  
+Please note that not all candidates file on the same schedule, so some of the "date_coverage_to" will be different for these responses. Senate candidates, in particular, often file twice a year during the odd-numbered years prior to a general election.
+
+To retrieve an array of the 20 newest candidates (the F.E.C.'s data is updated every Monday), use the new_candidates class method:
+
+  Candidate.new_candidates
+  #=> [#<CampaignCash::Candidate:0x101b11d20 @name="ANDERSON, JASON EDWARD", @state="AL", @fec_uri="http://query.nictusa.com/cgi-bin/fecimg/?H2AL05086", @total_disbursements=nil, @total_contributions=nil, @mailing_address=nil, @begin_cash=nil, @party="REP", @candidate_loans=nil, @total_receipts=nil, @date_coverage_from=nil, @mailing_city="HAZEL GREEN", @debts_owed=nil, @district=5, @total_from_pacs=nil, @mailing_zip="35750", @date_coverage_to=nil, @committee_id="C00508374", @total_refunds=nil, @office="house", @total_from_individuals=nil, @id="H2AL05086", @mailing_state="AL", @end_cash=nil, @status=nil>, #<CampaignCash::Candidate:0x101b10420 @name="NORRIS, PHILLIP DWIGHT", @state="AL", @fec_uri="http://query.nictusa.com/cgi-bin/fecimg/?H2AL07165", @total_disbursements=nil, @total_contributions=nil, @mailing_address=nil, @begin_cash=nil, @party="REP", @candidate_loans=nil, @total_receipts=nil, @date_coverage_from=nil, @mailing_city="HOOVER", @debts_owed=nil, @district=7, @total_from_pacs=nil, @mailing_zip="35216", @date_coverage_to=nil, @committee_id="C00508382", @total_refunds=nil, @office="house", @total_from_individuals=nil, @id="H2AL07165", @mailing_state="AL", @end_cash=nil, @status=nil>,
+
+To retrieve an array of candidates for a particular seat, supply a state abbreviation, chamber ('house' or 'senate'), district (an integer or nil) and cycle. For example, the following asks for candidates for Maryland's 6th Congressional District in 2012:
+
+  Candidate.state_chamber('MD', 'house', 6, 2012)
+  #=> [#<CampaignCash::Candidate:0x101abea58 @name="CLARK, CASEY", @state="MD", @party="DEM", @district=0, @committee_id="C00460436", @office="house", @id="H0MD06173">, #<CampaignCash::Candidate:0x101abe2b0 @name="TAYLOR, STEVEN MICHAEL", @state="MD", @party="REP", @district=0, @committee_id="C00481788", @office="house", @id="H0MD06181">, #<CampaignCash::Candidate:0x101abdb08 @name="BARTLETT, ROSCOE G. REP.", @state="MD", @party="REP", @district=0, @committee_id="C00255190", @office="house", @id="H2MD06054">,...]
+
+== President
+  
+Presidential candidate objects are like regular Candidates, except that they have additional financial attributes that are calculated by The New York Times from electronic filings. There are two President methods. To retrieve a listing of all presidential candidates being tracked by The Times:
+
+  President.summary
+  #=> [#<CampaignCash::President:0x101be6c78 @name="Barack Obama", @party="D", @total_receipts="99597680.72", @date_coverage_from="2011-01-01", @date_coverage_to="2011-09-30", @committee_id="C00431445", @id="P80003338", @end_cash="61403710.55", @total_disbursements="106877585.73">, #<CampaignCash::President:0x101be6688 @name="Mitt Romney", @party="R", @total_receipts="32605827.32", @date_coverage_from="2010-10-01", @date_coverage_to="2011-09-30", @committee_id="C00431171", @id="P80003353", @end_cash="14656965.83", @total_disbursements="17953283.44">,...]
+  
+To retrieve detailed information for a single presidential candidate, pass the appropriate committee_id and cycle:
+
+  President.detail('C00431171', 2012)
+  #=> [#<CampaignCash::President:0x101bd3d58 @name="Romney, Mitt", @party="R", @contributions_less_than_200="3393540.5", @total_receipts="32605827.32", @date_coverage_from="2010-10-01", @net_candidate_contributions="0.0", @contributions_1500_2499="1566753.77", @federal_funds="0.0", @date_coverage_to="2011-09-30", @net_party_contributions="0.0", @committee_id="C00431171", @total_refunds="270101.47", @contributions_500_1499="5965455.03", @net_general_contributions="0.0", @id="P80003353", @end_cash="14656965.83", @net_pac_contributions="177301.13", @total_disbursements="17953283.44", @contributions_200_499="977647.0", @total_contributions="32482490.51", @net_primary_contributions="14656965.83", @net_individual_contributions="32035087.91", @contributions_max="19930000.0">]
+  
+Among the calculated attributes are totals for five ranges of contribution size (the maximum individual contribution for the 2012 cycle is $2,500 per person, per election, while in 2008 it was $2,300).
+
+== Committees
+
+Committee objects have information about F.E.C.-registered committees that may or may not be affiliated to a candidate. If a committee is associated with a candidate, it will have values for the district, party and candidate_id attributes. Party committees should also have the party attribute set. If it is defined as a leadership committee, a committee's leadership attribute will be set to True; a similar attribute, super_pac, is set to True if the committee is registered with the F.E.C. as a "Super PAC" able to raise unlimited amounts for independent expenditures.
+
+Searching for a committee currently executes a "begins with" query, so to find all committees in the 2012 cycle that start with the word 'Growth':
+
+  Committee.search("Growth", 2012)
+  #=> [#<CampaignCash::Committee:0x101bebb38 @name="GROWTH AND PROSPERITY POLITICAL ACTION COMMITTEE", @state="AL", @party="", @super_pac=nil, @leadership=true, @district=nil, @city="BIRMINGHAM", @id="C00388793", @treasurer="DOBBS, JOEY", @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00388793/", @zip="35222", @candidate_id=nil>, #<CampaignCash::Committee:0x101beb368 @name="GROWTH ENERGY PAC", @state="DC", @party="", @super_pac=nil, @leadership=false, @district=nil, @city="WASHINGTON", @id="C00475665", @treasurer="BUTTERFIELD, BEN", @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00475665/", @zip="20002", @candidate_id=nil>]
+
+As with Candidate.search, the results of Committee.search return a subset of all Committee attributes. The full Committee object includes the most recent financial summary data available, plus the other election cycles that the committee is registered in dating back to 1980. Some committees have a sponsor, which could be a corporation, association or candidate. Also included are several F.E.C.-defined categories, including filing frequency, committee designation (who controls it, essentially), committee type (House, Senate, etc.) and interest group category (corporation, labor union, etc.). These last four attributes are not universally present in the data, which is why a Committee object has an independent leadership attribute even though the designation should indicate if it is a leadership committee. More details these codes is available from the F.E.C.: ftp://ftp.fec.gov/FEC/cm_dictionary.txt.
+
+To fetch the details for a single committee in a cycle:
+
+  Committee.find("C00326389", 2012)
+  #=> #<CampaignCash::Committee:0x101bd4118 @name="SNAKE RIVER SUGAR COMPANY POLITICAL ACTION COMMITTEE", @state="ID", @party="", @candidate_loans=nil, @total_receipts=30363.3, @date_coverage_from="2011-01-01", @designation="Unauthorized", @other_cycles=[2010, 2008, 2006, 2004, 2002, 2000, 1998], @city="BOISE", @debts_owed=nil, @total_from_pacs=nil, @date_coverage_to="2011-11-30", @filing_frequency="Monthly", @sponsor_name=nil, @total_refunds=nil, @total_from_individuals=30363.3, @id="C00326389", @leadership=false, @zip="83709", @end_cash=16845.2, @committee_type=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00326389/", @total_disbursements=46500.0, @total_contributions=30363.3, @interest_group="Cooperative", @super_pac=false, @address="1951 SOUTH SATURN WAY", @begin_cash=32981.9, @candidate_id=nil>
+  
+Individual Committee objects can retrieve an array of filings they have made during a given cycle:
+
+  committee = Committee.find("C00326389", 2012)
+  committee.filings
+  #=> [#<CampaignCash::Filing:0x101bc9100 @amended_uri=nil, @paper=false, @amended=false, @committee_name=nil, @date_coverage_from=#<Date: 4911793/2,0,2299161>, @original_uri=nil, @report_title="YEAR-END", @date_coverage_to=#<Date: 4911853/2,0,2299161>, @form_type="F3", @committee=nil, @original_filing=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00326389/756540/">,...]
+  
+For more information on Filing objects, see Filings below.
+  
+To retrieve a list of the 20 most recently added committees (note that no cycle parameter is needed; this method always uses the most recent cycle):
+
+  Committee.latest
+  #=> [#<CampaignCash::Committee:0x101be6020 @name="AMERICA'S IMPACT POLITICAL FUND", @state="DC", @party="", @super_pac=false, @leadership=false, @district=nil, @city="WASHINGTON", @id="C00508366", @treasurer="BENJAMIN GOLDSMITH", @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00508366/", @zip="20005", @candidate_id=nil>, #<CampaignCash::Committee:0x101be55a8 @name="JASON ANDERSON FOR CONGRESS", @state="AL", @party="REP", @super_pac=false, @leadership=false, @district=nil, @city="HAZEL GREEN", @id="C00508374", @treasurer="CHRISTOPHER MARK ANDREWS", @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00508374/", @zip="35750", @candidate_id="H2AL05086">, ...]
+  
+"Super PACs" are independent-expenditure only committees formed in the wake of the 2010 Citizens United decision by the U.S. Supreme Court. They can raise money in unlimited donations from individuals, corporations, labor unions and other sources, but must register their intent to do so with the F.E.C. To retrieve the 20 most recent "Super PAC" registrations:
+
+  Committee.superpacs
+  #=> [#<CampaignCash::Committee:0x101bcfe10 @name="HUMAN RIGHTS CAMPAIGN EQUALITY VOTES", @state="DC", @party="", @designation="Unauthorized", @city="WASHINGTON", @treasurer="JAMES M RINEFIERD", @district=nil, @filing_frequency="Quarterly", @id="C00508440", @leadership=false, @zip="20036", @committee_type=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00508440/", @interest_group=nil, @super_pac=true, @candidate_id=nil>, #<CampaignCash::Committee:0x101bcf348 @name="LEADERS FOR FAMILIES SUPER PAC INC", @state="IN", @party="", @designation="Unauthorized", @city="TERRE HAUTE", @treasurer="CHARLES HURLEY", @district=nil, @filing_frequency="Quarterly", @id="C00508317", @leadership=false, @zip="47807", @committee_type=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00508317/", @interest_group=nil, @super_pac=true, @candidate_id=nil>,...]
+  
+Committees make contributions to candidates, among other activities. Given a committee, cycle and recipient candidate, to see any contributions from the committee to the candidate:
+
+  Contribution.find('C00388793',2012,'H0NY19139')
+  #=> #<CampaignCash::Contribution:0x101b6af60 @results=[#<OpenStruct party="REP", date=#<Date: 4911301/2,0,2299161>, primary_general="General", state="NY", amount=5000.0, image_uri="http://images.nictusa.com/cgi-bin/fecimg/?11932087309", name="HAYWORTH, NAN", district="19", candidate="H0NY19139">, #<OpenStruct party="REP", date=#<Date: 4911289/2,0,2299161>, primary_general="Primary", state="NY", amount=5000.0, image_uri="http://images.nictusa.com/cgi-bin/fecimg/?11932087308", name="HAYWORTH, NAN", district="19", candidate="H0NY19139">], @cycle=2012, @total_amount=10000.0, @committee="C00388793">
+  
+Removing the candidate's id from the previous method will yield an array of all contributions to candidates made by the committee during that cycle:
+
+  Contribution.find('C00388793',2012)
+  #=> #<CampaignCash::Contribution:0x101b8c098 @results=[#<OpenStruct party="REP", date=#<Date: 4911479/2,0,2299161>, primary_general="Primary", state="IL", amount=2000.0, image_uri="http://images.nictusa.com/cgi-bin/fecimg/?11932087311", name="KINZINGER, ADAM", district="11", candidate=nil>, #<OpenStruct party="REP", date=#<Date: 4911471/2,0,2299161>, primary_general="Primary", state="MI", amount=2500.0, image_uri="http://images.nictusa.com/cgi-bin/fecimg/?11932087316", name="WALBERG, TIMOTHY L. HON.", district="07", candidate=nil>,...]
+
+Both of the contribution responses have a results method that contains one or more contributions, assembled using Ruby's OpenStruct library. The image_uri attribute is a link to the page of the filing on fec.gov that contains that transaction.
+  
+== Filings
+
+Committees file reports with the F.E.C. detailing their fundraising and expenditures, as well as administrative matters such as a change of address or in committee status. Campaign Cash provides access to both electronic filings, the method used by most committees, and images of paper filings, which are submitted by Senate candidates and two Senate party committees. To retrieve the most recent 20 filings from today:
+
+  Filing.today
+  #=> [#<CampaignCash::Filing:0x101be03a0 @original_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00016899/741687/", @amended_uri=nil, @amended=false, @committee_name="OHIO DEMOCRATIC PARTY", @date_coverage_from=#<Date: 4911487/2,0,2299161>, @original_filing=741687, @report_title="AUG MONTHLY", @date_coverage_to=#<Date: 4911547/2,0,2299161>, @form_type="F3", @committee="C00016899", @paper=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00016899/756832/">, #<CampaignCash::Filing:0x101bd9eb0 @original_uri=nil, @amended_uri=nil, @amended=false, @committee_name="CITIZENS FOR PAUL FEINER", @date_coverage_from=#<Date: 4911671/2,0,2299161>, @original_filing=nil, @report_title="YEAR-END", @date_coverage_to=#<Date: 4911853/2,0,2299161>, @form_type="F3", @committee="C00332411", @paper=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00332411/756831/">,...]
+  
+Each filing object contains several attributes that help place it into context. If the filing is amended by another filing, amended will be True and an amended_uri, the link to the updated filing, will appear. If a filing was submitted on paper, paper will be True. To retrieve filings from a specific date:
+
+  Filing.date(2012,1,9) # Jan. 9, 2012
+  #=> [#<CampaignCash::Filing:0x101aa5e68 @original_uri=nil, @amended_uri=nil, @amended=false, @committee_name="HOYT HILSMAN FOR CONGRESS", @date_coverage_from=#<Date: 4911671/2,0,2299161>, @original_filing=nil, @report_title="YEAR-END", @date_coverage_to=#<Date: 4911853/2,0,2299161>, @form_type="F3", @committee="C00435966", @paper=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00435966/756828/">, #<CampaignCash::Filing:0x101a9f978 @original_uri=nil, @amended_uri=nil, @amended=false, @committee_name="MARY PALLANT FOR CONGRESS", @date_coverage_from=#<Date: 4911671/2,0,2299161>, @original_filing=nil, @report_title="YEAR-END", @date_coverage_to=#<Date: 4911853/2,0,2299161>, @form_type="F3", @committee="C00415943", @paper=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00415943/756827/">,...]
+
+To retrieve a list of Filing form types, which explain a little more about the form_type attributes on Filing objects:
+
+  Filing.form_types
+  #=> [#<OpenStruct name="STATEMENT OF ORGANIZATION", id="F1">, #<OpenStruct name="24-HOUR NOTICE OF EXPENDITURES FROM CANDIDATE PERSONAL FUNDS", id="F10">, #<OpenStruct name="24-HOUR NOTICE OF EXPENDITURES FROM OPPONENT'S PERSONAL FUNDS", id="F11">, #<OpenStruct name="24-HOUR NOTICE OF SUSPENSION OF INDIVIDUAL CONTRIBUTION LIMITS", id="F12">,...]
+  
+The form type IDs can be used to retrieve the most recent filings of that type:
+
+  Filing.by_type(2012,'F1') # Latest Statements of Organization
+  #=> [#<CampaignCash::Filing:0x101c5fee8 @original_uri=nil, @amended_uri=nil, @amended=false, @committee_name="DUNCAN D. HUNTER FOR CONGRESS", @date_coverage_from=nil, @original_filing=nil, @report_title="STATEMENT OF ORGANIZATION", @date_coverage_to=nil, @form_type=nil, @committee="C00433524", @paper=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00433524/756824/">, #<CampaignCash::Filing:0x101c5f448 @original_uri=nil, @amended_uri=nil, @amended=false, @committee_name="THE BILL KEATING COMMITTEE", @date_coverage_from=nil, @original_filing=nil, @report_title="STATEMENT OF ORGANIZATION", @date_coverage_to=nil, @form_type=nil, @committee="C00479063", @paper=nil, @fec_uri="http://query.nictusa.com/cgi-bin/dcdev/forms/C00479063/756813/">,...]
+
+All Filing methods, with the exception of Filing.form_types, support the optional offset parameter, using multiples of 20.
+
+== Independent Expenditures
+
+Committees can spend money to elect or defeat candidates independently of their campaigns; such activities are called independent expenditures and are {specifically reported to the F.E.C.}[http://www.fec.gov/finance/disclosure/ie_reports.shtml]. To retrieve the 20 most recent IE transactions:
+
+  IndependentExpenditure.latest
+  #=> [#<CampaignCash::IndependentExpenditure:0x101bd3920 @date_received=#<Date: 4911871/2,0,2299161>, @amount=200.0, @purpose="Online Advertising - 01/08/2012", @committee="C00503789", @district=0, @date=#<Date: 4911869/2,0,2299161>, @candidate="P20002721", @support_or_oppose="O", @committee_name="DGA ACTION", @office="President", @payee="Facebook", @state="", @fec_uri="http://images.nictusa.com/cgi-bin/fecimg/?12950041238">,...]
+
+The support_or_oppose attribute contains either an "S" (for "Support") or "O" (for "Oppose"), indicating whether the expenditure is in favor or against the candidate identified. IEs should contain both the candidate mentioned in the expenditure and the office (state and district) that person is running for, but in practice some filings either omit this information or contain an incorrect candidate ID (usually a previous one for the correct candidate). The API does not guarantee that such mistakes will be corrected when you retrieve records. To retrieve recent IEs about a specific candidate, use that candidate's ID:
+
+  IndependentExpenditure.candidate("P60003654", 2012) # find independent expenditures about Newt Gingrich.
+  #=> [#<CampaignCash::IndependentExpenditure:0x101bd8470 @date_received=#<Date: 4911865/2,0,2299161>, @amount=89961.8, @purpose="Direct Mail", @committee="C00490045", @district=0, @committee_name="RESTORE OUR FUTURE, INC.", @date=#<Date: 4911861/2,0,2299161>, @candidate="P60003654", @support_or_oppose="O", @office="President", @payee="Arena Communications", @state="FL", @fec_uri="http://images.nictusa.com/cgi-bin/fecimg/?12950036002">, #<CampaignCash::IndependentExpenditure:0x101bd1c38 @date_received=#<Date: 4911861/2,0,2299161>, @amount=108982.0, @purpose="National Email Communication and Production", @committee="C00507525", @district=0, @committee_name="WINNING OUR FUTURE", @date=#<Date: 4911859/2,0,2299161>, @candidate="P60003654", @support_or_oppose="S", @office="President", @payee="Marketel Media, Inc.", @state="", @fec_uri="http://images.nictusa.com/cgi-bin/fecimg/?12970039675">,...]
+  
+To retrieve IEs by date, use a string date in MM/DD/YYYY format:
+
+  IndependentExpenditure.date('12/28/2011')
+  #=> #<CampaignCash::IndependentExpenditure:0x101a41968 @date_received=#<Date: 4911849/2,0,2299161>, @amount=19210.0, @purpose="TV Ad", @committee="C00508317", @district=0, @date=#<Date: 4911847/2,0,2299161>, @candidate="P20002721", @support_or_oppose="S", @committee_name="Leaders for Families Super PAC, Inc.", @office="President", @payee="NCC Media", @state="", @fec_uri="http://images.nictusa.com/cgi-bin/fecimg/?11953345841">, #<CampaignCash::IndependentExpenditure:0x101a3b130 @date_received=#<Date: 4911849/2,0,2299161>, @amount=10450.0, @purpose="TV Ad", @committee="C00508317", @district=0, @date=#<Date: 4911847/2,0,2299161>, @candidate="P20002721", @support_or_oppose="S", @committee_name="Leaders for Families Super PAC, Inc.", @office="President", @payee="WHO", @state="", @fec_uri="http://images.nictusa.com/cgi-bin/fecimg/?11953345842">,...]
+  
+Another way to fetch IEs is by the committee that paid for them, using the committee ID:
+
+  IndependentExpenditure.committee('C00508317', 2012)
+  #=> [#<CampaignCash::IndependentExpenditure:0x1019c5638 @date_received=#<Date: 4911865/2,0,2299161>, @amount=4235.0, @purpose="Radio Ad Buy", @committee="C00508317", @district=0, @date=#<Date: 4911865/2,0,2299161>, @candidate="P20002721", @support_or_oppose="S", @committee_name="Leaders for Families Super PAC, Inc.", @office="President", @payee="WGIR-FM & WQSO-FM", @state="NH", @fec_uri="http://images.nictusa.com/cgi-bin/fecimg/?12950035907">,...]
+  
+There's also the option to retrieve the 20 most recent IEs for the presidential race:
+
+  IndependentExpenditure.president
+  #=> [#<CampaignCash::IndependentExpenditure:0x10192a728 @date_received=#<Date: 4911855/2,0,2299161>, @amount=350.0, @purpose="Font Purchase", @committee="C00508002", @district=0, @date=#<Date: 4911915/2,0,2299161>, @candidate="", @support_or_oppose="S", @committee_name="ENDORSE LIBERTY INC", @office="President", @payee="Commercial Type", @state="", @fec_uri="http://images.nictusa.com/cgi-bin/fecimg/?12970010100">,...]
+  
+The IE responses also accept an optional offset argument, using multiples of 20.
 
 == Note on Patches/Pull Requests
 

data/campaign_cash.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.authors     = ['Derek Willis']
   s.email       = ['dwillis@nytimes.com']
   s.homepage    = "http://rubygems.org/gems/campaign_cash"
-  s.description = "A thin client for The New York Times Campaign Finance API"
+  s.description = "A client for The New York Times Campaign Finance API"
   s.summary     = "Following the money."
 
   s.required_rubygems_version = ">= 1.3.6"

data/lib/campaign_cash.rb

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

data/lib/campaign_cash/base.rb

@@ -45,6 +45,16 @@ module CampaignCash
   		  date ? Date.strptime(date, '%Y-%m-%d') : nil
   		end
   		
+  		def parse_candidate(candidate)
+  		  return nil if candidate.nil?
+  		  candidate.split('/').last.split('.').first
+  		end
+  		
+  		def parse_committee(committee)
+  		  return nil if committee.nil?
+  		  committee.split('/').last.split('.').first
+  		end
+  		
   		# Returns the election cycle (even-numbered) from a date.
   		def cycle_from_date(date=Date.today)
   		  date.year.even? ? date.year : date.year+1

data/lib/campaign_cash/candidate.rb

@@ -26,7 +26,7 @@ module CampaignCash
 							 :district => parse_district(params['district']),
 							 :party => params['party'],
 							 :fec_uri => params['fec_uri'],
-							 :committee_id => parse_committee_id(params['committee']),
+							 :committee_id => parse_committee(params['committee']),
 							 :mailing_city => params['mailing_city'],
 							 :mailing_address => params['mailing_address'],
 							 :mailing_state => params['mailing_state'],
@@ -53,7 +53,7 @@ module CampaignCash
 		           :office => parse_office(params['candidate']['id'][0..0]),
 		           :district => parse_district(params['district']),
 		           :party => params['candidate']['party'],
-		           :committee_id => parse_committee_id(params['committee'])
+		           :committee => parse_committee(params['committee'])
 		  
 		end
 		
@@ -61,10 +61,6 @@ module CampaignCash
 		  state.split('/').last[0..1] if state
 		end
 		
-		def self.parse_committee_id(committee)
-		  committee.nil? ? nil : committee.split('/').last[0..8]
-		end
-		
 		def self.parse_office(id)
 		  return nil unless id
 		  if id[0..0] == "H"
@@ -84,6 +80,20 @@ module CampaignCash
 		  end
 		end
 		
+		def self.categories
+		  {
+          "individual_total" => "Contributions from individuals",
+          "contribution_total" => "Total contributions",
+          "candidate_loan" => "Loans from candidate",
+          "receipts_total" => "Total receipts",
+          "refund_total" => "Total refunds",
+          "pac_total" => "Contributions from PACs",
+          "disbursements_total" => "Total disbursements",
+          "end_cash" => "Cash on hand",
+          "debts_owed" => "Debts owed by",
+      }
+		end
+		
 		# Retrieve a candidate object via its FEC candidate id within a cycle.
 		# Defaults to the current cycle.
     def self.find(fecid, cycle=CURRENT_CYCLE)
@@ -113,7 +123,7 @@ module CampaignCash
     # current cycle.
     def self.new_candidates(cycle=CURRENT_CYCLE)
 			reply = invoke("#{cycle}/candidates/new",{})
-			results = reply['results']      
+			results = reply['results']
       results.map{|c| self.create(c)}      
     end
     

data/lib/campaign_cash/committee.rb

@@ -1,12 +1,54 @@
 module CampaignCash
   class Committee < Base
     
+    FILING_FREQUENCY = {
+      'A' => 'Administratively Terminated',
+      'D' => 'Debt',
+      'M' => 'Monthly',
+      'Q' => 'Quarterly',
+      'T' => 'Terminated',
+      'W' => 'Waived'
+    }
+    
+    INTEREST_GROUP = {
+      'C' => 'Corporation',
+      'L' => 'Labor Union',
+      'M' => 'Membership',
+      'T' => 'Trade Association',
+      'V' => 'Cooperative',
+      'W' => 'Corporation without Capital Stock'
+    }
+    
+    COMMITTEE_TYPE = {
+      'C' => 'Communication Cost',
+      'D' => 'Delegate',
+      'E' => 'Electioneering Communications',
+      'H' => 'House Candidate',
+      'I' => 'Independent Expenditure (Person or Group)',
+      'N' => 'Non-Party, Non-Qualified',
+      'P' => 'Presidential Candidate',
+      'Q' => 'Qualified Non-Party',
+      'S' => 'Senate Candidate',
+      'X' => 'Non-Qualified Party',
+      'Y' => 'Qualified Party',
+      'Z' => 'National Party Non-Federal'
+    }
+    
+    COMMITTEE_DESIGNATION = {
+      'A' => 'Authorized by a Candidate',
+      'J' => 'Joint Fundraiser',
+      'P' => 'Principal Campaign Committee',
+      'U' => 'Unauthorized',
+      'B' => 'Lobbyist/Registrant PAC',
+      'D' => 'Leadership PAC'
+    }
+    
     attr_reader :name, :id, :state, :district, :party, :fec_uri, :candidate, 
                 :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, :super_pac
+                :date_coverage_to, :date_coverage_from, :other_cycles, :super_pac, :filings
     
     def initialize(params={})
       params.each_pair do |k,v|
@@ -23,6 +65,9 @@ module CampaignCash
 							 :city => params['city'],
 							 :address => params['address'],
 							 :zip => params['zip'],
+		           :sponsor_name => params['sponsor_name'],
+		           :leadership => params['leadership'],
+		           :super_pac => params['super_pac'],
 							 :total_receipts => params['total_receipts'],
 							 :total_contributions => params['total_contributions'],
 							 :total_from_individuals => params['total_from_individuals'],
@@ -36,6 +81,10 @@ module CampaignCash
 							 :date_coverage_from => params['date_coverage_from'],
 							 :date_coverage_to => params['date_coverage_to'],
 							 :candidate_id => parse_candidate(params['candidate']),
+							 :filing_frequency => get_frequency(params['filing_frequency']),
+							 :interest_group => get_interest_group(params['interest_group']),
+							 :committee_type => get_committee_type(params['get_committee_type']),
+							 :designation => get_designation(params['designation']),
 							 :other_cycles => params['other_cycles'].map{|cycle| cycle['cycle']['fec_committee']['cycle']}
 		end
 		
@@ -47,18 +96,35 @@ module CampaignCash
 		           :zip => params['zip'],
 		           :district => params['district'],
 		           :party => params['party'],
-		           :relative_uri => params['relative_uri'],
 		           :candidate_id => parse_candidate(params['candidate']),
 		           :treasurer => params['treasurer'],
 		           :fec_uri => params['fec_uri'],
-		           :super_pac => params['super_pac'],
-		           :sponsor_name => params['sponsor_name']
-		  
+		           :leadership => params['leadership'],
+		           :super_pac => params['super_pac']
 		end
 		
-		def self.parse_candidate(candidate)
-		  return nil if candidate.nil?
-		  candidate.split('/').last.split('.').first
+		def self.get_frequency(frequency)
+		  if frequency
+		    FILING_FREQUENCY[frequency.strip] unless frequency.empty?
+		  end
+		end
+
+		def self.get_interest_group(interest_group)
+		  if interest_group
+		    INTEREST_GROUP[interest_group.strip] unless interest_group.empty?
+		  end
+		end
+		
+		def self.get_committee_type(committee_type)
+		  if committee_type
+		    COMMITTEE_TYPE[committee_type.strip] unless committee_type.empty?
+		  end
+		end
+		
+		def self.get_designation(designation)
+		  if designation
+		    COMMITTEE_DESIGNATION[designation.strip] unless designation.empty?
+		  end
 		end
     
     def self.find(fecid, cycle=CURRENT_CYCLE)
@@ -73,10 +139,10 @@ module CampaignCash
       results.map{|c| create_from_search_results(c)}
     end
     
-    def self.new_committees(cycle=CURRENT_CYCLE)
+    def self.latest(cycle=CURRENT_CYCLE)
 			reply = invoke("#{cycle}/committees/new",{})
 			results = reply['results']      
-      results.map{|c| create(c)}      
+      results.map{|c| create_from_search_results(c)}      
     end
     
     def self.superpacs(cycle=CURRENT_CYCLE, offset=0)
@@ -85,5 +151,11 @@ module CampaignCash
       results.map{|c| create_from_search_results(c)}
     end
     
+    def filings(cycle=CURRENT_CYCLE, offset=0)
+      reply = Base.invoke("#{cycle}/committees/#{id}/filings",{:offset => offset})
+      results = reply['results']
+      results.map{|c| Filing.create(c)}
+    end
+    
   end
 end

data/lib/campaign_cash/contribution.rb

@@ -9,32 +9,50 @@ module CampaignCash
       end
     end
     
-		def self.create(params={})
-		  self.new :committee_uri => params['committee'],
-		           :total_results => params['total_results'],
-		           :cycle => params['cycle'],
-		           :total_amount => params['total_amount'],
-		           :results => params['results'].map{|c| OpenStruct.new({
+    def self.to_candidate(params={})
+      self.new :committee => parse_committee(params['committee']),
+               :cycle => params['cycle'],
+               :total_amount => params['total_amount'],
+               :results => params['results'].map{|c| OpenStruct.new({
+               :candidate => parse_candidate(params['candidate_uri']),
                :date => date_parser(c['date']),
-		           :candidate_uri => c['candidate_uri'],
-		           :primary_general => c['primary_general'],
-		           :amount => c['amount'],
-		           :state => c['state'],
-		           :name => c['name'],
-		           :image_uri => c['image_uri'],
-		           :party => c['party'],
-		           :district => c['district']})}
-		           
-		end
-		
+               :primary_general => c['primary_general'],
+               :amount => c['amount'],
+               :state => c['state'],
+               :name => c['name'],
+               :image_uri => c['image_uri'],
+               :party => c['party'],
+               :district => c['district']})}
+               
+    end
+    
+    def self.all_candidates(params={})
+      self.new :committee => parse_committee(params['committee']),
+               :cycle => params['cycle'],
+               :total_amount => params['total_amount'],
+               :total_results => params['total_results'],
+               :results => params['results'].map{|c| OpenStruct.new({
+               :date => date_parser(c['date']),
+               :candidate => parse_candidate(c['candidate_uri']),
+               :primary_general => c['primary_general'],
+               :amount => c['amount'],
+               :state => c['state'],
+               :name => c['name'],
+               :image_uri => c['image_uri'],
+               :party => c['party'],
+               :district => c['district']})}
+               
+    end
+    
     def self.find(fecid, cycle=CURRENT_CYCLE, candidate=nil)
       if candidate
         reply = invoke("#{cycle}/committees/#{fecid}/contributions/candidates/#{candidate}")
-			else
-			  reply = invoke("#{cycle}/committees/#{fecid}/contributions")
-			end
-			create(reply)
+        to_candidate(reply)
+      else
+        reply = invoke("#{cycle}/committees/#{fecid}/contributions")
+        all_candidates(reply)
+      end
     end
-		
+    
   end
 end

data/lib/campaign_cash/filing.rb

@@ -13,11 +13,14 @@ module CampaignCash
 			self.new :committee_name => params['committee_name'],
 							 :date_coverage_from => date_parser(params['date_coverage_from']),
 							 :date_coverage_to => date_parser(params['date_coverage_to']),
-							 :committee => params['committee'],
+							 :committee => parse_committee(params['committee']),
 							 :report_title => params['report_title'].strip,
 							 :fec_uri => params['fec_uri'],
 							 :amended => params['amended'],
 							 :amended_uri => params['amended_uri'],
+							 :original_filing => params['original_filing'],
+							 :original_uri => params['original_uri'],
+							 :paper => params['paper'],
 							 :form_type => params['form_type']
 		end
 		
@@ -34,25 +37,32 @@ module CampaignCash
 		end
 		
 		
-		def self.today
+		def self.today(offset=0)
 		  cycle=CURRENT_CYCLE
-		  reply = Base.invoke("#{cycle}/filings", {})
+		  reply = Base.invoke("#{cycle}/filings", {:offset => offset})
 		  results = reply['results']
-			@filings = results.map{|c| Filing.create(c)}
+			results.map{|c| Filing.create(c)}
 		end
 		
-		def self.date(year, month, day)
+		def self.date(year, month, day, offset=0)
 		  cycle = cycle_from_date(Date.strptime("#{month}/#{day}/#{year}", '%m/%d/%Y'))
-		  reply = Base.invoke("#{cycle}/filings/#{year}/#{month}/#{day}", {})
+		  reply = Base.invoke("#{cycle}/filings/#{year}/#{month}/#{day}", {:offset => offset})
 		  results = reply['results']
-			@filings = results.map{|c| Filing.create(c)}
+			results.map{|c| Filing.create(c)}
+		end
+		
+		def self.form_types
+		  cycle=CURRENT_CYCLE
+		  reply = Base.invoke("#{cycle}/filings/types",{})
+		  results = reply['results']
+		  results.map{|ft| OpenStruct.new({:id => ft['id'], :name => ft['name'].strip})}
 		end
 		
 		def self.by_type(cycle, form_type)
 		  cycle = cycle
 		  reply = Base.invoke("#{cycle}/filings/types/#{form_type}")
 		  results = reply['results']
-			@filings = results.map{|c| Filing.create(c)}
+			results.map{|c| Filing.create(c)}
 		end
 	end
 end

data/lib/campaign_cash/independent_expenditure.rb

@@ -1,7 +1,7 @@
 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
+    attr_reader :committee, :district, :state, :committee_name, :purpose, :candidate, :support_or_oppose, :date, :amount, :office, :amendment, :date_received, :payee, :fec_uri
     
     def initialize(params={})
       params.each_pair do |k,v|
@@ -10,9 +10,9 @@ module CampaignCash
     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,
+      self.new :committee => parse_committee(params['fec_committee']),
+               :committee_name => params['fec_committee_name'],
+               :candidate => parse_candidate(params['fec_candidate']),
                :office => params['office'],
                :state => params['state'].strip,
                :district => params['district'],
@@ -25,10 +25,10 @@ module CampaignCash
                :date_received => date_parser(params['date_received'])
     end
     
-    def self.latest
-      reply = Base.invoke("#{Base::CURRENT_CYCLE}/independent_expenditures")
+    def self.latest(offset=0)
+      reply = Base.invoke("#{Base::CURRENT_CYCLE}/independent_expenditures",{:offset => offset})
       results = reply['results']
-      @independent_expenditures = results.map{|c| IndependentExpenditure.create(c)}
+      results.map{|c| IndependentExpenditure.create(c)}
     end
     
     def self.date(date,offset=0)
@@ -36,37 +36,37 @@ module CampaignCash
       cycle = cycle_from_date(d)
       reply = Base.invoke("#{cycle}/independent_expenditures/#{d.year}/#{d.month}/#{d.day}",{:offset => offset})
       results = reply['results']
-      @independent_expenditures = results.map{|c| IndependentExpenditure.create(c)}      
+      results.map{|c| IndependentExpenditure.create(c)}      
     end
     
     def self.committee(id, cycle, offset=0)
-      @independent_expenditures = []
+      independent_expenditures = []
       reply = Base.invoke("#{cycle}/committees/#{id}/independent_expenditures",{:offset => offset})
       results = reply['results']
       comm = reply['fec_committee']
       results.each do |result|
         result['fec_committee'] = comm
-        @independent_expenditures << IndependentExpenditure.create(result)
+        independent_expenditures << IndependentExpenditure.create(result)
       end
-      @independent_expenditures
+      independent_expenditures
     end
     
     def self.candidate(id, cycle, offset=0)
-      @independent_expenditures = []
+      independent_expenditures = []
       reply = Base.invoke("#{cycle}/candidates/#{id}/independent_expenditures",{:offset => offset})
       results = reply['results']
       cand = reply['fec_candidate']
       results.each do |result|
         result['fec_candidate'] = cand
-        @independent_expenditures << IndependentExpenditure.create(result)
+        independent_expenditures << IndependentExpenditure.create(result)
       end
-      @independent_expenditures
+      independent_expenditures
     end
     
-    def self.president(cycle=Base::CURRENT_CYCLE,offset=0)
+    def self.president(cycle=CURRENT_CYCLE,offset=0)
       reply = Base.invoke("#{cycle}/president/independent_expenditures",{:offset => offset})
       results = reply['results']
-      @independent_expenditures = results.map{|c| IndependentExpenditure.create(c)}
+      results.map{|c| IndependentExpenditure.create(c)}
     end
     
   end

data/lib/campaign_cash/president.rb

@@ -0,0 +1,72 @@
+module CampaignCash
+  class President < Base
+      
+    attr_reader :committee_id, :name, :id, :party, :date_coverage_from, :date_coverage_to, :total_receipts, :total_disbursements,
+                :end_cash, :total_refunds, :total_contributions, :net_individual_contributions, :net_pac_contributions, 
+                :net_party_contributions, :net_candidate_contributions, :net_primary_contributions, :net_general_contributions,
+                :federal_funds, :contributions_less_than_200, :contributions_200_499, :contributions_500_1499, :contributions_1500_2499,
+                :contributions_max
+      
+    def initialize(params={})
+      params.each_pair do |k,v|
+        instance_variable_set("@#{k}", v)
+      end
+    end
+    
+    # Creates a new president summary object from a JSON API presidential response.
+		def self.create_summary(params={})
+			self.new :name => params['name'],
+							 :id => params['candidate_id'],
+							 :party => params['party'],
+							 :committee_id => params['committee_id'],
+							 :total_receipts => params['total_receipts'],
+							 :total_disbursements => params['total_disbursements'],
+							 :end_cash => params['cash_on_hand'],
+							 :date_coverage_from => params['date_coverage_from'],
+							 :date_coverage_to => params['date_coverage_to']
+		end
+		
+		# Creates a detailed president object
+		def self.create_detail(params={})
+			self.new :name => params['candidate_name'],
+							 :id => params['candidate_id'],
+							 :party => params['party'],
+							 :committee_id => params['committee_id'],
+							 :total_receipts => params['total_receipts'],
+							 :total_contributions => params['total_contributions'],
+							 :total_disbursements => params['total_disbursements'],
+							 :end_cash => params['cash_on_hand'],
+							 :date_coverage_from => params['date_coverage_from'],
+							 :date_coverage_to => params['date_coverage_to'],
+						   :total_refunds => params['total_refunds'],
+						   :net_individual_contributions => params['net_individual_contributions'], 
+						   :net_pac_contributions => params['net_pac_contributions'], 
+               :net_party_contributions => params['net_party_contributions'], 
+               :net_candidate_contributions => params['net_candidate_contributions'], 
+               :net_primary_contributions => params['net_primary_contributions'], 
+               :net_general_contributions => params['net_general_contributions'],
+               :federal_funds => params['federal_funds'], 
+               :contributions_less_than_200 => params['total_contributions_less_than_200'], 
+               :contributions_200_499 => params['contributions_200_499'], 
+               :contributions_500_1499 => params['contributions_500_1499'], 
+               :contributions_1500_2499 => params['contributions_1500_2499'],
+               :contributions_max => params['total_contributions_max']
+		end
+    
+    # Returns an array of presidential candidates for a given cycle, defaults to the current cycle.
+    # Only returns candidates that The New York Times is tracking for financial activity.
+    def self.summary(cycle=CURRENT_CYCLE)
+      reply = invoke("#{cycle}/president/totals", {})
+      results = reply['results']
+      results.map{|c| self.create_summary(c)}
+    end
+    
+    # Returns a President object for a given presidential candidate in a given cycle, defaults to the current cycle.
+    # Only returns candidates tracked by The New York Times.
+    def self.detail(id, cycle=CURRENT_CYCLE)
+      reply = invoke("#{cycle}/president/candidates/#{id}", {})
+      results = reply['results']
+      results.map{|c| self.create_detail(c)}
+    end
+  end
+end

data/lib/campaign_cash/version.rb

@@ -1,3 +1,3 @@
 module CampaignCash
-  VERSION = "1.8"
+  VERSION = "2.0"
 end

data/test/campaign_cash/test_candidate.rb

@@ -51,7 +51,7 @@ class TestCampaignCash::TestCandidate < Test::Unit::TestCase
 	
 	context "candidate leaders" do
 	  setup do
-		  reply = Base.invoke('2010/candidates/leaders/end_cash', {})
+		  reply = Base.invoke('2010/candidates/leaders/end-cash', {})
 			results = reply['results']
 	    @candidates = results.map{|c| Candidate.create(c)}
 	  end

data/test/campaign_cash/test_committee.rb

@@ -53,7 +53,7 @@ class TestCampaignCash::TestCommittee < Test::Unit::TestCase
 	  setup do
 	    reply = Base.invoke('2010/committees/C00312223/filings', {})
 	    results = reply['results']
-	    @filings = results.map{|f| Filing.create_from_filings(f)}
+	    @filings = results.map{|f| Filing.create(f)}
 	  end
 	  
 	  should "return 11 filings" do
@@ -81,7 +81,7 @@ class TestCampaignCash::TestCommittee < Test::Unit::TestCase
 	  end
 	  
 	  should "return a $5,000 contribution to Renee Ellmers" do
-	    assert_equal @contribution.results.detect{|c| c.candidate_uri == "/candidates/H0NC02059.json"}.amount, 5000
+	    assert_equal @contribution.results.detect{|c| c.candidate == "H0NC02059"}.amount, 5000
 	  end
 	  
 	end
@@ -89,7 +89,7 @@ class TestCampaignCash::TestCommittee < Test::Unit::TestCase
 	context "committee contributions to a candidate" do
 	  setup do
 	    reply = Base.invoke('2010/committees/C00458588/contributions/candidates/H0NC02059', {})
-	    @contribution = Contribution.create(reply)
+	    @contribution = Contribution.to_candidate(reply)
 	  end
 	  
 	  should "return 2 results totaling $10,000" do

data/test/campaign_cash/test_independent_expenditure.rb

@@ -19,7 +19,7 @@ class TestCampaignCash::TestIndependentExpenditure < Test::Unit::TestCase
 	  end
 	  
 	  should "return at least one independent expenditure against Barack Obama" do
-	    assert_equal("P80003338", @independent_expenditures.first.fec_candidate_id)
+	    assert_equal("P80003338", @independent_expenditures.first.candidate)
 	  end
 	end
 	

data/test/campaign_cash/test_president.rb

@@ -0,0 +1,42 @@
+require 'test_helper'
+
+class TestCampaignCash::TestPresident < Test::Unit::TestCase
+	include CampaignCash
+	
+	context "President.summary" do
+		setup do
+		  reply = Base.invoke('2012/president/totals', {})
+			@results = reply['results']
+			@summaries = @results.map{|r| President.create_summary(r)}
+			@summary = @summaries.first
+		end
+		
+		should "return an array of objects of the President type" do
+			assert_kind_of(President, @summary)
+		end
+		
+		%w(name total_contributions party total_receipts).each do |attr|
+			should "assign the value of the @#{attr} attribute from the '#{attr}' key in the hash" do
+				assert_equal(@results.first[attr], @summary.send(attr))
+			end
+		end
+  end
+  
+	context "President.detail" do
+		setup do
+		  reply = Base.invoke('2012/president/candidates/C00496034', {})
+			@results = reply['results']
+			@detail = President.create_detail(@results.first)
+		end
+		
+		should "return an array of objects of the President type" do
+			assert_kind_of(President, @detail)
+		end
+		
+		%w(net_primary_contributions party total_refunds).each do |attr|
+			should "assign the value of the @#{attr} attribute from the '#{attr}' key in the hash" do
+				assert_equal(@results.first[attr], @detail.send(attr))
+			end
+		end
+  end
+end

data/test/test_helper.rb

@@ -4,7 +4,7 @@ require 'shoulda'
 require 'json'
 require 'ostruct'
 
-%w(base candidate committee contribution filing form independent_expenditure).each do |f|
+%w(base candidate committee contribution filing form independent_expenditure president).each do |f|
   require File.join(File.dirname(__FILE__), '../lib/campaign_cash', f)
 end
 

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: campaign_cash
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 3
   prerelease: 
   segments: 
-  - 1
-  - 8
-  version: "1.8"
+  - 2
+  - 0
+  version: "2.0"
 platform: ruby
 authors: 
 - Derek Willis
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-12-29 00:00:00 -05:00
+date: 2012-01-10 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -61,7 +61,7 @@ dependencies:
         version: "0"
   type: :development
   version_requirements: *id003
-description: A thin client for The New York Times Campaign Finance API
+description: A client for The New York Times Campaign Finance API
 email: 
 - dwillis@nytimes.com
 executables: []
@@ -86,12 +86,14 @@ files:
 - lib/campaign_cash/filing.rb
 - lib/campaign_cash/form.rb
 - lib/campaign_cash/independent_expenditure.rb
+- lib/campaign_cash/president.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/campaign_cash/test_president.rb
 - test/test_helper.rb
 has_rdoc: true
 homepage: http://rubygems.org/gems/campaign_cash
@@ -135,4 +137,5 @@ test_files:
 - test/campaign_cash/test_filing.rb
 - test/campaign_cash/test_form.rb
 - test/campaign_cash/test_independent_expenditure.rb
+- test/campaign_cash/test_president.rb
 - test/test_helper.rb