yahoo-search 1.0.0

data/LICENSE

@@ -0,0 +1,27 @@
+Copyright 2006 Eric Hodel, The Robot Co-op.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the names of the authors nor the names of their contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/Manifest.txt

@@ -0,0 +1,9 @@
+LICENSE
+Manifest.txt
+README
+Rakefile
+lib/yahoo/local_search.rb
+lib/yahoo/search.rb
+lib/yahoo/web_search.rb
+test/test_local_search.rb
+test/test_web_search.rb

data/README

@@ -0,0 +1,47 @@
+= yahoo-search
+
+Rubyforge Project:
+
+http://rubyforge.org/projects/rctools/
+
+Documentation:
+
+http://dev.robotcoop.com/Libraries/yahoo-search/
+
+== About
+
+yahoo-search implements version 1 of Yahoo's Web Search service and version 3
+of Yahoo's Local Search Web Service.
+
+== Installing yahoo-search
+
+Just install the gem:
+
+  $ sudo gem install yahoo-search
+
+== Using yahoo-search
+
+First you'll need a Yahoo Application ID.  You can register for one here:
+
+http://api.search.yahoo.com/webservices/register_application
+
+Then you create a Yahoo::Search object and start locating places:
+
+  require 'rubygems'
+  require 'yahoo/web_search'
+  
+  ys = Yahoo::WebSearch.new application_id
+  results, = ys.search 'madonna'
+  results.each do |result|
+    puts "#{result.title} at #{result.url}"
+  end
+
+  require 'rubygems'
+  require 'yahoo/local_search'
+  
+  yls = Yahoo::LocalSearch.new application_id
+  results, = yls.locate 'pizza', 94306, 2
+  results.each do |location|
+    puts "#{location.title} at #{location.address}, #{location.city}"
+  end
+

data/Rakefile

@@ -0,0 +1,73 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+
+$VERBOSE = nil
+
+spec = Gem::Specification.new do |s|
+  s.name = 'yahoo-search'
+  s.version = '1.0.0'
+  s.summary = 'A Ruby Yahoo Search API Implementation'
+  s.description = 'An interface to Yahoo\'s Local Search service.
+
+http://developer.yahoo.com/search/local/V3/localSearch.html'
+
+  s.author = 'Eric Hodel'
+  s.email = 'eric@robotcoop.com'
+
+  s.has_rdoc = true
+  s.files = File.read('Manifest.txt').split($/)
+  s.require_path = 'lib'
+
+  s.add_dependency 'yahoo', '1.0.0'
+end
+
+desc 'Run tests'
+task :default => [ :test ]
+
+Rake::TestTask.new('test') do |t|
+  t.libs << 'test'
+  t.libs << '../yahoo'
+  t.libs << '../yahoo/lib'
+  t.pattern = 'test/test_*.rb'
+  t.verbose = true
+end
+
+desc 'Update Manifest.txt'
+task :update_manifest do
+  sh "find . -type f | sed -e 's%./%%' | egrep -v 'svn|swp|~' | egrep -v '^(doc|pkg)/' | sort > Manifest.txt"
+end
+
+desc 'Generate RDoc'
+Rake::RDocTask.new :rdoc do |rd|
+  rd.rdoc_dir = 'doc'
+  rd.rdoc_files.add 'lib', 'README', 'LICENSE'
+  rd.main = 'README'
+  rd.options << '-d' if `which dot` =~ /\/dot/
+  rd.options << '-t Yahoo Search Web Services'
+end
+
+desc 'Generate RDoc for dev.robotcoop.com'
+Rake::RDocTask.new :dev_rdoc do |rd|
+  rd.rdoc_dir = '../../../www/trunk/dev/html/Libraries/yahoo-search'
+  rd.rdoc_files.add 'lib', 'README', 'LICENSE'
+  rd.main = 'README'
+  rd.options << '-d' if `which dot` =~ /\/dot/
+  rd.options << '-t Yahoo Search Web Services'
+end
+
+desc 'Build Gem'
+Rake::GemPackageTask.new spec do |pkg|
+  pkg.need_tar = true
+end
+
+desc 'Clean up'
+task :clean => [ :clobber_rdoc, :clobber_package ]
+
+desc 'Clean up'
+task :clobber => [ :clean ]
+
+# vim: syntax=Ruby
+

data/lib/yahoo/local_search.rb

@@ -0,0 +1,147 @@
+require 'yahoo/search'
+
+##
+# Yahoo local search API.
+#
+# http://developer.yahoo.com/search/local/V3/localSearch.html
+
+class Yahoo::LocalSearch < Yahoo::Search
+
+  ##
+  # Local search result struct.
+
+  Result = Struct.new :id, :title, :address, :city, :state, :phone,
+                      :latitude, :longitude,
+
+                      :average_rating, :total_ratings, :total_reviews,
+                      :last_review_date, :last_review_intro,
+
+                      :distance,
+
+                      :url, :click_url, :map_url, :business_url,
+                      :business_click_url,
+
+                      :categories
+
+  def initialize(*args) # :nodoc:
+    @host = 'api.local.yahoo.com'
+    @service_name = 'LocalSearchService'
+    @version = 'V3'
+    @method = 'localSearch'
+    super
+  end
+
+  ##
+  # Search for +query+ at +location+ and return up to +results+ items.
+  #
+  # If +results+ is omitted then ten results are returned.
+  #
+  # +query+ is the location you are searching for.
+  #
+  # +location+ can be any of
+  # * city, state
+  # * city, state, zip
+  # * zip
+  # * street, city, state
+  # * street, city, state, zip
+  # * street, zip
+  #
+  # locate returns five items, an Array of search results, a URI for a webpage
+  # with a map of the search results, the total number of results available,
+  # the number of results returned and the position of the first result in the
+  # overall search (one based).
+
+  def locate(query, location, results = nil)
+    params = { :query => query, :location => location }
+    params[:results] = results unless results.nil?
+    get params
+  end
+
+  def parse_response(xml) # :nodoc:
+    search_results = []
+
+    result_set_map_url = URI.parse xml.elements['ResultSet/ResultSetMapUrl'].text
+    total_results_available, total_results_returned, first_result_position =
+      parse_result_info xml
+
+    xml.elements['ResultSet'].each do |r|
+      next unless r.name == 'Result'
+      sr = Result.new
+
+      sr.id        = r.attributes['id'].to_i
+      sr.title     = r.elements['Title'].text
+      sr.address   = r.elements['Address'].text
+      sr.city      = r.elements['City'].text
+      sr.state     = r.elements['State'].text
+      sr.phone     = r.elements['Phone'].text
+      sr.latitude  = r.elements['Latitude'].text.to_f
+      sr.longitude = r.elements['Longitude'].text.to_f
+
+      rating = r.elements['Rating']
+      sr.average_rating    = rating.elements['AverageRating'].text.to_f
+      sr.total_ratings     = rating.elements['TotalRatings'].text.to_i
+      sr.total_reviews     = rating.elements['TotalReviews'].text.to_i
+      sr.last_review_date  = Time.at rating.elements['LastReviewDate'].text.to_i
+      sr.last_review_intro = rating.elements['LastReviewIntro'].text
+
+      sr.distance           = r.elements['Distance'].text.to_f
+      sr.url                = URI.parse r.elements['Url'].text
+      sr.click_url          = URI.parse r.elements['ClickUrl'].text
+      sr.map_url            = URI.parse r.elements['MapUrl'].text
+      sr.business_url       = URI.parse r.elements['BusinessUrl'].text
+      sr.business_click_url = URI.parse r.elements['BusinessClickUrl'].text
+
+      sr.categories = {}
+      r.elements['Categories'].each do |c|
+        sr.categories[c.text] = c.attributes['id'].to_i
+      end
+
+      search_results << sr
+    end
+
+    return search_results, result_set_map_url, total_results_available,
+           total_results_returned, first_result_position
+  end
+
+end
+
+##
+# A Result contains the following fields:
+#
+# +id+:: The id of this result.
+# +title+:: The name of the result
+# +address+:: Street address of the result
+# +city+:: City in which the result is located
+# +state+:: State in which the result is located
+# +phone+:: Phone number, if known
+# +latitude+:: Latitude of the location
+# +longitude+:: Longitude of the location
+# +average_rating+:: Average score of end-user ratings for the business or
+#                    service
+# +total_ratings+:: Total number of ratings submitted for the business or
+#                   service
+# +total_reviews+:: Total number of ratings submitted for the business or
+#                   service
+# +last_review_date+:: Time of the last review submitted for the business or
+#                      service
+# +last_review_intro+:: The first few words of the last review submitted for
+#                       the business or service
+# +distance+:: Distance from the search location to this business or service
+# +url+:: URL to the detailed page for a business
+# +click_url+:: URL for linking to the detailed page for a business
+# +map_url+:: URL for a map of the address
+# +business_url+:: URL of the businesses website, if known
+# +business_click_url+:: URL for linking to the businesses website, if known
+# +categories+:: Hash of category names and category ids for this result
+
+class Yahoo::LocalSearch::Result
+
+  ##
+  # Returns an Array with latitude and longitude.
+
+  def coordinates
+    return [latitude, longitude]
+  end
+
+end
+

data/lib/yahoo/search.rb

@@ -0,0 +1,23 @@
+require 'yahoo'
+
+##
+# Abstract class for searching yahoo.
+
+class Yahoo::Search < Yahoo
+
+  ##
+  # Returns the total results available, returned, and first result position
+  # for the returned results.
+
+  def parse_result_info(xml) # :nodoc:
+    rs = xml.elements['ResultSet']
+    total_results_available = rs.attributes['totalResultsAvailable'].to_i
+    total_results_returned  = rs.attributes['totalResultsReturned'].to_i
+    first_result_position   = rs.attributes['firstResultPosition'].to_i
+
+    return total_results_available, total_results_returned,
+           first_result_position
+  end
+
+end
+

data/lib/yahoo/web_search.rb

@@ -0,0 +1,75 @@
+require 'yahoo/search'
+
+##
+# Yahoo Web Search API
+#
+# http://developer.yahoo.com/search/web/V1/webSearch.html
+
+class Yahoo::WebSearch < Yahoo::Search
+
+  Result = Struct.new :title, :summary, :url, :click_url, :mime_type,
+                      :modification_date, :cache_url, :cache_size
+
+  def initialize(*args) # :nodoc:
+    @host = 'api.search.yahoo.com'
+    @service_name = 'WebSearchService'
+    @version = 'V1'
+    @method = 'webSearch'
+    super
+  end
+
+  ##
+  # Searches the web for +query+ and returns up to +results+ items.
+  #
+  # If +results+ is omitted then ten results are returned.
+  #
+  # For details on constructing +query+, see:
+  # http://help.yahoo.com/help/us/ysearch/tips/tips-04.html
+
+  def search(query, results = nil)
+    params = { :query => query }
+    params[:results] = results unless results.nil?
+    get params
+  end
+
+  def parse_response(xml) # :nodoc:
+    search_results = []
+
+    total_results_available, total_results_returned, first_result_position =
+      parse_result_info xml
+
+    xml.elements['ResultSet'].each do |r|
+      next if REXML::Text === r
+      result = Result.new
+
+      result.title             = r.elements['Title'].text
+      result.summary           = r.elements['Summary'].text
+      result.url               = URI.parse r.elements['Url'].text
+      result.click_url         = URI.parse r.elements['ClickUrl'].text
+      result.mime_type         = r.elements['MimeType'].text
+      result.modification_date = Time.at r.elements['ModificationDate'].text.to_i
+      result.cache_url         = URI.parse r.elements['Cache/Url'].text
+      result.cache_size        = r.elements['Cache/Size'].text.to_i
+
+      search_results << result
+    end
+
+    return search_results, total_results_available, total_results_returned,
+           first_result_position
+  end
+
+end
+
+##
+# A Result contains the following fields:
+#
+# +title+:: the title of the web page
+# +summary+:: summary text associated with the web page
+# +url+:: URL for the web page
+# +click_url+:: URL for linking to the page
+# +mime_type+:: MIME type of the page
+# +modification_date+:: Time the page was last modified
+# +cache_url+:: URL of the cached result
+# +cache_size+:: size of the cached result in bytes
+
+class Yahoo::WebSearch::Result; end

data/test/test_local_search.rb

@@ -0,0 +1,74 @@
+require 'test/unit'
+require 'test/uri_stub'
+require 'yahoo/local_search'
+
+class Yahoo::TestLocalSearch < Test::Unit::TestCase
+
+  def setup
+    URI::HTTP.responses = []
+    URI::HTTP.uris = []
+
+    @s = Yahoo::LocalSearch.new 'APP_ID'
+  end
+
+  def test_search
+    URI::HTTP.responses << <<-EOF.strip
+<?xml version="1.0"?>
+<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:lcl" xsi:schemaLocation="urn:yahoo:lcl http://api.local.yahoo.com/LocalSearchService/V3/LocalSearchResponse.xsd" totalResultsAvailable="431" totalResultsReturned="2" firstResultPosition="1"><ResultSetMapUrl>http://local.yahoo.com/mapview?stx=pizza&amp;csz=Palo+Alto%2C+CA+94306&amp;city=Palo+Alto&amp;state=CA&amp;radius=15&amp;ed=BVD56a131DxIV6V7_5O_wO8KQY1.bxtOAd8qew--</ResultSetMapUrl><Result id="21395990"><Title>Round Table Pizza Palo Alto</Title><Address>3407 Alma St</Address><City>Palo Alto</City><State>CA</State><Phone>(650) 494-2928</Phone><Latitude>37.419862</Latitude><Longitude>-122.126129</Longitude><Rating><AverageRating>NaN</AverageRating><TotalRatings>0</TotalRatings><TotalReviews>0</TotalReviews><LastReviewDate>0</LastReviewDate><LastReviewIntro></LastReviewIntro></Rating><Distance>0.19</Distance><Url>http://local.yahoo.com/details?id=21395990&amp;stx=pizza&amp;csz=Palo+Alto+CA&amp;ed=OtVQW6160SwBXrynJIx8rirX3iaOtFHwFBC480.oEQVLaK1tM9x1WN.BrJASDzg2asPklg--</Url><ClickUrl>http://local.yahoo.com/details?id=21395990&amp;stx=pizza&amp;csz=Palo+Alto+CA&amp;ed=OtVQW6160SwBXrynJIx8rirX3iaOtFHwFBC480.oEQVLaK1tM9x1WN.BrJASDzg2asPklg--</ClickUrl><MapUrl>http://maps.yahoo.com/maps_result?name=Round+Table+Pizza+Palo+Alto&amp;desc=6504942928&amp;csz=Palo+Alto+CA&amp;qty=9&amp;cs=9&amp;ed=OtVQW6160SwBXrynJIx8rirX3iaOtFHwFBC480.oEQVLaK1tM9x1WN.BrJASDzg2asPklg--&amp;gid1=21395990</MapUrl><BusinessUrl>http://www.roundtablepizza.com/</BusinessUrl><BusinessClickUrl>http://www.roundtablepizza.com/</BusinessClickUrl><Categories><Category id="96926243">Pizza</Category><Category id="96926236">Restaurants</Category></Categories></Result><Result id="21395062"><Title>Papa Murphys Pizza Take &amp; Bake</Title><Address>2730 Middlefield Rd</Address><City>Palo Alto</City><State>CA</State><Phone>(650) 328-5200</Phone><Latitude>37.433243</Latitude><Longitude>-122.129291</Longitude><Rating><AverageRating>4</AverageRating><TotalRatings>8</TotalRatings><TotalReviews>5</TotalReviews><LastReviewDate>1140036645</LastReviewDate><LastReviewIntro>Great place to have pizza with the family.</LastReviewIntro></Rating><Distance>0.99</Distance><Url>http://local.yahoo.com/details?id=21395062&amp;stx=pizza&amp;csz=Palo+Alto+CA&amp;ed=0runZK160SyuzGmb4f1aQLs1KJTXAH56bJ_0HffsK.rhcWN62yU_7KJzff4AZ8TX2LILpT.nu6KJiQQ-</Url><ClickUrl>http://local.yahoo.com/details?id=21395062&amp;stx=pizza&amp;csz=Palo+Alto+CA&amp;ed=0runZK160SyuzGmb4f1aQLs1KJTXAH56bJ_0HffsK.rhcWN62yU_7KJzff4AZ8TX2LILpT.nu6KJiQQ-</ClickUrl><MapUrl>http://maps.yahoo.com/maps_result?name=Papa+Murphys+Pizza+Take+%26amp%3B+Bake&amp;desc=6503285200&amp;csz=Palo+Alto+CA&amp;qty=9&amp;cs=9&amp;ed=0runZK160SyuzGmb4f1aQLs1KJTXAH56bJ_0HffsK.rhcWN62yU_7KJzff4AZ8TX2LILpT.nu6KJiQQ-&amp;gid1=21395062</MapUrl><BusinessUrl>http://www.papamurphys.com/</BusinessUrl><BusinessClickUrl>http://www.papamurphys.com/</BusinessClickUrl><Categories><Category id="96926242">Fast Food</Category><Category id="96926234">Carry Out &amp; Take Out</Category><Category id="96926243">Pizza</Category><Category id="96926236">Restaurants</Category></Categories></Result></ResultSet>
+<!-- ws02.search.scd.yahoo.com compressed/chunked Fri Jun  9 10:53:31 PDT 2006 -->
+    EOF
+
+    results, map_url, avail, returned, position = @s.locate('pizza', 94306, 2)
+
+    assert_equal 'http://local.yahoo.com/mapview?stx=pizza&csz=Palo+Alto%2C+CA+94306&city=Palo+Alto&state=CA&radius=15&ed=BVD56a131DxIV6V7_5O_wO8KQY1.bxtOAd8qew--',
+                 map_url.to_s
+    assert_equal 431, avail
+    assert_equal 2, returned
+    assert_equal 1, position
+
+    assert_equal 2, results.length
+
+    result = results.first
+    assert_equal 21395990, result.id
+    assert_equal 'Round Table Pizza Palo Alto', result.title
+    assert_equal '3407 Alma St', result.address
+    assert_equal 'Palo Alto', result.city
+    assert_equal 'CA', result.state
+    assert_equal '(650) 494-2928', result.phone
+    assert_equal 37.419862, result.latitude
+    assert_equal -122.126129, result.longitude
+    assert_equal [37.419862, -122.126129], result.coordinates
+
+    assert_equal 0.19, result.distance
+
+    categories = { 'Pizza' => 96926243, 'Restaurants' => 96926236 }
+
+    assert_equal categories, result.categories
+
+    assert_equal 'http://local.yahoo.com/details?id=21395990&stx=pizza&csz=Palo+Alto+CA&ed=OtVQW6160SwBXrynJIx8rirX3iaOtFHwFBC480.oEQVLaK1tM9x1WN.BrJASDzg2asPklg--',
+                 result.url.to_s
+    assert_equal 'http://local.yahoo.com/details?id=21395990&stx=pizza&csz=Palo+Alto+CA&ed=OtVQW6160SwBXrynJIx8rirX3iaOtFHwFBC480.oEQVLaK1tM9x1WN.BrJASDzg2asPklg--',
+                 result.click_url.to_s
+    assert_equal 'http://maps.yahoo.com/maps_result?name=Round+Table+Pizza+Palo+Alto&desc=6504942928&csz=Palo+Alto+CA&qty=9&cs=9&ed=OtVQW6160SwBXrynJIx8rirX3iaOtFHwFBC480.oEQVLaK1tM9x1WN.BrJASDzg2asPklg--&gid1=21395990',
+                 result.map_url.to_s
+    assert_equal 'http://www.roundtablepizza.com/',
+                 result.business_url.to_s
+    assert_equal 'http://www.roundtablepizza.com/',
+                 result.business_click_url.to_s
+
+    result = results.last
+    assert_equal 4.0, result.average_rating
+    assert_equal 8, result.total_ratings
+    assert_equal 5, result.total_reviews
+    assert_equal Time.at(1140036645), result.last_review_date
+    assert_equal 'Great place to have pizza with the family.',
+                 result.last_review_intro
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://api.local.yahoo.com/LocalSearchService/V3/localSearch?appid=APP_ID&location=94306&output=xml&query=pizza&results=2',
+                 URI::HTTP.uris.first
+  end
+
+end
+

data/test/test_web_search.rb

@@ -0,0 +1,57 @@
+require 'test/unit'
+require 'test/uri_stub'
+require 'yahoo/web_search'
+
+class Yahoo::TestWebSearch < Test::Unit::TestCase
+
+  def setup
+    URI::HTTP.responses = []
+    URI::HTTP.uris = []
+
+    @s = Yahoo::WebSearch.new 'APP_ID'
+  end
+
+  def test_search
+    URI::HTTP.responses << <<-EOF.strip
+<?xml version="1.0" encoding="UTF-8"?>
+<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:srch" xsi:schemaLocation="urn:yahoo:srch http://api.search.yahoo.com/WebSearchService/V1/WebSearchResponse.xsd" totalResultsAvailable="32900000" totalResultsReturned="2" firstResultPosition="1">
+<Result><Title>Madonna</Title><Summary>Official site of pop diva Madonna, with news, music, media, and fan club.</Summary><Url>http://www.madonna.com/</Url><ClickUrl>http://uk.wrs.yahoo.com/_ylt=A0Je5VwxLIpEF60ArETdmMwF;_ylu=X3oDMTB2cXVjNTM5BGNvbG8DdwRsA1dTMQRwb3MDMQRzZWMDc3IEdnRpZAM-/SIG=11bs38c7g/EXP=1149992369/**http%3a//www.madonna.com/</ClickUrl><ModificationDate>1145602800</ModificationDate><MimeType>text/html</MimeType>
+<Cache><Url>http://uk.wrs.yahoo.com/_ylt=A0Je5VwxLIpEF60AskTdmMwF;_ylu=X3oDMTBwOHA5a2tvBGNvbG8DdwRwb3MDMQRzZWMDc3IEdnRpZAM-/SIG=15igoccah/EXP=1149992369/**http%3a//66.218.69.11/search/cache%3fei=UTF-8%26appid=APP_ID%26query=madonna%26results=2%26u=www.madonna.com/%26w=madonna%26d=BCcdDDmtM3M7%26icp=1%26.intl=us</Url><Size>17777</Size></Cache>
+</Result>
+
+<Result><Title>Madonnalicious</Title><Summary>Pictures, articles, downloads, concert info, news, and more about Madonna.</Summary><Url>http://www.madonnalicious.com/</Url><ClickUrl>http://uk.wrs.yahoo.com/_ylt=A0Je5VwxLIpEF60AtETdmMwF;_ylu=X3oDMTB2ZjQ4dDExBGNvbG8DdwRsA1dTMQRwb3MDMgRzZWMDc3IEdnRpZAM-/SIG=11injilpr/EXP=1149992369/**http%3a//www.madonnalicious.com/</ClickUrl><ModificationDate>1149750000</ModificationDate><MimeType>text/html</MimeType>
+<Cache><Url>http://uk.wrs.yahoo.com/_ylt=A0Je5VwxLIpEF60AukTdmMwF;_ylu=X3oDMTBwZG5hOWwzBGNvbG8DdwRwb3MDMgRzZWMDc3IEdnRpZAM-/SIG=15pmktjmj/EXP=1149992369/**http%3a//66.218.69.11/search/cache%3fei=UTF-8%26appid=APP_ID%26query=madonna%26results=2%26u=www.madonnalicious.com/%26w=madonna%26d=SuWzgDmtM6lL%26icp=1%26.intl=us</Url><Size>202503</Size></Cache>
+</Result>
+</ResultSet>
+<!-- ws02.search.scd.yahoo.com compressed/chunked Fri Jun  9 19:19:28 PDT 2006 -->
+    EOF
+
+    results, avail, returned, position = @s.search 'madonna', 2
+
+    assert_equal 32900000, avail
+    assert_equal 2, returned
+    assert_equal 1, position
+
+    assert_equal 2, results.length
+
+    result = results.first
+    assert_equal 'Madonna', result.title
+    assert_equal 'Official site of pop diva Madonna, with news, music, media, and fan club.',
+                 result.summary
+    assert_equal 'http://www.madonna.com/', result.url.to_s
+    assert_equal 'http://uk.wrs.yahoo.com/_ylt=A0Je5VwxLIpEF60ArETdmMwF;_ylu=X3oDMTB2cXVjNTM5BGNvbG8DdwRsA1dTMQRwb3MDMQRzZWMDc3IEdnRpZAM-/SIG=11bs38c7g/EXP=1149992369/**http%3a//www.madonna.com/', 
+                 result.click_url.to_s
+    assert_equal 'text/html', result.mime_type
+    assert_equal Time.at(1145602800), result.modification_date
+    assert_equal 'http://uk.wrs.yahoo.com/_ylt=A0Je5VwxLIpEF60AskTdmMwF;_ylu=X3oDMTBwOHA5a2tvBGNvbG8DdwRwb3MDMQRzZWMDc3IEdnRpZAM-/SIG=15igoccah/EXP=1149992369/**http%3a//66.218.69.11/search/cache%3fei=UTF-8%26appid=APP_ID%26query=madonna%26results=2%26u=www.madonna.com/%26w=madonna%26d=BCcdDDmtM3M7%26icp=1%26.intl=us',
+                 result.cache_url.to_s
+    assert_equal 17777, result.cache_size
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://api.search.yahoo.com/WebSearchService/V1/webSearch?appid=APP_ID&output=xml&query=madonna&results=2',
+                 URI::HTTP.uris.first
+  end
+
+end
+

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11.15
+specification_version: 1
+name: yahoo-search
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2006-06-10 00:00:00 -07:00
+summary: A Ruby Yahoo Search API Implementation
+require_paths: 
+- lib
+email: eric@robotcoop.com
+homepage: 
+rubyforge_project: 
+description: An interface to Yahoo's Local Search service.  http://developer.yahoo.com/search/local/V3/localSearch.html
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Eric Hodel
+files: 
+- LICENSE
+- Manifest.txt
+- README
+- Rakefile
+- lib/yahoo/local_search.rb
+- lib/yahoo/search.rb
+- lib/yahoo/web_search.rb
+- test/test_local_search.rb
+- test/test_web_search.rb
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yahoo
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+    version: