/ 
CPAN-AuthorsSearch-0.06
/ CPAN::AuthorsSearch

NAME

CPAN::AuthorsSearch - Interface to CPAN module author search.

VERSION

Version 0.06

DESCRIPTION

CPAN::AuthorsSearch is an attempt to provide a programmatical interface to CPAN Search engine. CPAN Search is a search engine for the distributions, modules, docs, and ID's on CPAN. It was conceived and built by Graham Barr as a way to make things easier to navigate. Originally named TUCS [ The Ultimate CPAN Search ] it was later named CPAN Search or Search DOT CPAN.

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.

use strict; use warnings;
use CPAN::AuthorsSearch;
my $search = CPAN::AuthorsSearch->new();
my $result = $search->by_id('MANWAR');

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.

use strict; use warnings;
use CPAN::AuthorsSearch;
my $search = CPAN::AuthorsSearch->new();
my $result = $search->where_id_starts_with('M');

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.

use strict; use warnings;
use CPAN::AuthorsSearch;
my $search = CPAN::AuthorsSearch->new();
my $result = $search->where_name_contains('MAN');

as_string()

Return the last search result in human readable format.

use strict; use warnings;
use CPAN::AuthorsSearch;
my $search = CPAN::AuthorsSearch->new();
my $result = $search->where_name_contains('MAN');
print $search->as_string();

# or simply

print $search;

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.