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)
            
          

SEE ALSO

Future, Future::Mojo, Mojo::Promise::Role::Futurify