NAME

WWW::FreeProxy - fetch proxies from free proxy lists

SYNOPSIS

        use WWW::FreeProxy;
        
        fetch_proxies {
                # do whatever you need to do when new proxy is found
                my $proxy = shift;
                print "found new proxy: $proxy\n";
        };

OVERVIEW

When the module is included it searches for all WWW::FreeProxy::* modules in @INC and loads them as plugins. It means that you can add your own plugins as ./WWW/FreeProxy/YourPlugin.pm. After that any calls to fetch_proxies() will go through all loaded plugins and call fetch() from them to get more proxies.

PLUGIN FORMAT

        package WWW::FreeProxy::SamplePlugin;
        
        sub fetch {
                my ($self, $callback) = @_;
                # find some proxies
                &$callback($_) foreach @proxies;
        }

FUNCTIONS

plugins()

Lists all currently loaded plugins.

fetch_proxies(&)

Fetches proxies. In order to save memory proxies are not returned as a list, but are reported through a callback function one by one instead.

AUTHOR

Alexey Alexandrov, "<swined at cpan.org>"

BUGS

Please report any bugs or feature requests to "bug-www-freeproxy at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-FreeProxy>. 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 WWW::FreeProxy

You can also look for information at:

AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/WWW-FreeProxy>
CPAN Ratings
<http://cpanratings.perl.org/d/WWW-FreeProxy>
RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-FreeProxy>
Search CPAN
<http://search.cpan.org/dist/WWW-FreeProxy>

COPYRIGHT & LICENSE

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