Improve resolution behaviors of FutureProxy


Improve resolution behaviors of FutureProxy

See PHI1764. See PHI1802. Address two resolution behaviors for FutureProxy:

  • FutureProxy may throw an exception directly from iteration via "FutureIterator" (see PHI1764). This is wrong: futures should throw only when resolved.
  • FutureProxy can not change an exception into a result, or a result into an exception, or an exception into a different exception. Being able to proxy the full range of result and exception behavior is useful, particularly for Conduit (see PHI1802).

Make "FutureProxy" more robust in how it handles exceptions from proxied futures.

Test Plan:
Used this script to raise an exception during result processing:


require_once 'support/init/init-script.php';

final class ThrowingFutureProxy
  extends FutureProxy {

  protected function didReceiveResult($result) {
    throw new Exception('!');


$future = new ImmediateFuture('quack');
$proxy = new ThrowingFutureProxy($future);
$iterator = new FutureIterator(array($proxy));

foreach ($iterator as $resolved) {
  try {
  } catch (Exception $ex) {
    echo "Caught exception properly on resolution.\n";

Before this change, the exception is raised in the foreach() loop. After this change, the exception is raised at resolution time.

Differential Revision: https://secure.phabricator.com/D21383


epriestleyAuthored on Jul 1 2020, 12:06 PM
epriestleyPushed on Jul 1 2020, 1:37 PM
Differential Revision
D21383: Improve resolution behaviors of FutureProxy
rARC98ca5cfa8171: Remove an unused method in "ArcanistUploadWorkflow"
Build Status
Buildable 24725
Build 34099: Run Core Tests