Jim Smyser > WWW-Search-News-2.05 > WWW::Search::Excite::News

Download:
WWW-Search-News-2.05.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 2.05   Source  

NAME ^

WWW::Search::Excite::News - class for searching ExciteNews

SYNOPSIS ^

use WWW::Search; $query = "Bob Hope"; $search = new WWW::Search('Excite::News'); $search->native_query(WWW::Search::escape_query($query)); $search->maximum_to_retrieve(100); while (my $result = $search->next_result()) {

$url = $result->url; $title = $result->title; $desc = $result->description; $source = $result->source; $date = $result->index_date;

print "<a href=$url>$title</a> $source<br>$date<br>$desc<p>\n"; }

or,

use WWW::Search; $query = "Bob Hope"; $search = new WWW::Search('Excite::News'); $search->native_query(WWW::Search::escape_query($query)); $search->maximum_to_retrieve(100); while (my $result = $search->next_result()) {

$raw = $result->raw;

print "$raw\n"; }

DESCRIPTION ^

Class for searching Excite News http://www.excite.com. Excite has one of the best news bot on the web.

Following results returned for printing are: $result->url url for the news article $result->title title of the article $result->description will return description if any $result->source articles news source $result->index_date articles date or $result->raw for all the html

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 before we do anything. It initializes our private variables (which all begin with underscores) 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 the LWP library to fetch the page specified by {_next_url}. It 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 are done.

AUTHOR ^

Maintained by Jim Smyser <jsmyser@bigfoot.com>

TESTING ^

This module adheres to the WWW::Search test suite mechanism. See $TEST_CASES below.

CHANGES ^

2.04, 2000-06-25

New format changes

2.03, 2000-03-21

New format changes

2.02, 1999-10-5

Misc. formatting changes

2.01, 1999-07-13

New test mechanism

COPYRIGHT ^

The original parts from John Heidemann are subject to following copyright notice:

Copyright (c) 1996-1998 University of Southern California. All rights reserved.

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.

syntax highlighting: