Yuri Karaban > WWW-Google-PageRank-0.17 > WWW::Google::PageRank

Download:
WWW-Google-PageRank-0.17.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.17   Source  

NAME ^

WWW::Google::PageRank - Query google pagerank of page

SYNOPSIS ^

 use WWW::Google::PageRank;
 my $pr = WWW::Google::PageRank->new;
 print scalar($pr->get('http://www.yahoo.com/')), "\n";

DESCRIPTION ^

The WWW::Google::PageRank is a class implementing a interface for querying google pagerank.

To use it, you should create WWW::Google::PageRank object and use its method get(), to query page rank of URL.

It uses LWP::UserAgent for making request to Google.

CONSTRUCTOR METHOD ^

$gpr = WWW::Google::PageRank->new(%options);

This method constructs a new WWW::Google::PageRank object and returns it. Key/value pair arguments may be provided to set up the initial state. The following options correspond to attribute methods described below:

   KEY                     DEFAULT
   -----------             --------------------
   agent                   "Mozilla/4.0 (compatible; GoogleToolbar 2.0.111-big; Windows XP 5.1)"
   proxy                   undef
   timeout                 undef
   env_proxy               undef
   host                    "toolbarqueries.google.com"

agent specifies the header 'User-Agent' when querying Google. If the proxy option is passed in, requests will be made through specified poxy. proxy is the host which serve requests from Googlebar.

If the env_proxy option is passed in with a TRUE value, then proxy settings are read from environment variables (see LWP::UserAgent::env_proxy)

QUERY METHOD ^

$pr = $gpr->get('http://www.yahoo.com');

Queries Google for a specified pagerank URL and returns pagerank. If query successfull, integer value from 0 to 10 returned. If query fails for some reason (google unreachable, url does not begin from 'http://', undefined url passed) it return undef.

In list context this function returns list from two elements where first is the result as in scalar context and the second is the HTTP::Response object (returned by LWP::UserAgent::get). This can be usefull for debugging purposes and for querying failure details.

BUGS ^

If you find any, please report ;)

AUTHOR ^

Yuri Karaban <ykar@cpan.org>.

Algorithm of computing checksum taken from mozilla module pagerankstatus http://pagerankstatus.mozdev.org by Stephane Queraud <squeraud@toteme.com>.

Algorithm was modified (15-09-2004) according to new algorithm of computingchecksum in googlebar.

COPYRIGHT ^

Copyright 2004-2006, Yuri Karaban, All Rights Reserved.

You may use, modify, and distribute this package under the same terms as Perl itself.

syntax highlighting: