votesmart 0.3.0

data/lib/vote_smart/district.rb

@@ -0,0 +1,38 @@
+module VoteSmart
+  
+  class District < Common
+    
+    attr_accessor :id, :name, :office_id, :state_id
+    
+    attr_accessor :office
+    
+    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

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,119 @@
+module VoteSmart
+  
+  class Office < Common
+    
+    attr_accessor :id, :type_id, :level_id, :branch_id, :name, :title, :short_title
+    
+    attr_accessor :office
+    
+    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 = District.find_all_by_office_id_and_state_id(self.id, state_id)
+      districts.each { |district| district.office = self }
+      @districts_by_state[state_id] ||= districts
+    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 = Official.find_by_office_id_and_state_id(self.id, state_id)
+      official.office = self if official
+      @official_by_state[state_id] ||= official
+    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,131 @@
+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
+    
+    attr_accessor :district, :office, :office_id, :party
+    
+    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, "officeParties" => :party, "officeStateId" => :state_id
+    
+    def offices
+      offices = Official.response_child(Address.get_office(self.id), "address", "office")
+      (offices.is_a?(Array) ? offices : [offices]).collect {|office| 
+        CandidateOffice.new(office)
+      }
+    end
+    
+    def inspect
+      "Official: " + [title, first_name, last_name].compact.join(' ')
+    end
+    
+    def office_id
+      @office_id || (office.id if office)
+    end
+    
+    def self.find_by_district district
+      official = find_by_district_id district.id
+      official.district = district if official
+      official.office = district.office if official
+      official
+    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 = Official.new(response) unless response.empty?
+      official.office_id = office_id if official
+      official.state_id ||= state_id if official
+      official
+    end
+    
+    
+    
+    def self.find_all_by_address address, city, state, zip
+      placemark = Geocoding.get("#{address} #{city}, #{state} #{zip}").first
+      
+      return [] unless placemark
+      
+      state ||= placemark.administrative_area
+      
+      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,43 @@
+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", "categoryId" => category_id, "stateId" => state_id)
+    end
+    
+    # Returns detailed SIG information
+    def self.get_sig sig_id
+      result = request("Rating.getSig", "sigId" => sig_id)
+      # PVS return utf control codes for punction in descriptions
+      if result['sig']['description'].first == '"'
+        result['sig']['description'] = result['sig']['description'][1..-2]
+      end
+      result['sig']['description'] = result['sig']['description'].unpack("U*").map do |char|
+        case char
+        when 146 # 0092
+          39
+        when 148, 147 # 0093,4
+          34
+        when 150, 151 # 0096,7
+          45
+        else
+          char
+        end
+      end.pack("U*")
+      result
+    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