luigi-sunlight 0.9.0 → 1.0.0

data/README.textile

@@ -108,7 +108,6 @@ Lastly, to provide your users with a name search functionality, use @Legislator#
 
 h3. District
 
-
 There's also the @District@ object. @District#get@ takes in either lat/long or an address and does it's best to return the correct Congressional District:
 
 <pre><code>
@@ -126,6 +125,46 @@ Finally, two more methods, @District.all_from_zipcode@ and @District.zipcodes_in
 	zipcodes = Sunlight::District.zipcodes_in("NY", "10")     # returns array of zip codes as strings  ["11201", "11202", "11203",...]
 </code></pre>
 
+
+h3. Committees
+
+Members of Congress sit on all-important @Committees@, the smaller bodies that hold hearings and are first to review legislation.
+
+The @Committee@ object has three identifying fields, and an array of subcommittees, which are @Committee@ objects themselves. To get all the committees for a given chamber of Congress:
+
+<pre><code>
+  committees = Sunlight::Committee.all_for_chamber("Senate") # or "House" or "Joint"
+  some_committee = committees.last
+  some_committee.name       # "Senate Committee on Agriculture, Nutrition, and Forestry"
+  some_committee.id         # "SSAF"
+  some_committee.chamber    # "Senate"
+  
+  some_committee.subcommittees.each do |subcommittee|
+    # do some stuff...
+  end
+</code></pre>
+
+The @Committee@ object also keeps a collection of members in that committee, but since that's an API-heavy call, it must be done for each Committee one at a time:
+
+<pre><code>
+  committees = Sunlight::Committee.all_for_chamber("Senate") # or "House" or "Joint"
+  some_committee = committees.last    # some_committee.members starts out as nil
+  some_committee.load_members         # some_committee.members is now populated
+  some_committee.members.each do |legislator|
+    # do some stuff...
+  end
+</code></pre>
+
+Coming from the opposite direction, the @Legislator@ object has a method for getting all committees for that particular Legislator, returning an array of @Committee@ objects:
+
+<pre><code>
+  legislators = Sunlight::Legislator.search_by_name("Ted Kennedy")
+  legislator = legislators.first
+  legislator.committees.each do |committee|
+    # do some stuff...
+  end
+</code></pre>
+
 h3. Lobbyists and Filings
 
 Moving away from members of Congress, the Sunlight API also exposes data on @Lobbyists@, the organizations and companies they lobby on behalf of, and the @Issues@ they lobby on. Lobbyists must submit filings to the Senate Office of Public Records, and these are represented as @Filings@ in the API.

data/lib/sunlight/legislator.rb

@@ -16,6 +16,26 @@ module Sunlight
         instance_variable_set("@#{key}", value) if Legislator.instance_methods.include? key
       end
     end
+    
+    # Get the committees the Legislator sits on
+    #
+    # Returns:
+    #
+    # An array of Committee objects, each possibly
+    # having its own subarray of subcommittees
+    def committees
+      url = Sunlight::Base.construct_url("committees.allForLegislator", {:bioguide_id => self.bioguide_id})
+
+       if (result = Sunlight::Base.get_json_data(url))
+         committees = []
+         result["response"]["committees"].each do |committee|
+           committees << Sunlight::Committee.new(committee["committee"])
+         end
+       else
+         nil # appropriate params not found
+       end
+       committees
+    end
 
 
     #

data/sunlight.gemspec

@@ -1,9 +1,11 @@
 Gem::Specification.new do |s|
   s.name = "sunlight"
-  s.version = "0.9.0"
-  s.date = "2009-03-15"
+  s.version = "1.0.0"
+  s.date = "2009-06-10"
   s.summary = "Library for accessing the Sunlight Labs API."
-  s.email = "luigi.montanez@gmail.com"
+  s.description = "Library for accessing the Sunlight Labs API."
+  s.rubyforge_project = "sunlight"
+  s.email = "luigi@sunlightfoundation.com"
   s.homepage = "http://github.com/luigi/sunlight"
   s.authors = ["Luigi Montanez"]
   s.files = ['sunlight.gemspec', 'lib/sunlight.rb', 'lib/sunlight/base.rb',

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: luigi-sunlight
 version: !ruby/object:Gem::Version 
-  version: 0.9.0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Luigi Montanez
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-03-15 00:00:00 -07:00
+date: 2009-06-10 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -32,8 +32,8 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.6.1
     version: 
-description: 
-email: luigi.montanez@gmail.com
+description: Library for accessing the Sunlight Labs API.
+email: luigi@sunlightfoundation.com
 executables: []
 
 extensions: []
@@ -72,7 +72,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: []
 
-rubyforge_project: 
+rubyforge_project: sunlight
 rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2