Future::HTTP - provide the most appropriate HTTP client with a Future API
my $ua = Future::HTTP->new(); my $res = $ua->http_get('http://www.nethype.de/')->then(sub { my( $body, $data ) = @_; # ... handle the response return $body })->get();
This module is a wrapper combining Future with the API provided by AnyEvent::HTTP. The backend used for the HTTP protocols depends on whether one of the event loops is loaded.
Currently, the following backends are supported:
HTTP::Tiny
HTTP::Tiny::Paranoid
Mojolicious
AnyEvent
IO::Async
Support is planned for LWP::UserAgent and POE but has not materialized yet.
Future::HTTP->new()
my $ua = Future::HTTP->new();
Creates a new instance of the HTTP client.
$ua->is_async()
Returns true if the selected backend is asynchronous, false if it is synchronous.
$ua->http_get($url, %options)
my $res = $ua->http_get('http://example.com/', headers => { 'Accept' => 'text/json', }, )->then(sub { my( $body, $headers ) = @_; # ... handle the response })->get;
Retrieves the URL and returns the body and headers, like the function in AnyEvent::HTTP.
$ua->http_head($url, %options)
my $res = $ua->http_head('http://example.com/', headers => { 'Accept' => 'text/json', }, )->then(sub { my( $body, $headers ) = @_; ... })->get;
Retrieves the header of the URL and returns the headers, like the function in AnyEvent::HTTP.
$ua->http_post($url, $body, %options)
my $res = $ua->http_post('http://example.com/api', '{token:"my_json_token"}', headers => { 'Accept' => 'text/json', }, )->then(sub { my( $body, $headers ) = @_; ... })->get;
Posts the content to the URL and returns the body and headers, like the function in AnyEvent::HTTP.
$ua->http_request($method, $url, %options)
my $res = $ua->http_request('PUT' => 'http://example.com/api', headers => { 'Accept' => 'text/json', }, body => '{token:"my_json_token"}', )->then(sub { my( $body, $headers ) = @_; ... })->get;
Future
AnyEvent::HTTP for the details of the API
The public repository of this module is https://github.com/Corion/future-http.
The public support forum of this module is https://perlmonks.org/.
Please report bugs in this module via the RT CPAN bug queue at https://rt.cpan.org/Public/Dist/Display.html?Name=Future-HTTP or via mail to future-http-Bugs@rt.cpan.org.
Max Maischein corion@cpan.org
corion@cpan.org
Copyright 2016-2023 by Max Maischein corion@cpan.org.
This module is released under the same terms as Perl itself.
To install Future::HTTP, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Future::HTTP
CPAN shell
perl -MCPAN -e shell install Future::HTTP
For more information on module installation, please visit the detailed CPAN module installation guide.