hulse 0.6 → 0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 24805bee84bd7c6a90544f7d70c98c0eb32661c2
-  data.tar.gz: f8e91bcffaca717a42d71e1f5bd1903fa52da684
+  metadata.gz: fb2a99da5c608cdd21b613eedec185ed0c2d68db
+  data.tar.gz: cb4502cab20752d48fe70929db54071122509dc9
 SHA512:
-  metadata.gz: 3171a1108d9677464ff0ddd67f3780ae37128dd0118f68efba14215f1033647ebd92fd19d6da0fbf7d7e14a14dce7649ddd17a48f702638f6770a393e06465eb
-  data.tar.gz: c7739d66a725f05131c0d4e696a6647bd0c2b535eb453a9ef06b52a53e26459516673e1a420b097936aed8da074bbdfaa5acdcad1187151b8074255d7c6e9e34
+  metadata.gz: 30d9cdfe34eb025d37f95b01e63b73711b562a96d5405ae74b92a8850a3839559f8e0998258804fb5902e197d7e1955595740227d4482332cc6d71ce4f06c489
+  data.tar.gz: 38ba6c3b5b72b4a85ef54bdb448738e1f612427d3b990765bcdef0dd146f7cfc3289e7d66baf87e7246df4f5981b42e7b65e40074a95cc094ca13d52a349a273

data/README.md

@@ -6,12 +6,14 @@ Hulse can be used to get House and Senate roll call votes from the official sour
 
 Hulse has two vote classes, `HouseVote` and `SenateVote`, which create Ruby objects using the XML attributes available from roll call vote data (voice votes are not covered by Hulse or available as data from official sources). Hulse makes a few changes, renaming some attributes for clarity and consistency, and collapsing each House vote's date and time into a single datetime attribute. Otherwise it does not alter the original data.
 
-`HouseVote` and `SenateVote` have different attributes due to parliamentary conventions and the presence or absence of data in one chamber or the other. Senators are uniquely identified by a `lis_member_id`; House members are uniquely identified by a `bioguide_id` beginning in 2003. Prior to 2003, there is no unique ID for House members, but using a combination of name, state and political party one can be manufactured. House member attributes also include an `unaccented_name` and a `name` attribute that may contain accent characters.
+`HouseVote` and `SenateVote` have different attributes due to parliamentary conventions and the presence or absence of data in one chamber or the other. Senators are uniquely identified by a `lis_member_id`; House members are uniquely identified by a `bioguide_id` beginning in 2003. Prior to 2003, there is no unique ID for House members, but using a combination of name, state and political party one can be manufactured. House member attributes also include an `unaccented_name` and a `name` attribute that may contain accent characters. Both `HouseVote` and `SenateVote` have class methods that will return the number of the latest vote in each chamber.
 
 Hulse also has two member classes, `HouseMember` and `SenateMember`, which create Ruby objects using the XML made available by the Clerk of the House and the Secretary of the Senate. House members have some basic information, including the unique `bioguide_id`, along with office details and committee and subcommittee assignment data. For vacant seats, information on the seat's previous occupant is available. Senate members have less information, but their data includes the Senate class and the URLs of their websites and email forms.
 
 Hulse has two other classes, `HouseFloor` and `Record`. The former provides a wrapper to [XML data on floor activity](http://clerk.house.gov/floorsummary/floor.aspx?day=20150729) published by the Clerk of the House, including timestamps and descriptions. The `Record` class provides a basic wrapper to the [Congressional Record](https://www.congress.gov/congressional-record), the daily listing of activities by the House and Senate, as well as some methods for accessing specific portions of it, particularly the titles and permalinks of articles.
 
+Lastly, if you ever need to convert a year to its corresponding congress and session numbers, Hulse has a utility method for doing so.
+
 Hulse is named for [Carl Hulse](https://www.nytimes.com/learning/students/ask_reporters/Carl_Hulse.html), a longtime congressional correspondent for The New York Times.
 
 ## Installation

data/lib/hulse/house_vote.rb

@@ -10,6 +10,13 @@ module Hulse
       end
     end
 
+    def self.latest_vote(year)
+      url = "http://clerk.house.gov/evs/#{year}/index.asp"
+      response = HTTParty.get(url)
+      doc = Nokogiri::HTML(response.parsed_response)
+      (doc/:a).first.text.to_i
+    end
+
     def self.find(year, vote)
       url = "http://clerk.house.gov/evs/#{year.to_s}/roll#{vote.to_s.rjust(3,"0")}.xml"
       response = HTTParty.get(url)
@@ -25,11 +32,13 @@ module Hulse
       end
       members = []
       mappings = {"__content__" => "name"}
-      response['vote_data']['recorded_vote'].each do |m|
-        m['legislator']['name'] = m['legislator'].delete('__content__')
-        m['legislator']['bioguide_id'] = m['legislator'].delete('name_id') # prior to 2003, bioguide IDs were not used in the XML
-        m['legislator']['vote'] = m['vote']
-        members << m['legislator'].inject({}){|memo,(k,v)| memo[k.to_sym] = v; memo}
+      if response['vote_data']
+        response['vote_data']['recorded_vote'].each do |m|
+          m['legislator']['name'] = m['legislator'].delete('__content__')
+          m['legislator']['bioguide_id'] = m['legislator'].delete('name_id') # prior to 2003, bioguide IDs were not used in the XML
+          m['legislator']['vote'] = m['vote']
+          members << m['legislator'].inject({}){|memo,(k,v)| memo[k.to_sym] = v; memo}
+        end
       end
       if response['vote_metadata']['vote_question'] == 'Election of the Speaker'
         vote_counts = response['vote_metadata']['vote_totals']['totals_by_candidate'].reject{|k,v| k == 'total_stub'}.inject({}){|memo,(k,v)| memo[k['candidate'].to_sym] = k['candidate_total'].to_i; memo}
@@ -47,7 +56,7 @@ module Hulse
         amendment_author: response['vote_metadata']['amendment_author'],
         vote_type: response['vote_metadata']['vote_type'],
         vote_result: response['vote_metadata']['vote_result'],
-        vote_timestamp: DateTime.parse(response['vote_metadata']['action_date'] + ' ' + response['vote_metadata']['action_time']['time_etz']),
+        vote_timestamp: begin DateTime.parse(response['vote_metadata']['action_date'] + ' ' + response['vote_metadata']['action_time']['time_etz']) rescue nil end,
         description: response['vote_metadata']['vote_desc'],
         party_summary: party_totals,
         vote_count: vote_counts,

data/lib/hulse/senate_vote.rb

@@ -2,7 +2,7 @@ module Hulse
   class SenateVote
 
     attr_reader :congress, :session, :year, :vote_number, :vote_timestamp, :updated_at, :vote_question_text, :vote_document_text,
-    :vote_result_text, :question, :vote_title, :majority_requirement, :vote_result, :document, :amendment, :vote_count, :tie_breaker, :members, 
+    :vote_result_text, :question, :vote_title, :majority_requirement, :vote_result, :document, :amendment, :vote_count, :tie_breaker, :members,
     :vote_date, :issue
 
     def initialize(params={})
@@ -10,7 +10,14 @@ module Hulse
         instance_variable_set("@#{k}", v)
       end
     end
-    
+
+    def self.latest_vote(year)
+      congress, session = Hulse::Utils.convert_year_to_congress_and_session(year)
+      url = "http://www.senate.gov/legislative/LIS/roll_call_lists/vote_menu_#{congress}_#{session}.xml"
+      response = HTTParty.get(url)
+      response.parsed_response['vote_summary']['votes']['vote'].first['vote_number'].to_i
+    end
+
     def self.find(year, vote)
       congress, session = Hulse::Utils.convert_year_to_congress_and_session(year)
       url = "http://www.senate.gov/legislative/LIS/roll_call_votes/vote#{congress}#{session}/vote_#{congress}_#{session}_#{vote.to_s.rjust(5,"0")}.xml"
@@ -43,14 +50,14 @@ module Hulse
         members: members
       )
     end
-    
+
     def self.summary(year)
       congress, session = Hulse::Utils.convert_year_to_congress_and_session(year)
       url = "http://www.senate.gov/legislative/LIS/roll_call_lists/vote_menu_#{congress}_#{session}.xml"
       response = HTTParty.get(url)
       return nil if response.code == 404
       votes = response.parsed_response['vote_summary']['votes']['vote']
-      votes.map{|v| self.new(congress: congress, session: session, year: year, vote_number: v['vote_number'], vote_date: Date.strptime(v['vote_date']+"-#{year}", "%d-%b-%Y"), issue: v['issue'], 
+      votes.map{|v| self.new(congress: congress, session: session, year: year, vote_number: v['vote_number'], vote_date: Date.strptime(v['vote_date']+"-#{year}", "%d-%b-%Y"), issue: v['issue'],
         question: v['question'], vote_result: v['result'], vote_count: v['vote_tally'].inject({}){|memo,(k,v)| memo[k.to_sym] = v; memo}, vote_title: v['title'])}
     end
   end

data/lib/hulse/version.rb

@@ -1,3 +1,3 @@
 module Hulse
-  VERSION = "0.6"
+  VERSION = "0.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hulse
 version: !ruby/object:Gem::Version
-  version: '0.6'
+  version: '0.7'
 platform: ruby
 authors:
 - Derek Willis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-03 00:00:00.000000000 Z
+date: 2015-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler