pitosalas-govsdk 0.0.1 → 0.0.2

data/README.textile

@@ -0,0 +1,43 @@
+h1. Overview
+
+THIS IS INCOMPLETE. I AM STILL WORKING ON IT
+
+h1. LICENSE
+
+GovSDK is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+GovSDK is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+
+h1. INTRODUCTION
+
+There are numerous 'government' APIs from various organizations. This SDK is a model for accessing all of them in a simple and consistent way. I will try to insulate users of this library from changes that might happen in one SDK or another, and where information is available from different sources, pick the source that seems to be the most authoritative at the time. The idea is that by using this API, the developer can stay blissfully unaware of the underlying APIs, as they evolve and change.
+
+h1. KEY IDEAS
+
+h2. API Keys
+
+Unfortunately for now, each of the different services request that you use it's own API key to get permission to access them. So right off the bat, there's a way that the abstraction will leak. It can't be helped, the user of this library will have to acquire API keys for the relevant services and supply them.
+
+h2. IDs
+
+There are various IDs (identifiers assigned by some outside, real world agency to some outside real world thing) throughout the government. One you know is a drivers license number assigned to a person. Within our universe here are some of the IDs:
+
+# CrpId - Center for responsible politics IDs for congress persons
+	
+In many cases none of the APIs furnish a useful ID. 
+
+h1. KEY CLASSES
+
+# APIMgr - Parent class of each of the manager classes below
+## NewYorkTimesAPI - Class managing access to the New York Times API
+## SunlightAPI - Class managing access to the Sunlight API
+## SpenSecretsAPI - Class managing the OpenSecrets API
+### Methods: setAPIKey/getAPIKey
+	
+# CongressPerson - Work with legislators: senators and congressmen
+	
+#### self.find_by_name - return an array of CongressPersons
+#### self.find_by_zipcode - return an array of CongressPersons
+#### self.find_by_crp_id - return the CongressPerson with specified crp id

data/VERSION.yml

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

data/lib/{template.rb → apis/generic_api.rb}

@@ -1,6 +1,6 @@
 =begin
-  * Name: GovSDK
-  * Description: 
+  * Name: generic_api.rb
+  * Description: Logic that all API handlers for GovSdk have
   * Author: Pito Salas
   * Copyright: (c) R. Pito Salas and Associates, Inc.
   * Date: January 2009
@@ -20,4 +20,20 @@
 
   You should have received a copy of the GNU General Public License
   along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+
 =end
+
+require 'httparty'
+
+class GenericApi  
+  
+  def initialized?
+    !@api_key.nil? || @api_key.kind_of?(String)
+  end
+  
+end

data/lib/apis/google_api.rb

@@ -0,0 +1,56 @@
+=begin
+  * Name: google_api.rb
+  * Description: Interfaces to Google APIs
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+  
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+  
+=end
+
+require 'generic_api'
+
+class GoogleApi < GenericApi
+  include HTTParty
+  GoogleApi.base_uri "http://ajax.googleapis.com/ajax/services"
+  format :json
+
+  # Simply declare and remember the API Key
+  def key=(key)
+    @api_key = key
+    GoogleApi.default_params(:key => key, :v => '1.0')
+  end
+  
+  def lookup_feed_url(page_url)
+    begin
+      result = GoogleApi.get("/feed/lookup", :query => {:q => page_url})
+    rescue Net::HTTPServerException => exception
+      puts "\nEXCEPTION: from GoogleApi::lookup_feed_url: #{exception.response.body}"
+      return nil
+    end
+    resp = result["responseData"]
+    resp.nil? ? nil : resp["url"]
+  end
+    
+end
+

data/lib/{apimanagers.rb → apis/open_secrets_api.rb}

@@ -21,70 +21,22 @@
   You should have received a copy of the GNU General Public License
   along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
 =end
+require 'generic_api'
 
-require 'rubygems'
-require 'httparty'
-require 'cgi'
-require 'net/http'
-
-#require "ruby-debug"
-#Debugger.settings[:autolist] = 1 # list nearby lines on stop
-#Debugger.settings[:autoeval] = 1
-#Debugger.start
-
-class GenericAPI  
-  
-  def initialized?
-    !@api_key.nil? || @api_key.kind_of?(String)
-  end
-  
-end
-
-# Control Access to Sunlight API.
-
-class Sunlight < GenericAPI
-  include HTTParty
-  Sunlight.base_uri "services.sunlightlabs.com"
-
-  def legislators_search(params)
-    result = Sunlight.get("/api/legislators.search", :query => {:name => params})
-    result["response"]["results"]
-  end
-  
-  # Simply declare and remember the API Key
-  def key=(key)
-    @api_key = key
-    Sunlight.default_params :apikey => key
-  end
-
-  # Call any of the various legal Sunlight queries
-  def legislators_get(params)
-    begin
-      result = Sunlight.get("/api/legislators.get", :query => params)
-      result = result["response"]["legislator"]
-    rescue Net::HTTPServerException => exception
-      puts "EXCEPTION: from Sunlight - legislators.get: #{exception.response.body}"
-      return nil
-    end
-  end
-  
-end
-
-# Control Access to OpenSecrets API.
-class OpenSecrets < GenericAPI
+class OpenSecretsApi < GenericApi
   include HTTParty
   base_uri "www.opensecrets.org/api/"
   format :xml
 
   def key=(key)
     @api_key = key
-    OpenSecrets.default_params :apikey => key
+    OpenSecretsApi.default_params :apikey => key
   end
   
   def get_cand_info(method_name, crpID, cycle)
     query_hash = {:method => method_name}
     begin
-      result = OpenSecrets.get("", :query => query_hash.merge({:cid => crpID, :cycle => cycle}))
+      result = OpenSecretsApi.get("", :query => query_hash.merge({:cid => crpID, :cycle => cycle}))
     rescue Net::HTTPServerException => exception
       puts "EXCEPTION: from Opensecrets! #{method_name}: #{exception.response.body}"
       return nil
@@ -117,8 +69,3 @@ class OpenSecrets < GenericAPI
   end
 end
 
-
-
-  
-
-

data/lib/apis/sunlight_api.rb

@@ -0,0 +1,70 @@
+=begin
+  * Name: GovSDK
+  * Description: 
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+=end
+
+require 'rubygems'
+require 'cgi'
+require 'net/http'
+require 'generic_api'
+
+# Control Access to Sunlight API.
+
+class SunlightApi < GenericApi
+  include HTTParty
+  SunlightApi.base_uri "services.sunlightlabs.com"
+
+  def legislators_search(params)
+    result = SunlightApi.get("/api/legislators.search", :query => {:name => params})
+    result["response"]["results"]
+  end
+  
+  # Simply declare and remember the API Key
+  def key=(key)
+    @api_key = key
+    SunlightApi.default_params :apikey => key
+  end
+
+  # Call Sunlight queries returning a single legislator matching a query
+  def legislators_get(params)
+    begin
+      result = SunlightApi.get("/api/legislators.get", :query => params)
+      result = result["response"]["legislator"]
+    rescue Net::HTTPServerException => exception
+      puts "EXCEPTION: from Sunlight - legislators.get: #{exception.response.body}"
+      return nil
+    end
+  end
+  
+  # Sunlight query returning an array of matching legislators
+  def legislators_getlist(params)
+    begin
+      result = SunlightApi.get("/api/legislators.getList", :query => params)
+      result = result["response"]["legislators"]
+    rescue Net::HTTPServerException => exception
+      puts "EXCEPTION: from Sunlight - legislators.getList: #{exception.response.body}"
+      return nil
+    end
+  end
+  
+  
+end

data/lib/apis/vote_smart_api.rb

@@ -0,0 +1,68 @@
+=begin
+  * Name: vote_smart_api.rb
+  * Description: GovSdk support for votesmart api
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+=end
+
+require 'generic_api'
+
+class VoteSmartApi < GenericApi
+  include HTTParty
+  VoteSmartApi.base_uri "http://api.votesmart.org"
+  format :xml
+
+  # Simply declare and remember the API Key
+  def key=(key)
+    @api_key = key
+    VoteSmartApi.default_params :key => key
+  end
+  
+  def get_votesmart_candidate(method_name, query)
+    begin
+      result = VoteSmartApi.get(method_name, query)
+    rescue Net::HTTPServerException => exception
+      puts "\nEXCEPTION: from votesmart_api #{method_name}: #{exception.response.body}"
+      return nil
+    end
+    if result.has_key?("error")
+      puts "\nERROR: from votesmart_api #{method_name}: #{result["error"]["errorMessage"]}"
+      return nil
+    else
+      result["candidateList"]["candidate"]
+    end
+  end
+  
+  def candidate_fuzzy_find(lastname)
+    get_votesmart_candidate("/Candidates.getByLevenstein", :query => {:lastName => lastname})
+  end
+
+  def officials_fuzzy_find(lastname)
+    get_votesmart_candidate("/Officials.getByLevenstein", :query => {:lastName => lastname})
+  end
+
+  def candidate_getBio(candidateId)
+    get_votesmart_candidate("/Candidate.getBio", :query => {:candidateId => candidateId})
+  end
+  
+  def candidate_find_for_office_and_state(office, state)
+    get_votesmart_candidate("/Candidate.getByOfficeState", :query => {:officeId => office, :stateId => state})
+  end
+end

data/lib/congress_person.rb

@@ -0,0 +1,187 @@
+=begin
+  * Name: GovSDK
+  * Description: 
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+  
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+  
+=end
+
+class CongressPerson < GovSdkBase
+  
+  attr_reader :firstname, :lastname, :party, :state, :congress_office, :phone, :fax, :emai,
+              :website, :webform, :website_url, :bioguide_id, :congresspedia_url, :state_machine_id,
+              :district, :title, :govtrack_id, :crp_id, :nickname, :votesmart_id
+              
+  # Maps specific set of CongressPerson attributes to Sunlight APIs. Mapping is structured as
+  # "name of attr in CongressPerson object" => "name of hash key in result returned from API call"
+  
+  SUNLIGHT_MAP = { 
+          "firstname"         => "firstname",
+          "lastname"          => "lastname",
+          "nickname"          => "nickname",
+          "party"             => "party",
+          "state"             => "state",
+          "congress_office"   => "congress_office",
+          "phone"             => "phone",
+          "fax"               => "fax",
+          "email"             => "email",
+          "website"           => "website",
+          "webform"           => "webform",
+          "bioguide_id"       => "bioguide_id",
+          "votesmart_id"      => "votesmart_id",
+          "congresspedia_url" => "congresspedia_url",
+          "fec_id"            => "fec_id",
+          "district"          => "district",
+          "title"             => "title",
+          "govtrack_id"       => "govtrack_id",
+          "crp_id"            => "crp_id"
+        }
+
+  def self.copy_sun_properties(sunlight_hash, cong_person)
+    SUNLIGHT_MAP.each do |name, attribute|
+      val = sunlight_hash[attribute]
+      cong_person.instance_variable_set("@#{name}", val)
+    end
+  end
+  
+  def self.convert_to_congressperson(sunlight_legislator)
+    cong_person = CongressPerson.new
+    leg_hash = sunlight_legislator
+    copy_sun_properties(leg_hash, cong_person)
+    cong_person
+  end
+
+  def self.fuzzy_find_by_name(name)
+    raise ArgumentError, 'names must be Strings' unless name.is_a?(String)
+    sunlight_hash = GovSdk.sunlight_api.legislators_search(name)
+    sunlight_hash.collect {|leg| convert_to_congressperson(leg["result"]["legislator"])}
+  end
+
+  def self.find_by_zipcode(zip)
+    raise ArgumentError, 'zipcodes must be Strings' unless zip.is_a?(String)
+  end
+  
+  def self.find_by_query(query)
+    assume_hash query
+    result_array = GovSdk.sunlight_api.legislators_getlist(query)
+    result_array.collect { |leg| convert_to_congressperson(leg["legislator"])}
+  end
+  
+  def self.find_by_crp_id(crpId)
+    raise ArgumentError, 'Crp-Id should be a string' unless crpId.kind_of?(String)
+    sunlight_hash = GovSdk.sunlight_api.legislators_get(:crp_id => crpId)
+    if !sunlight_hash.nil?
+      cong_person = CongressPerson.new
+      copy_sun_properties(sunlight_hash, cong_person)
+      cong_person
+    else
+      nil
+    end
+  end
+  
+  def get_fundraising_summary(electionCycle = nil)
+    raise ArgumentError, 'election cycle should be nil or an integer' unless electionCycle.nil? || electionCycle.kind_of?(Integer)
+    fund_summary_hash = GovSdk.opensecrets_api.get_cand_summary_for_crpID(crp_id, electionCycle)
+    fr_summary = FundraisingSummary.new(fund_summary_hash)
+  end
+  
+  def get_positions_held(electionCycle = nil)
+    assume_nil_or_integer electionCycle
+    positions = GovSdk.opensecrets_api.get_cand_pfd_positions_held(crp_id, electionCycle)
+    if positions.class == Array
+      return positions.collect {|pos| Positions.new(pos)}
+    elsif positions.class == Hash
+      return [Positions.new(positions)]
+    else
+      []
+    end
+  end
+  
+  # Return url to the photo of this Congress Person. This method uses the votesmart.org/candphoto/1234.jpg resource
+  def photo_url
+    assume_not_blank votesmart_id, "Votesmart_id cannot be blank when calling get_photo_url"
+    "http://www.votesmart.org/canphoto/#{@votesmart_id}.jpg"
+  end
+  
+  # Return url of the Congress Person's web site, or nil if we can't find one. 
+  def blog_url
+    assume_uses_google_api
+    return nil if website.nil?
+    blog = GovSdk.google_api.lookup_feed_url(website)
+    if blog.nil? || blog.empty?
+      nil
+    else
+      blog
+    end
+  end
+end
+
+class FundraisingSummary
+  attr_reader :spent, :total, :cash_on_hand, :debt
+  
+  # Maps specific set of FundraisingSummary attributes to OpenSecrets APIs. Mapping is structured
+  # "name of attr in CongressPerson object" => "name of hash key in result returned from API call"
+  OPENS_FUNSUMMARY_MAP = { 
+    "spent"         => "spent",
+    "total"         => "total",
+    "cash_on_hand"  => "cash_on_hand",
+    "debt"          => "debt"
+  }
+  
+  # Given a hash of FundraisingSummary values from the OpenSecrets API, populate the corresponding
+  # instance variables in this instance. 
+  def initialize(init_hash)
+    OPENS_FUNSUMMARY_MAP.each do |name, attribute| 
+      val = init_hash[attribute]
+      instance_variable_set("@#{name}", val.to_i)
+    end
+  end
+end
+
+class Positions
+  attr_reader :title, :organization
+  
+  # Maps specific set of CongressPerson attributes to OpenSecrets APIs. Mapping is structured
+  # "name of attr in CongressPerson object" => "name of hash key in result returned from API call"
+  OPENS_POS_MAP = { 
+    "title"         => "title",
+    "organization"  => "organization"
+  }
+  
+  # Given a hash of Positions values from the OpenSecrets API, populate the corresponding
+  # instance variables in this instance. 
+  def initialize(init_hash)
+    OPENS_POS_MAP.each do |name, attribute| 
+      val = init_hash[attribute]
+      instance_variable_set("@#{name}", val)
+    end
+  end
+  
+  # Pretty print this instance. This method is called behind the scenes when a Position
+  # is encountered during a PP traversal of objects.
+  def pretty_print(pp)
+    pp.text("position #{title} at #{organization}")
+  end
+end

data/lib/govsdk.rb

@@ -30,29 +30,37 @@
 class GovSdk
 
   def self.load_apis
-    @sunl_api = Sunlight.new
-    @opens_api = OpenSecrets.new
+    @sunlight_api = SunlightApi.new
+    @opensecrets_api = OpenSecretsApi.new
+    @votesmart_api = VoteSmartApi.new
+    @google_api = GoogleApi.new
+  end
+  
+  def self.votesmart_api
+    @votesmart_api
   end
   
   def self.sunlight_api
-    @sunl_api
+    @sunlight_api
   end
   
   def self.opensecrets_api
-    @opens_api
+    @opensecrets_api
   end
   
-  def self.followmoney_api
-    @followm_api
+  def self.google_api
+    @google_api
   end
-  
+    
   def self.init(apikeys = {})
-    apikeys.keys.each { |x| raise ArgumentError unless [:followmoney, :sunlight, :opensecrets].include?(x) }
+    apikeys.keys.each { |x| raise ArgumentError unless [:google, :followmoney, :sunlight, :opensecrets, :votesmart].include?(x) }
     GovSdk.load_apis
     apikeys.each do |key, val|
-      @sunl_api.key = val if key == :sunlight
-      @opens_api.key = val if key == :opensecrets
+      @sunlight_api.key = val if key == :sunlight
+      @opensecrets_api.key = val if key == :opensecrets
       @followm_api.key = val if key == :followmoney
+      @votesmart_api.key = val if key == :votesmart
+      @google_api.key = val if key == :google
     end
   end
   

data/lib/govsdk_base.rb

@@ -0,0 +1,54 @@
+=begin
+  * Name: GovSDK
+  * Description: 
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+  
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+  
+=end
+
+class GovSdkBase
+
+# General error checking and reporting methods
+  def assume_not_blank val, message
+    raise ArgumentError, (message + caller.shift) unless val.nil? || val.kind_of?(String)
+  end
+  
+  def assume_uses_google_api
+    raise ArgumentError, "Call requires Google API and Google key" + called.shift unless GovSdk.google_api.initialized?
+  end
+  
+  def assume_nil_or_integer val
+    raise ArgumentError, "Requires nil or integer argument. Called from " + called.shift unless  val.nil? || val.kind_of?(Integer)
+  end
+  
+  def self.assume_hash val
+    raise ArgumentError, "Requires a hash argument. Called from " + called.shift unless val.kind_of?(Hash)
+  end    
+  
+  def assume_hash val
+    self.assume_hash val
+  end
+  
+end

data/lib/govsdkgem.rb

@@ -1,6 +1,6 @@
 =begin
-  * Name: GovSDK
-  * Description: 
+  * Name: govsdkgem.rb
+  * Description: Gem root 'require' file for govsdk
   * Author: Pito Salas
   * Copyright: (c) R. Pito Salas and Associates, Inc.
   * Date: January 2009
@@ -22,6 +22,13 @@
   along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
 =end
 
+$LOAD_PATH.unshift(File.dirname(__FILE__)+"/../lib/apis")
+
 require 'govsdk'
-require 'apimanagers'
-require 'congressperson'
+require 'govsdk_base'
+require 'open_secrets_api'
+require 'congress_person'
+require 'vote_smart_api'
+require 'google_api'
+require 'sunlight_api'
+require 'opmloco'

data/test/congressperson_test.rb

@@ -20,6 +20,12 @@
 
   You should have received a copy of the GNU General Public License
   along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+
 =end
 
 require File.dirname(__FILE__) + '/test_helper'
@@ -29,8 +35,8 @@ class CongressPersonTest < Test::Unit::TestCase
     setup do
       GovSdk.load_apis
       GovSdk.sunlight_api.key = "4ffa22917ab1ed010a8e681c550c9593"
-      @cpnone = CongressPerson.find_by_name("Pito Salas")
-      @cpkennedy = CongressPerson.find_by_name("Kennedy")
+      @cpnone = CongressPerson.fuzzy_find_by_name("Pito Salas")
+      @cpkennedy = CongressPerson.fuzzy_find_by_name("Kennedy")
       @cpkennedy[0].nickname == "Ted" ? @ted_crp_id = @cpkennedy[0].crp_id : @ted_crp_id = @cpkennedy[1].crp_id
     end
 
@@ -58,7 +64,23 @@ class CongressPersonTest < Test::Unit::TestCase
       should "crpid should be for ted kennedy" do
         assert_equal "Ted", @cpteddy.nickname
       end
+      
+      should "have votesmart_id for Ted Kennedy one" do
+        assert_equal "53305", @cpteddy.votesmart_id
+        assert_equal "http://www.votesmart.org/canphoto/53305.jpg", @cpteddy.photo_url
+      end
     end
+    
+    context "Find all legislators with certain criteria" do
+      setup do
+        @all_kennedy = CongressPerson.find_by_query(:lastname => "kennedy")
+      end
+
+      should "locate 2 kennedies" do
+        assert_equal 2, @all_kennedy.length
+      end
+    end
+    
 
     context "Get fundraising summary for N00000308" do
       setup do
@@ -79,7 +101,7 @@ class CongressPersonTest < Test::Unit::TestCase
       setup do
         GovSdk.opensecrets_api.key = "09c975b6d3f19eb865805b2244311065"
         @mycandidate = CongressPerson.find_by_crp_id("N00000360")
-        @nopositioncandidate = CongressPerson.find_by_name("Clinton")
+        @nopositioncandidate = CongressPerson.fuzzy_find_by_name("Clinton")
       end
 
       should "see what positions were held for N00000360" do
@@ -96,7 +118,7 @@ class CongressPersonTest < Test::Unit::TestCase
     context "Try some other odd cases" do
       setup do
         GovSdk.opensecrets_api.key = "09c975b6d3f19eb865805b2244311065"
-        @franks = CongressPerson.find_by_name("Frank")[0]
+        @franks = CongressPerson.fuzzy_find_by_name("Frank")[0]
       end
 
       should "see that barney frank reported zero positions" do
@@ -104,6 +126,17 @@ class CongressPersonTest < Test::Unit::TestCase
       end
     end
     
-    
+    context "See if we can find the blog url correctly" do
+      setup do
+        GovSdk.load_apis
+        GovSdk.sunlight_api.key = "4ffa22917ab1ed010a8e681c550c9593"
+        GovSdk.google_api.key = "ABQIAAAAyvWaJgF_91PvBZhITx5FDxRIYAcXj39F4zFQfQ2X3IEFURxvMRRUi0aCG6WofnUSRRoI-Pgytm5yUA"
+        @mycandidate = CongressPerson.fuzzy_find_by_name("Abercombie")
+      end
+      
+      should "N00000308 has a blog" do
+        assert_equal "http://www.house.gov/apps/list/press/hi01_abercrombie/RSS.xml", @mycandidate[0].blog_url
+      end
+    end
   end
 end

data/test/google_api_test.rb

@@ -0,0 +1,62 @@
+require File.dirname(__FILE__) + '/test_helper'
+=begin
+  * Name: google_api_test.rb
+  * Description: Tests for google_api.rb
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+  
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+=end
+require "ruby-debug"
+
+class GoogleApiTest < Test::Unit::TestCase
+  context "brand new API manager" do
+    setup do
+      @apim = GovSdk.load_apis
+    end
+
+    should "not be initialized" do
+      assert_equal false, @apim.initialized?
+    end
+  end
+  
+  context "Google API" do
+    setup do      
+      GovSdk.init(:google => "ABQIAAAAyvWaJgF_91PvBZhITx5FDxRIYAcXj39F4zFQfQ2X3IEFURxvMRRUi0aCG6WofnUSRRoI-Pgytm5yUA")
+      @g_api = GovSdk.google_api
+    end
+
+    should "be initialized once APIkey is set" do
+      assert_equal true,  @g_api.initialized?
+    end
+    
+    should "find feed for salas.com" do
+      assert_equal "http://www.salas.com/feed/", @g_api.lookup_feed_url("http://www.salas.com")
+    end
+    
+    should "not find a feed for google.com" do
+      assert_equal nil, @g_api.lookup_feed_url("http://www.google.com")
+    end
+    
+  end
+end

data/test/{apimanagers_test.rb → open_secrets_api_test.rb}

@@ -1,4 +1,3 @@
-require File.dirname(__FILE__) + '/test_helper'
 =begin
   * Name: GovSDK
   * Description: 
@@ -23,7 +22,9 @@ require File.dirname(__FILE__) + '/test_helper'
   along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
 =end
 
-class TestAPIs < Test::Unit::TestCase
+require File.dirname(__FILE__) + '/test_helper'
+
+class TestOpenSecretsApi < Test::Unit::TestCase
   context "brand new API manager" do
     setup do
       @apim = GenericAPI.new
@@ -34,44 +35,6 @@ class TestAPIs < Test::Unit::TestCase
     end
   end
   
-  context "Sunlight API" do
-    setup do      
-      GovSdk.load_apis
-      GovSdk.sunlight_api.key = "4ffa22917ab1ed010a8e681c550c9593"
-    end
-
-    should "be initialized once APIkey is set" do
-      assert_equal true, GovSdk.sunlight_api.initialized?
-    end
-    
-    should "return no legislator called Pito Salas" do
-      result = GovSdk.sunlight_api.legislators_search("Pito Salas")
-      assert_equal 0, result.length        
-    end
-    
-    should "return a single legislator called Ted Kennedy" do    
-      result = GovSdk.sunlight_api.legislators_search("Ted Kennedy")
-      assert 1, result.length
-    end
-    
-    should "return a single legislator with the nickname ted" do
-      result = GovSdk.sunlight_api.legislators_get(:nickname => "Ted", :lastname => "Kennedy")
-      assert_equal "Ted", result["nickname"]
-    end
-    
-    should "be able to locate crp_id N00000308" do
-      result = GovSdk.sunlight_api.legislators_get(:crp_id => "N00000308")
-    end
-    
-    should "be able to go from name to crp_id and back" do
-      result = GovSdk.sunlight_api.legislators_get(:nickname => "ted", :lastname => "Kennedy")
-      crp_id = result["crp_id"]
-      result = GovSdk.sunlight_api.legislators_get(:crp_id => crp_id)
-      assert_equal "Ted", result["nickname"]
-    end
-
-  end
-  
   context "OpenSecrets API manager" do
     setup do
       GovSdk.load_apis

data/test/opmloco_test.rb

@@ -0,0 +1,53 @@
+require File.dirname(__FILE__) + '/test_helper'
+=begin
+  * Name: GovSDK
+  * Description: 
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+  
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+=end
+include Opmloco
+
+class MyTest < Test::Unit::TestCase
+  context "Test context" do
+    setup do
+      
+    end
+    
+    should "work with minimal opml case" do
+      s = String.new
+      Opml.new("hello", "world").xml.write(s)
+      assert_equal "<?xml version='1.0'?><opml><head><title>hello</title></head><body><outline text='world'/></body></opml>", s
+    end
+
+    should "work with something a little more complicated" do
+      s = String.new
+      opml = Opml.new("BlogBridge Feeds", "Good Stuff", {:namespace => {:namespace => "xmlns:bb", :value => "http://blogbridge.com/ns/2006/opml"}})
+      opml.feeds << Feed.new("Latest News from Congressman Trent Franks Arizona's 2nd District", "rss", "http://www.house.gov/apps/list/press/az02_franks/RSS.xml")
+      opml.feeds << Feed.new("Ellen's Illinois Tenth Congressional District Blog", "rss", "http://ellenofthetenth.blogspot.com/feeds/posts/default")
+      opml.xml.write(s)
+      assert_equal "<?xml version='1.0'?><opml xmlns:bb='http://blogbridge.com/ns/2006/opml'><head><title>BlogBridge Feeds</title></head><body><outline text='Good Stuff'><outline xmlUrl='http://www.house.gov/apps/list/press/az02_franks/RSS.xml' text='Latest News from Congressman Trent Franks Arizona&apos;s 2nd District' type='rss'/><outline xmlUrl='http://ellenofthetenth.blogspot.com/feeds/posts/default' text='Ellen&apos;s Illinois Tenth Congressional District Blog' type='rss'/></outline></body></opml>", s
+    end
+  end
+end

data/test/sunlight_api_test.rb

@@ -0,0 +1,80 @@
+require File.dirname(__FILE__) + '/test_helper'
+=begin
+  * Name: GovSDK
+  * Description: 
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+=end
+
+class SunlightApiTest < Test::Unit::TestCase
+  context "brand new API manager" do
+    setup do
+      @apim = GenericAPI.new
+    end
+
+    should "not be initialized" do
+      assert_equal false, @apim.initialized?
+    end
+  end
+  
+  context "Sunlight API" do
+    setup do      
+      GovSdk.load_apis
+      @slight = GovSdk.sunlight_api
+      @slight.key = "4ffa22917ab1ed010a8e681c550c9593"
+    end
+
+    should "be initialized once APIkey is set" do
+      assert_equal true, @slight.initialized?
+    end
+    
+    should "return no legislator called Pito Salas" do
+      result = @slight.legislators_search("Pito Salas")
+      assert_equal 0, result.length        
+    end
+    
+    should "return a single legislator called Ted Kennedy" do    
+      result = @slight.legislators_search("Ted Kennedy")
+      assert 1, result.length
+    end
+    
+    should "find that there are 2 legislators called Kennedy" do
+      result = @slight.legislators_getlist(:lastname => "Kennedy")
+      pp result
+      assert 2, result.length
+    end
+    
+    should "return a single legislator with the nickname ted" do
+      result = GovSdk.sunlight_api.legislators_get(:nickname => "Ted", :lastname => "Kennedy")
+      assert_equal "Ted", result["nickname"]
+    end
+    
+    should "be able to locate crp_id N00000308" do
+      result = GovSdk.sunlight_api.legislators_get(:crp_id => "N00000308")
+    end
+    
+    should "be able to go from name to crp_id and back" do
+      result = GovSdk.sunlight_api.legislators_get(:nickname => "ted", :lastname => "Kennedy")
+      crp_id = result["crp_id"]
+      result = GovSdk.sunlight_api.legislators_get(:crp_id => crp_id)
+      assert_equal "Ted", result["nickname"]
+    end
+  end
+end

data/test/test_helper.rb

@@ -3,11 +3,21 @@ require 'test/unit'
 require 'shoulda'
 require 'mocha'
 require 'pp'
+require 'httparty'
 
-$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.dirname(__FILE__)+"/../lib")
+$LOAD_PATH.unshift(File.dirname(__FILE__)+"/../lib/apis")
+
+require 'google_api'
 require 'govsdk'
+require 'govsdk_base'
 require 'apimanagers'
-require 'congressperson'
+require 'congress_person'
+require 'generic_api'
+require 'sunlight_api'
+require 'open_secrets_api'
+require 'vote_smart_api'
+require 'opmloco'
 
 class Test::Unit::TestCase
 end

data/test/test_template.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/test_helper'
+=begin
+  * Name: test_template.rb
+  * Description: Template for GovSdk Tests
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+  
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+=end
+
+class MyTest < Test::Unit::TestCase
+  context "Test context" do
+    setup do
+      
+    end
+
+    should "do something" do
+      assert_equal 1,1
+    end
+  end

data/test/vote_smart_api_test.rb

@@ -0,0 +1,61 @@
+require File.dirname(__FILE__) + '/test_helper'
+=begin
+  * Name: GovSDK
+  * Description: 
+  * Author: Pito Salas
+  * Copyright: (c) R. Pito Salas and Associates, Inc.
+  * Date: January 2009
+  * License: GPL
+
+  This file is part of GovSDK.
+
+  GovSDK is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  GovSDK is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with GovSDK.  If not, see <http://www.gnu.org/licenses/>.
+  
+  require "ruby-debug"
+  Debugger.settings[:autolist] = 1 # list nearby lines on stop
+  Debugger.settings[:autoeval] = 1
+  Debugger.start
+=end
+
+class VoteSmartApiTest < Test::Unit::TestCase
+  context "brand new API manager" do
+    setup do
+      @apim = GovSdk.load_apis
+    end
+
+    should "not be initialized" do
+      assert_equal false, @apim.initialized?
+    end
+  end
+  
+  context "VoteSmart API" do
+    setup do      
+      GovSdk.init(:votesmart => "c5056828cffa0be5e095cbd75ce3a663")
+      @vs_api = GovSdk.votesmart_api
+    end
+
+    should "be initialized once APIkey is set" do
+      assert_equal true,  @vs_api.initialized?
+    end
+    
+    should "find no candidates called Kennedy" do
+      assert_equal nil, @vs_api.candidate_fuzzy_find("Kennedy")
+    end
+    
+    should "find more than one officials named Kennedy" do
+      assert 1 <= @vs_api.officials_fuzzy_find("Kennedy").length
+    end
+    
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: pitosalas-govsdk
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Pito Salas
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-01-30 00:00:00 -08:00
+date: 2009-02-13 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
@@ -22,16 +22,28 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- README.textile
 - VERSION.yml
-- lib/apimanagers.rb
+- lib/apis
+- lib/apis/generic_api.rb
+- lib/apis/google_api.rb
+- lib/apis/open_secrets_api.rb
+- lib/apis/sunlight_api.rb
+- lib/apis/vote_smart_api.rb
 - lib/congress_person.rb
 - lib/govsdk.rb
+- lib/govsdk_base.rb
 - lib/govsdkgem.rb
-- lib/template.rb
-- test/apimanagers_test.rb
+- lib/opmloco.rb
 - test/congressperson_test.rb
+- test/google_api_test.rb
 - test/govsdk_test.rb
+- test/open_secrets_api_test.rb
+- test/opmloco_test.rb
+- test/sunlight_api_test.rb
 - test/test_helper.rb
+- test/test_template.rb
+- test/vote_smart_api_test.rb
 has_rdoc: true
 homepage: http://github.com/pitosalas/govsdk
 post_install_message: