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

Copyright 2008 Alexey Alexandrov, all rights reserved.

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