Mohammad S Anwar > CPAN-Search-Author > CPAN::Search::Author

Download:
CPAN-Search-Author-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.03   Source  

NAME ^

CPAN::Search::Author - Interface to search CPAN module author.

VERSION ^

Version 0.03

DESCRIPTION ^

CPAN::Search::Author is an attempt to provide 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::Search::Author;
    my $search = CPAN::Search::Author->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::Search::Author;
    my $search = CPAN::Search::Author->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::Search::Author;
    my $search = CPAN::Search::Author->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::Search::Author;
    my $search = CPAN::Search::Author->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-search-author at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPAN-Search-Author. 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::Search::Author

You can also look for information at:

LICENSE AND COPYRIGHT ^

Copyright 2011-14 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.

syntax highlighting: