/ 
CPAN-AuthorsSearch-0.01
/ CPAN::AuthorsSearch

NAME

CPAN::AuthorsSearch - A very simple module for searching CPAN module authors.

VERSION

Version 0.01

SYNOPSIS

use CPAN::AuthorsSearch;
my $search = CPAN::AuthorsSearch->new();

my $name   = $search->by_id('MANWAR');
# $name should have 'Mohammad S Anwar'

my $list   = $search->where_name_contains('MAN');
# $list should have
# {
#    'umvue'  => 'Yee Man Chan',
#    'lwall'  => 'Larry Wall. Author of Perl. Busy man.',
#    'kinman' => 'Kin man, Cheung'
# }

METHODS

by_id

This method accepts CPAN ID exactly as provided by CPAN. It does realtime search on CPAN site and fetch the author name for the given CPAN ID. However it would croak if it can't access the CPAN site or unable to get any response for the given CPAN ID.

where_id_starts_with

This method accepts an alphabet (A-Z) and get the list of authors that start with the given alphabet from CPAN site realtime. However it would croak if it can't access the CPAN site or unable to get any response for the given CPAN ID.

where_name_contains

This method accepts a search string and look for the string in the author's name of all the CPAN modules realtime and returns the a reference to a hash containing id, name pair containing the search string. It croaks if unable to access the search.cpan.org.

AUTHOR

Mohammad S Anwar, <mohammad.anwar at yahoo.com>

BUGS

Please report any bugs or feature requests to bug-cpan-authorssearch at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPAN-AuthorsSearch. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc CPAN::AuthorsSearch

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2011 Mohammad S Anwar.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

DISCLAIMER

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.