NAME
WWW::Search::HotBot - class for searching HotBot
SYNOPSIS
use WWW::Search;
my $oSearch = new WWW::Search('HotBot');
my $sQuery = WWW::Search::escape_query("+sushi restaurant +Columbus Ohio");
$oSearch->native_query($sQuery);
while (my $oResult = $oSearch->next_result())
{ print $oResult->url, "\n"; }DESCRIPTION
This class is a HotBot specialization of WWW::Search. It handles making and interpreting HotBot searches http://www.hotbot.com.
This class exports no public interface; all interaction should be done through WWW::Search objects.
SEE ALSO
To make new back-ends, see WWW::Search.
HOW DOES IT WORK?
native_setup_search is called (from WWW::Search::setup_search) before we do anything. It initializes our private variables (which all begin with underscore) and sets up a URL to the first results page in {_next_url}.
native_retrieve_some is called (from WWW::Search::retrieve_some) whenever more hits are needed. It calls WWW::Search::http_request to fetch the page specified by {_next_url}. It then parses this page, appending any search hits it finds to {cache}. If it finds a ``next'' button in the text, it sets {_next_url} to point to the page for the next set of results, otherwise it sets it to undef to indicate we''re done.
CAVEATS
When HotBot reports a "Mirror" URL, WWW::Search::HotBot ignores it.
BUGS
Please tell the author if you find any!
TESTING
This module adheres to the WWW::Search test suite mechanism.
Test cases (results as of 1998-07-27):
'+mrfglbqnx +NoSuchWord' --- no URLs
'"Christie Abbott"' --- 14 URLs on one page
'"Martin Thurn" AND Bible' --- 131 URLs on two pagesAUTHOR
As of 1998-02-02, WWW::Search::HotBot is maintained by Martin Thurn (MartinThurn@iname.com).
WWW::Search::HotBot was originally written by Wm. L. Scheding, based on WWW::Search::AltaVista.
LEGALESE
THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
VERSION HISTORY
If it''s not listed here, then it wasn''t a meaningful nor released revision.
1.21
HotBot changed their output format.
1.20
\n changed to \012 for MacPerl compatibility
1.17
HotBot changed their search script location and output format on 1998-05-21. Also, as many as 6 fields of each SearchResult are now filled in.
1.13
Fixed the maximum_to_retrieve off-by-one problem. Updated test cases.
1.12
HotBot does not do truncation. Therefore, if the query contains truncation characters (i.e. '*' at end of words), they are simply deleted before the query is sent to HotBot.
1.11
Fixed and revamped by Martin Thurn. Sent to John Heidemann (maintainer of WWW::Search) on 1998-02-05 for inclusion in the next release of WWW::Search.