NAME
Future::Role::Promisify - Chain a Mojo::Promise from a Future
SYNOPSIS
use IO::Async::Loop::Mojo;
use Role::Tiny ();
my $loop = IO::Async::Loop::Mojo->new;
my $future = $loop->timeout_future(after => 5);
Role::Tiny->apply_roles_to_object($future, 'Future::Role::Promisify');
$future->promisify->then(sub { say 'Resolved' })->catch(sub { warn 'Rejected' })->wait;
use Future::Mojo;
use Mojo::IOLoop;
my $loop = Mojo::IOLoop->new;
my $future = Future::Mojo->new($loop);
$loop->timer(1 => sub { $future->done('Success!') });
$future->promisify->then(sub { say @_ })->wait;DESCRIPTION
Future::Role::Promisify provides an interface to chain Mojo::Promise objects from Future objects.
METHODS
Future::Role::Promisify composes the following methods.
promisify
my $promise = $future->promisify;Returns a Mojo::Promise object that will resolve or reject when the Future becomes ready. It will be assigned the Mojo::IOLoop of the Future if it is an instance of Future::Mojo.
If the Future is not immediately ready or an instance of Future::Mojo, it must be an instance of a Future that uses the Mojo::IOLoop singleton, such as an IO::Async::Future from the IO::Async::Loop::Mojo loop. In any other circumstances, the resulting Mojo::Promise may not be able to settle the Future.
If a promise object is passed, it will be used and returned instead of constructing a new Mojo::Promise. It may be an object of any class that has a standard Promises/A+ API (in particular resolve and reject methods), but you are responsible for ensuring that it uses the correct event loop to settle the Future if needed.
$promise = $future->promisify($promise);CAVEATS
Cancelling the preceding Future chain may lead to unspecified behavior.
BUGS
Report any issues on the public bugtracker.
AUTHOR
Dan Book <dbook@cpan.org>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2019 by Dan Book.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)