www::indexparser(3pm) [debian man page]

WWW::IndexParser(3pm)					User Contributed Perl Documentation				     WWW::IndexParser(3pm)

NAME

       WWW::IndexParser - Fetch and parse the directory index from a web server

SYNOPSIS

	use WWW::IndexParser;
	my @files = WWW::IndexParser->new(url => 'http://www.example.com/dir/');
	foreach my $entry (@files) {
	  printf "%s %s
", $entry->filename,
	       scalar(localtime($entry->time)||'');
	}

DESCRIPTION

       WWW::IndexParser is a module that uses LWP to fetch a URL from a web server. It then atempts to parse this page as if it were an auto
       generated index page.  It returns an array of WWW::IndexParser::Entry objects, one per entry in the directory index that it has found. Each
       Entry has a set of methods: filename(), time(), size(), and others if supported by the autoindex generated: type() and size_units().

CONSTRUCTOR

       new ( url => $url, timeout => $seconds, proxy => $proxy_url, debug => 1	)
	   When called with a URL to examine, this method does not return an object, but an array of WWW::IndexParser::Entry obects, one per entry
	   in the directory listing that was accessed.

	   The options to this are:

	   url The complete URL of the index to fetch.

	   timeout
	       The timeout for the request to fetch data, default 10 seconds.

	   proxy
	       A proxy server URL, eg, 'http://proxy:3128/'.

	   debug
	       Decide if to print parsing debug information. Set to 0 (the default) to disable, or anything non-false to print. Recommened you use
	       a digit (ie, 1) as this may become a numeric 'level' of debug in the future.

METHODS

       All methods are private in this module. Pass only a URL to the constructor, and it does everything for you itself.

PREREQUISUTES

       This modile depends upon "LWP", "HTML::Parser", "Time::Local".

OSNAMES

       any

BUGS

       Currently only supports Apache, IIS and Tomcat style auto indexes. Send suggestions for new Auto-Indexes to support to the author (along
       with sample HTML)!

AUTHOR

       James Bromberger <james@rcpt.to>

COPYRIGHT

       Copyright (c) 2006 James Bromberger. All rights reserved. All rights reserved. This program is free software; you can redistribute it
       and/or modify it under the same terms as Perl itself.

perl v5.10.0							    2008-06-23						     WWW::IndexParser(3pm)

WWW::Search::Pagesjaunes(3pm)				User Contributed Perl Documentation			     WWW::Search::Pagesjaunes(3pm)

NAME

       WWW::Search::Pagesjaunes - Lookup phones numbers from www.pagesjaunes.fr

SYNOPSIS

	use WWW::Search::Pagesjaunes;

	my $pj = new WWW::Search::Pagesjaunes;
	$pj->find( activite => "Plombier", localite => "Paris" );

	do {
	   print $_->entry . "
" foreach ($pj->results);
	} while $pj->has_more;

DESCRIPTION

       The WWW::Search::Pagesjaunes provides name, phone number and addresses of French telephone subscribers by using the
       <http://www.pagesjaunes.fr> directory.

METHODS

       Two classes are used in this module, a first one (WWW::Search::Pagesjaunes) to do the fetching and parsing, and the second one and a second
       one (WWW::Search::Pagesjaunes::Entry) holding the entry infos.

       Here are the methods for the main WWW::Search::Pagesjaunes module:

       new()
	   The constructor accept an optional LWP::UserAgent as argument, if you want to provide your own.

       find( %request )
	   Here are the values for the %request hash that are understood. They each have two name, the first is the french one and the second is
	   the english one:

	   nom / name
	       Name of the person you're looking for.

	   activite / business
	       Business type of the company you're looking for. Note that if this field is filled, the module searches in the yellow pages.

	   localite / town
	       Name of the town you're searching in.

	   prenom / firstname
	       First name of the person you're looking for. It is not set if you set the 'activite' field.

	   departement / district
	       Name or number of the Departement or Region you're searching in.

       results()
	   Returns an array of WWW::Search::Pagesjaunes::Entry containing the first matches of the query.

       limit($max_number_of_entries)
	   Set the maximum number of entries returned. Default to 50.

       has_more()
	   If the query leads to more than a few results, the field has_more is set. You can then call the results() method again to fetch the
	   datas.

       The WWW::Search::Pagesjaunes::Entry class has six methods:

       new($name, $address, $phone, $fax)
	   Returns a new WWW::Search::Pagesjaunes::Entry.

       name
	   Returns the name of the entry.

       address
	   Returns the address of the entry.

       phone
	   Returns the phone number of the entry.

       is_fax
	   Returns true if the phone number is a fax one, false otherwise. Note that currently, this method always returns 0.

       entry($separator)
	   Returns the concatenation of the name and the phone number, separated by " - ". You can specify your own separator as first argument.

BUGS

       The phone numbers are sometimes not correctly parsed, esp. when one entry has several phone numbers.

       If you found a bug and want to report it or send a patch, you are encouraged to use the CPAN Request Tracker interface:
       https://rt.cpan.org/NoAuth/Dists.html?Queue=WWW-Search-Pagesjaunes <https://rt.cpan.org/NoAuth/Dists.html?Queue=WWW-Search-Pagesjaunes>

COPYRIGHT

       Please read the Publisher information of <http://www.pagesjaunes.fr> available at the following URL:
       <http://www.pagesjaunes.fr/pj.cgi?html=commun/avertissement.html&lang=en>

       WWW::Search::Pagesjaunes is Copyright (C) 2002, Briac Pilpre

       This module is free software; you can redistribute it or modify it under the same terms as Perl itself.

AUTHOR

       Briac Pilpre <briac@cpan.org>

perl v5.12.4							    2011-11-02					     WWW::Search::Pagesjaunes(3pm)