netroots-ruby-votesmart 0.1.1 → 0.2.0

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2009-02-10
+
+* 1 major enhancement:
+  * Initial release

data/README.rdoc

@@ -0,0 +1,48 @@
+= project-vote-smart
+
+* FIX (url)
+
+== DESCRIPTION:
+
+FIX (describe your package)
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+  FIX (code sample of usage)
+
+== REQUIREMENTS:
+
+* FIX (list of requirements)
+
+== INSTALL:
+
+* FIX (sudo gem install, anything else)
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 FIXME full name
+
+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/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:minor: 2
+:patch: 0
+:major: 0

data/lib/mcll4r/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Mobile Commons
+
+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/lib/mcll4r/README

@@ -0,0 +1,19 @@
+=== mcll4r
+ 
+- [Code on GitHub](http://github.com/mcommons/mcll4r)
+ 
+=== Description
+ 
+Ruby client for Mobile Commons Legislative Lookup API
+ 
+Based on the API described at http://congress.mcommons.com
+ 
+ 
+=== Authors
+ 
+- Maintained by [Benjamin Stein](mailto:ben@mcommons.com), [Mal McKay](mailto:mal@mcommons.com) & [Nathan Woodhull](mailto:nathan@mcommons.com)
+ 
+=== License
+ 
+Copyright (c) 2008 Mobile Commons
+See MIT-LICENSE in this directory.

data/lib/mcll4r/mcll4r.rb

@@ -0,0 +1,24 @@
+require 'rubygems'
+require 'httparty'
+
+class Mcll4r
+  include HTTParty
+  base_uri "http://congress.mcommons.com"    
+  format :xml
+  
+  def district_lookup(lat, lng)
+    filter_for_errors self.class.get("/districts/lookup.xml", :query=>{:lat=>lat, :lng=>lng})
+  end
+
+private
+
+  def filter_for_errors(hash)
+    if hash['response']['error']
+      raise DistrictNotFound.new(hash['response']['error'])
+    end
+    hash
+  end
+
+end
+
+class DistrictNotFound < Exception; end

data/lib/mcll4r/mcll4r_test.rb

@@ -0,0 +1,35 @@
+require 'mcll4r'
+require 'test/unit'
+ 
+class Mcll4rTest < Test::Unit::TestCase
+  
+  def setup
+    @mcll4r = Mcll4r.new
+  end
+  
+  def test_assert_we_get_back_correct_district_data
+    expected = {
+      "response"      => {                                                                   
+        "state_upper" => { "district" => "029", "display_name" => "TX 29th", "state" => "TX" },
+        "federal"     => { "district" => "16",  "display_name" => "TX 16th", "state" => "TX" },
+        "state_lower" => { "district" => "077", "display_name" => "TX 77th", "state" => "TX" },
+        "lng"         => "-106.490969",                                                      
+        "lat"         => "31.76321"                                                          
+      }                                                                                      
+    }
+    assert_equal expected, @mcll4r.district_lookup(31.76321, -106.490969)
+  end
+
+  def test_assert_raise_on_error
+    assert_raise DistrictNotFound do
+      @mcll4r.district_lookup(nil,nil)
+    end
+  end
+
+  def test_assert_raise_on_district_not_found
+    assert_raise DistrictNotFound do
+      @mcll4r.district_lookup( 1.0, 1.0 )
+    end
+  end
+
+end

data/lib/ruby-votesmart.rb

@@ -0,0 +1,22 @@
+require 'rubygems'
+require 'ym4r/google_maps/geocoding'
+require 'active_support'
+include Ym4r::GoogleMaps
+
+module VoteSmart
+  API_URL = "http://api.votesmart.org/"
+  API_FORMAT = "JSON"
+  
+  mattr_accessor :api_key
+  
+  class RequestFailed < Exception; end
+end
+
+VoteSmart.api_key = "key"
+
+require "#{File.dirname(__FILE__)}/mcll4r/mcll4r.rb"
+require "#{File.dirname(__FILE__)}/vote_smart/common.rb"
+
+Dir["#{File.dirname(__FILE__)}/vote_smart/*.rb"].each do |source_file| 
+  require source_file unless source_file == "#{File.dirname(__FILE__)}/vote_smart/common.rb"
+end

data/lib/vote_smart/address.rb

@@ -0,0 +1,42 @@
+module VoteSmart
+  
+  class Address < Common
+    
+    attr_accessor :type, :street, :city, :state, :zip
+    
+    set_attribute_map "type" => :type, "street" => :street, "city" => :city, "state" => :state, "zip" => :zip
+    
+    
+    # Returns a campaign office's contact information
+    def self.get_campaign can_id
+      request("Address.getCampaign", "candidateId" => can_id)
+    end
+    
+    # Returns a campaign office's contact information
+    def self.get_campaign_web_address can_id
+      request("Address.getCampaignWebAddress", "candidateId" => can_id)
+    end
+    
+    # Returns a campaign office's contact information
+    def self.get_campaign_by_election election_id
+      request("Address.getCampaignByElection", "electionId" => election_id)
+    end
+    
+    # Returns an incumbent office's contact information
+    def self.get_office candidate_id
+      request("Address.getOffice", "candidateId" => candidate_id)
+    end
+    
+    # Returns an incumbent office's contact information
+    def self.get_office_web_address can_id
+      request("Address.getOfficeWebAddress", "candidateId" => can_id)
+    end
+    
+    # Returns a (sometimes)list of offices that fit office_id and state_id
+    def self.get_office_by_office_state office_id, state_id = 'NA'
+      request("Address.getOfficeByOfficeState", "officeId" => office_id, "stateId" => state_id)
+    end
+    
+  end
+  
+end

data/lib/vote_smart/candidate.rb

@@ -0,0 +1,32 @@
+module VoteSmart
+  
+  class Candidate < Common
+    
+    # Returns a list of candidates/incumbents that fit the criteria
+    def self.get_by_office_state office_id, state_id = "NA", election_year = nil
+      request("Candidates.getByOfficeState", "officeId" => office_id, "stateId" => state_id, "electionYear" => election_year)
+    end
+    
+    #Searches for candidates with exact lastname matches
+    def self.get_by_lastname last_name, election_year = nil
+      request("Candidates.getByLastname", "lastName" => last_name, "electionYear" => election_year)
+    end
+    
+    # Searches for candidates with fuzzy lastname match
+    def self.get_by_levenstein last_name, election_year = nil
+      request("Candidates.getByLevenstein", "lastName" => last_name, "electionYear" => election_year)
+    end
+    
+    # Returns candidates in the provided election_id
+    def self.get_by_election election_id
+      request("Candidates.getByElection", "electionId" => election_id)
+    end
+    
+    # Returns candidates in the provided district_id
+    def self.get_by_district district_id, election_year = nil
+      request("Candidates.getByDistrict", "districtId" => district_id, "electionYear" => election_year)
+    end
+    
+  end
+  
+end

data/lib/vote_smart/candidate_bio.rb

@@ -0,0 +1,16 @@
+module VoteSmart
+  
+  class CandidateBio < Common
+    
+    # Returns basic bio details on a candidate
+    def self.get_bio can_id
+      request("CandidateBio.getBio", "candidateId" => can_id)
+    end
+    
+    # 
+    def self.get_addl_bio can_id
+      request("CandidateBio.getAddlBio", "candidateId" => can_id)
+    end
+    
+  end
+end

data/lib/vote_smart/candidate_office.rb

@@ -0,0 +1,15 @@
+module VoteSmart
+  
+  class CandidateOffice < Common
+    
+    attr_accessor :address, :phone, :notes
+    
+    def initialize attributes
+      self.address = Address.new(attributes["address"])
+      self.phone = Phone.new(attributes["phone"])
+      self.notes = Notes.new(attributes["notes"])
+    end
+    
+  end
+  
+end

data/lib/vote_smart/committee.rb

@@ -0,0 +1,23 @@
+module VoteSmart
+  
+  class Committee < Common
+    
+    # Returns committee types for use in other methods
+    def self.get_types
+      request("Committee.getTypes")
+    end
+    
+    def self.get_committees_by_type_state type_id = nil, state_id = 'NA'
+      request("Committee.getCommitteesByTypeState", "typeId" => type_id, "stateId" => state_id)
+    end
+    
+    def self.get_committee committee_id
+      request("Committee.getCommittee", "committeeId" => committee_id)
+    end
+    
+    def self.get_committee_members committee_id
+      request("Committee.getCommitteeMembers", "committeeId" => committee_id)
+    end
+    
+  end
+end

data/lib/vote_smart/common.rb

@@ -0,0 +1,91 @@
+require 'json'
+require 'cgi'
+require 'net/http'
+require 'ym4r/google_maps/geocoding'
+
+module VoteSmart
+  
+  class Common
+    
+    class << self
+      attr_reader :attribute_map
+    end
+    
+    def initialize attributes = {}
+      update_attributes attributes
+    end
+    
+    def self.set_attribute_map map
+      @attribute_map = map
+    end
+    
+    def update_attributes attributes
+      map = self.class.attribute_map
+      raise "map not set over-ride needed" unless map
+      
+      attributes.each do |key, value|
+        if key.kind_of?(Symbol)
+          send("#{key}=", value)
+        else
+          map_to = map[key]
+          send("#{map_to}=", value) if map_to
+        end
+      end
+    end
+    
+    def self.response_child response, *children
+      for child in children
+        response = response[child] if response
+      end
+      
+      response || {}
+    end
+    
+    def self.request(api_method, params = {})
+      url = construct_url api_method, params
+      
+      json = get_json_data(url)
+      
+      if json['error'] and json['error']['errorMessage'] == 'Authorization failed'
+        raise RequestFailed.new(json['error']['errorMessage'])
+      end
+      
+      json
+    end
+    
+    # Constructs a VoteSmart API-friendly URL
+    def self.construct_url(api_method, params = {})
+      "#{API_URL}#{api_method}?key=#{VoteSmart.api_key}&o=#{API_FORMAT}#{hash2get(params)}"
+    end
+    
+    # Converts a hash to a GET string
+    def self.hash2get(h)
+      
+      get_string = ""
+      
+      h.each_pair do |key, value|
+        get_string += "&#{key.to_s}=#{CGI::escape(value.to_s)}" unless value.nil?
+      end
+      
+      get_string
+      
+    end # def hash2get
+    
+    
+    # Use the Net::HTTP and JSON libraries to make the API call
+    #
+    # Usage:
+    #   District.get_json_data("http://someurl.com")    # returns Hash of data or nil
+    def self.get_json_data(url)
+      response = Net::HTTP.get_response(URI.parse(url))
+      if response.class == Net::HTTPOK
+        result = JSON.parse(response.body)
+      else
+        raise RequestFailed.new("Request was not OK: #{response.class}: #{response.body}")
+      end
+      
+    end # self.get_json_data
+    
+  end
+  
+end

data/lib/vote_smart/district.rb

@@ -0,0 +1,36 @@
+module VoteSmart
+  
+  class District < Common
+    
+    attr_accessor :id, :name, :office_id, :state_id
+    
+    set_attribute_map "districtId" => :id, "name" => :name, "officeId" => :office_id, "stateId" => :state_id
+    
+    def number
+      return unless name
+      
+      scan = name.scan(/District (\d[0-9]*)/) || []
+      scan = scan.first || []
+      num = scan.first
+      num ? num.to_i : nil
+    end
+    
+    def official
+      @official ||= Official.find_by_district(self)
+    end
+    
+    def self.find_all_by_office_and_state office, state
+      find_all_by_office_id_and_state_id(office.id, state.id)
+    end
+    
+    def self.find_all_by_office_id_and_state_id office_id, state_id
+      response_child(get_by_office_state(office_id, state_id), "districtList", "district").collect {|attributes| District.new(attributes)}
+    end
+    
+    # Returns districts service the office and state provided
+    def self.get_by_office_state office_id, state_id = 'NA', district_name = ''
+      request("District.getByOfficeState", "officeId" => office_id, "stateId" => state_id, "districtName" => district_name)
+    end
+    
+  end
+end