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" );

     {
        print $_->entry . "\n" foreach ($pj->results);
        redo if $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 Département or Région 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
        Returns the concatenation of the name and the phone number,
        separated by " - ".

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

    Names are sometimes truncated.

    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>

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 Pilpré

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

AUTHOR
    Briac Pilpré briac@cpan.org