netroots-ruby-votesmart 0.1.1 → 0.2.0

data/lib/vote_smart/election.rb

@@ -0,0 +1,21 @@
+module VoteSmart
+  
+  class Election < Common
+    
+    # Returns detailed election information
+    def self.get_election election_id
+      request("Election.getElection", "electionId" => election_id)
+    end
+    
+    # returns a list of elections based on the criteria
+    def self.get_election_by_year_state year, state_id
+      request("Election.getElectionByYearState", "year" => year, "stateId" => state_id)
+    end
+    
+    # Returns a list of candidates in the election and election stage provided
+    def self.get_stage_candidates election_id, stage_id, party = ""
+      request("Election.getStageCandidates", "electionId" => election_id, "stageId" => stage_id, "party" => party)
+    end
+    
+  end
+end

data/lib/vote_smart/leadership.rb

@@ -0,0 +1,16 @@
+module VoteSmart
+  
+  class Leadership < Common
+    
+    # Returns a list of leadership positions
+    def self.get_positions state_id = "NA", office_id = nil
+      request("Leadership.getPositions", "stateId" => state_id, "officeId" => office_id)
+    end
+    
+    # Returns a list of candidates in specific leadership positions
+    def self.get_officials leadership_id, state_id = "NA"
+      request("Leadership.getOfficials", "leadershipId" => leadership_id, "stateId" => state_id)
+    end
+    
+  end
+end

data/lib/vote_smart/local.rb

@@ -0,0 +1,21 @@
+module VoteSmart
+  
+  class Local < Common
+    
+    # Returns a list of cities in a given state
+    def get_cities state_id
+      request("Local.getCities", "stateId" => state_id)
+    end
+    
+    # Returns a list of counties in a given state.
+    def get_counties state_id
+      request("Local.getCounties", "stateId" => state_id)
+    end
+    
+    # 
+    def get_officials local_id
+      request("Local.getOfficials", "localId" => local_id)
+    end
+    
+  end
+end

data/lib/vote_smart/measure.rb

@@ -0,0 +1,16 @@
+module VoteSmart
+  
+  class Measure < Common
+    
+    # Returns a ballot measure's details
+    def self.get_measure measure_id
+      request("Measure.getMeasure", "measureId" => measure_id)
+    end
+    
+    # Returns a list of ballot measures that fit the criteria
+    def self.get_measures_by_year_state year, state_id
+      request("Measure.getMeasuresByYearState", "year" => year, "stateId" => state_id)
+    end
+    
+  end
+end

data/lib/vote_smart/notes.rb

@@ -0,0 +1,11 @@
+module VoteSmart
+  
+  class Notes < Common
+    
+    attr_accessor :contact_name, :contact_title, :note
+    
+    set_attribute_map "contactName" => :contact_name, "contactTitle" => :contact_title, "note" => :note
+    
+  end
+  
+end

data/lib/vote_smart/npat.rb

@@ -0,0 +1,11 @@
+module VoteSmart
+  
+  class Npat < Common
+    
+    # Returns the most recent NPAT filled out by a candidate
+    def self.get_npat can_id
+      request("Npat.getNpat", "candidateId" => can_id)
+    end
+    
+  end
+end

data/lib/vote_smart/office.rb

@@ -0,0 +1,113 @@
+module VoteSmart
+  
+  class Office < Common
+    
+    attr_accessor :id, :type_id, :level_id, :branch_id, :name, :title, :short_title
+    
+    set_attribute_map "officeId" => :id, "officeTypeId" => :type_id, "officeLevelId" => :level_id,
+                      "officeBranchId" => :branch_id, "name" => :name, "title" => :title, "shortTitle" => :short_title
+    
+    def districts_by_state_id state_id
+      @districts_by_state ||= {}
+      @districts_by_state[state_id] ||= District.find_all_by_office_id_and_state_id(self.id, state_id)
+    end
+    
+    def district_by_state_id_and_number state_id, number
+      number = number.to_i
+      districts = districts_by_state_id(state_id)
+      districts.find {|district| district.number == number}
+    end
+    
+    def official_by_state_id state_id
+      @official_by_state ||= {}
+      @official_by_state[state_id] ||= Official.find_by_office_id_and_state_id(self.id, state_id)
+    end
+    
+    def self.all
+      Type.all.collect { |type| find_all_by_type(type) }.uniq.flatten
+    end
+    
+    def self.find_all_by_type type
+      find_all_by_type_id(type.id)
+    end
+    
+    def self.find_all_by_type_id type_id
+      response_child(get_offices_by_type(type_id), "offices", "office").collect {|attributes| Office.new(attributes)}
+    end
+    
+    def self.find_by_name name
+      Office.all.collect {|office| office if office.name == name }.compact.first
+    end
+    
+    def self.find_all_by_name names
+      offices = Office.all
+      names.collect {|name| offices.find {|office| office.name == name }}
+    end
+    
+    # Gets a list of office types
+    def self.get_types
+      request("Office.getTypes")
+    end
+    
+    # Returns branches of government and their respective IDs
+    def self.get_branches
+      request("Office.getBranches")
+    end
+    
+    # Returns levels of government and their respective IDs
+    def self.get_levels
+      request("Office.getLevels")
+    end
+    
+    # Returns a list of offices by office type
+    def self.get_offices_by_type type_id
+      request("Office.getOfficesByType", "typeId" => type_id)
+    end
+    
+    # Returns a list of offices by level of government
+    def self.get_offices_by_level level_id
+      request("Office.getOfficesByLevel", "levelId" => level_id)
+    end
+    
+    # Returns a list of offices by office type and level of government
+    def self.get_offices_by_type_level type_id, level_id
+      request("Office.getOfficesByType", "levelId" => level_id, "typeId" => type_id)
+    end
+    
+    # Returns a list of offices by branch and level of government
+    def self.get_offices_by_branch_level branch_id, level_id
+      request("Office.getOfficesByBranchLevel", "branchId" => branch_id, "levelId" => level_id)
+    end
+    
+    class Type < Common
+      
+      
+      attr_accessor :id, :level_id, :branch_id, :name
+
+      set_attribute_map "officeTypeId" => :id, "officeLevelId" => :level_id,
+                        "officeBranchId" => :branch_id, "name" => :name
+      
+      def self.all
+        @types ||= response_child(Office.get_types, "officeTypes", "type").collect {|attributes| Type.new(attributes)}
+      end
+      
+      def self.find_by_name name
+        Type.all.collect {|type| type if type.name == name }.compact.first
+      end
+      
+      def offices
+        @offices ||= Office.find_all_by_type(self)
+      end
+      
+      def offices_by_name names
+        names.collect {|name| offices.find {|office| office.name == name }}
+      end
+      
+      def office_by_name name
+        offices_by_name([name]).first
+      end
+      
+    end
+    
+  end
+end

data/lib/vote_smart/official.rb

@@ -0,0 +1,111 @@
+module VoteSmart
+  
+  class Official < Common
+    
+    attr_accessor :id, :first_name, :nick_name, :middle_name, :last_name, :suffix, :title,
+                  :election_parties, :office_parties, :district_id, :district_name, :state_id
+    
+    set_attribute_map "candidateId" => :id, "firstName" => :first_name, "nickName" => :nick_name,
+                      "middleName" => :middle_name, "lastName" => :last_name, "suffix" => :suffix,
+                      "title" => :title, "electionParties" => :election_parties, "officeDistrictId" => :district_id,
+                      "officeDistrictName" => :district_name, "officeStateId" => :state_id
+    
+    def offices
+      Official.response_child(Address.get_office(self.id), "address", "office").collect {|office| CandidateOffice.new(office) }
+    end
+    
+    def inspect
+      "Official: " + [title, first_name, last_name].compact.join(' ')
+    end
+    
+    def self.find_by_district district
+      find_by_district_id district.id
+    end
+    
+    def self.find_by_district_id district_id
+      response = response_child(get_by_district(district_id), "candidateList", "candidate")
+      Official.new(response) unless response.empty?
+    end
+    
+    def self.find_by_office_id_and_state_id office_id, state_id
+      response = response_child(get_by_office_state(office_id, state_id), "candidateList", "candidate")
+      Official.new(response) unless response.empty?
+    end
+    
+    
+    
+    def self.find_all_by_address address, city, state, zip
+      placemark = Geocoding.get("#{address} #{city}, #{state} #{zip}").first
+      placemark ? find_all_by_state_and_latitude_and_longitude(state, placemark.latitude, placemark.longitude) : []
+    end
+
+    def self.find_all_by_state_and_latitude_and_longitude state, latitude, longitude
+      response = Mcll4r.new.district_lookup(latitude, longitude)
+      response = response["response"] if response
+
+      state_upper = (response["state_upper"] || {})["district"]
+      state_lower = (response["state_lower"] || {})["district"]
+
+      find_all_state_wide_officials(state) + find_state_legislators(state, state_upper, state_lower, state_lower)
+    end
+
+    def self.find_all_state_wide_officials state_id
+      state_wide_office_names = ["Secretary of State", "Secretary of the Commonwealth", "Attorney General", "Secretary of Education",
+                                 "Education Secretary", "Treasurer", "Auditor"]
+
+      state_wide_type = Office::Type.find_by_name("State Wide")
+
+      state_wide_offices = state_wide_type ? state_wide_type.offices_by_name(state_wide_office_names) : []
+
+      state_wide_offices.collect { |office| office.official_by_state_id(state_id) }.compact
+    end
+
+    def self.find_state_legislators state_id, senate_district, house_district, assembly_district
+      officials = []
+
+      state_leg_type = Office::Type.find_by_name("State Legislature")
+
+      {"State Senate" => senate_district,
+       "State House" => house_district,
+       "State Assembly" => assembly_district}.each do |office_name, district_number|
+
+         office = state_leg_type.office_by_name(office_name) if state_leg_type
+
+         district = office.district_by_state_id_and_number(state_id, district_number) if office
+
+         official = district.official if district
+
+         officials.push official if official
+      end
+
+      officials
+    end
+    
+    
+    # Returns a list of incumbents that fit the criteria
+    def self.get_by_office_state office_id, state_id = 'NA'
+      request("Officials.getByOfficeState", "officeId" => office_id, "stateId" => state_id)
+    end
+    
+    # Searches for incumbents with exact lastname matches
+    def self.get_by_lastname lastname
+      request("Officials.getByLastname", "lastName" => lastname)
+    end
+    
+    # Searches for incumbents with fuzzy lastname match
+    def self.get_by_levenstein lastname
+      request("Officials.getByLevenstein", "lastName" => lastname)
+    end
+    
+    # Returns incumbents in the provided election_id
+    def self.get_by_election election_id
+      request("Officials.getByElection", "electionId" => election_id)
+    end
+    
+    # Returns incumbents in the provided district_id
+    def self.get_by_district district_id
+      request("Officials.getByDistrict", "districtId" => district_id)
+    end
+    
+  end
+end

data/lib/vote_smart/phone.rb

@@ -0,0 +1,12 @@
+module VoteSmart
+  
+  class Phone < Common
+    
+    attr_accessor :phone1, :phone2, :fax1, :fax2, :toll_free, :ttyd
+    
+    set_attribute_map "phone1" => :phone1, "phone2" => :phone2, "fax1" => :fax1, "fax2" => :fax2,
+                      "tollFree" => :toll_free, "ttyd" => :ttyd
+    
+  end
+  
+end

data/lib/vote_smart/rating.rb

@@ -0,0 +1,26 @@
+module VoteSmart
+  
+  class Rating < Common
+    
+    # Returns categories with ratings according to state_id(NA = fed)
+    def self.get_categories state_id = nil
+      request("Rating.getCategories", "stateId" => state_id)
+    end
+    
+    # Returns a list of SIGs with ratings in category and state
+    def self.get_sig_list category_id, state_id = 'NA'
+      request("Rating.getSigList", "category_id" => category_id, "stateId" => state_id)
+    end
+    
+    # Returns detailed SIG information
+    def self.get_sig sig_id
+      request("Rating.getSig", "sigId" => sig_id)
+    end
+    
+    # Returns an SIG's rating on a specific candidate
+    def self.get_candidate_rating candidate_id, sig_id
+      request("Rating.getCandidateRating", "candidateId" => candidate_id, "sigId" => sig_id)
+    end
+    
+  end
+end

data/lib/vote_smart/state.rb

@@ -0,0 +1,29 @@
+module VoteSmart
+  
+  class State < Common
+    
+    attr_accessor :id, :name, :largest_city
+    
+    set_attribute_map "stateId" => :id, "name" => :name, "largestCity" => :largest_city
+    
+    def self.all
+      response_child(get_state_ids, "stateList", "list", "state").collect {|attributes| State.new(attributes)}
+    end
+    
+    def self.find_by_id state_id
+      response = response_child(get_state(state_id), "state", "details")
+      State.new(response) unless response.empty?
+    end
+    
+    # Returns a list of states and their 2 digit IDs
+    def self.get_state_ids
+      request("State.getStateIDs")
+    end
+    
+    # Returns detailed state information
+    def self.get_state state_id
+      request("State.getState", "stateId" => state_id)
+    end
+    
+  end
+end

data/lib/vote_smart/vote.rb

@@ -0,0 +1,70 @@
+module VoteSmart
+  
+  class Vote < Common
+    
+    # Returns a list of categories with votes assigned for the year and state provided
+    def self.get_categories year, state_id = 'NA'
+      request("Votes.getCategories", "stateId" => state_id)
+    end
+    
+    # Returns detailed bill information
+    def self.get_bill bill_id
+      request("Votes.getBill", "billId" => bill_id)
+    end
+    
+    # Returns a bill's action/stage(signed by prez, passed senate) detailed information
+    def self.get_bill_action act_id
+      request("Votes.getBillAction", "actionId" => act_id)
+    end
+    
+    # Get's a bill's action's votes
+    def self.get_bill_action_votes act_id
+      request("Votes.getBillActionVotes", "actionId" => act_id)
+    end
+    
+    # Gets a single candidate's vote on a bill
+    def self.get_bill_action_votes_by_official act_id, can_id
+      request("Votes.getBillActionVoteByOfficial", "actionId" => act_id, "candidateId" => can_id)
+    end
+    
+    # Gets a list of bills that fit the criteria
+    def self.get_bills_by_category_year_state category_id, year, state = 'NA'
+      request("Votes.getBillsByCategoryYearState", "categoryId" => category_id, "year" => year, "stateId" => state)
+    end
+    
+    # Gets a list of bills that fit the criteria
+    def self.get_bills_by_year_state year, state_id = 'NA'
+      request("Votes.getBillsByYearState", "year" => year, "stateId" => state_id)
+    end
+    
+    # Gets a list of bills that fit the criteria
+    def self.get_bills_by_official_year can_id, year
+      request("Votes.getBillsByOfficialYear", "candidateId" => can_id, "year" => year)
+    end
+    
+    # Gets a list of bills that fit the criteria
+    def self.get_bills_by_official_category can_id, category_id
+      request("Votes.getBillsByOfficialCategory", "candidateId" => can_id, "categoryId" => category_id)
+    end
+    
+    # Gets a list of bills that fit the criteria
+    def self.get_bills_by_sponsor_year can_id, year
+      request("Votes.getBillsBySponsorYear", "candidateId" => can_id, "year" => year)
+    end
+    
+    # Gets a list of bills that fit the criteria
+    def self.get_bills_by_sponsor_category can_id, category_id
+      request("Votes.getBillsBySponsorCategory", "candiateId" => can_id, "categoryId" => category_id)
+    end
+    
+    # Gets a list of bills that fit the criteria
+    def self.get_bills_by_state_recent ammount, state_id = 'NA'
+      request("Votes.getBillsByStateRecent", "stateId" => state_id, "ammount" => ammount)
+    end
+    
+    # Gets a list of vetoes for the provided candidate
+    def self.get_vetoes can_id
+      request("Votes.getVetoes", "candidateId" => can_id)
+    end
+  end
+end