NAME

LWP::Protocol::Coro::http - Coro-friendly HTTP and HTTPS backend for LWP

VERSION

Version 1.8.0

SYNOPSIS

    # Make HTTP and HTTPS requests Coro-friendly.
    use LWP::Protocol::Coro::http;

    # Or LWP::Simple, WWW::Mechanize, etc
    use LWP::UserAgent;

    # A reason to want LWP friendly to event loops.
    use Coro qw( async );

    my $ua = LWP::UserAgent->new();
    $ua->protocols_allowed([qw( http https )]);  # Playing it safe.

    for my $url (@urls) {
        async { process( $ua->get($url) ) };
    }

DESCRIPTION

Coro is a cooperating multitasking system. This means it requires some amount of cooperation on the part of user code in order to provide parallelism.

This module makes LWP more cooperative by plugging in an HTTP and HTTPS protocol implementor powered by AnyEvent::HTTP.

All LWP features and configuration options should still be available when using this module.

SEE ALSO

• LWP::Protocol::AnyEvent::http

  An newer implementation of this module that doesn't require Coro. These two modules are developed in parallel.

• Coro

  An excellent cooperative multitasking library assisted by this module.

• AnyEvent::HTTP

  Powers this module.

• LWP::Simple, LWP::UserAgent, WWW::Mechanize

  Affected by this module.

• Coro::LWP

  An alternative to this module for users of Coro. Intrusive, which results in problems in some unrelated code. Doesn't support HTTPS. Supports FTP and NTTP.

• AnyEvent::HTTP::LWP::UserAgent

  An alternative to this module. Doesn't help code that uses LWP::Simple or LWP::UserAgent directly.

BUGS

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

You can also look for information at:

• Search CPAN

  http://search.cpan.org/dist/LWP-Protocol-Coro-http

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=LWP-Protocol-Coro-http

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/LWP-Protocol-Coro-http

• CPAN Ratings

  http://cpanratings.perl.org/d/LWP-Protocol-Coro-http

AUTHORS

Eric Brine, <ikegami@adaelis.com>

Max Maischein, <corion@cpan.org>

Graham Barr, <gbarr@pobox.com>

COPYRIGHT & LICENSE

No rights reserved.

The author has dedicated the work to the Commons by waiving all of his or her rights to the work worldwide under copyright law and all related or neighboring legal rights he or she had in the work, to the extent allowable by law.

Works under CC0 do not require attribution. When citing the work, you should not imply endorsement by the author.