Async::MergePoint 0.03

Often in program logic, multiple different steps need to be taken that are independent of each other, but their total result is needed before the next step can be taken. In synchonous code, the usual approach is to do them sequentially.<br /><br />An asynchronous or event-based program could do this, but if each step involves some IO idle time, better overall performance can often be gained by running the steps in parallel. A Async::MergePoint object can then be used to wait for all of the steps to complete, before passing the combined result of each step on to the next stage.<br /><br />A merge point maintains a set of outstanding operations it is waiting on; these are arbitrary string values provided at the object's construction. Each time the done() method is called, the named item is marked as being complete. When all of the required items are so marked, the on_finished continuation is invoked.<br /><br />For use cases where code may be split across several different lexical scopes, it may not be convenient or possible to share a lexical variable, to pass on the result of some asynchronous operation. In these cases, when an item is marked as complete a value can also be provided which contains the results of that step. The on_finished callback is passed a hash (in list form, rather than by reference) of the collected item values.<br /><br />Async::MergePoint is a Perl module that was originally part of the IO::Async distribution, but was removed under the inspiration of Pedro Melo's Async::Hooks distribution, because it doesn't itself contain anything IO-specific.<br /><br />SYNOPSIS<br /><br /> use Async::MergePoint;<br /><br /> my $merge = Async::MergePoint->new(<br /> needs => [ "leaves", "water" ],<br /> );<br /><br /> my $water;<br /> Kettle->boil(<br /> on_boiled => sub { $water = shift; $merge->done( "water" ); }<br /> );<br /><br /> my $tea_leaves;<br /> Cupboard->get_tea_leaves(<br /> on_fetched => sub { $tea_leaves = shift; $merge->done( "leaves" ); }<br /> );<br /><br /> $merge->close(<br /> on_finished => sub {<br /> # Make tea using $water and $tea_leaves<br /> }<br /> );

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Async,  Async Mergepoint,  Asynchronous,  Asyncmergepoint,  Complete,  Distribution,  Finished,  Lexical,  Marked,  Merge,  Mergegtdone,  Mergepoint,  Provided,  Quotleavesquot,  Quotwaterquot,  Result,  Shift,  Steps,  Tea Leaves,  Water
Users rating:	0/10