HomePhabricator

Add PhabricatorQueryIterator, for buffered iteration over a…

Description

Add PhabricatorQueryIterator, for buffered iteration over a CursorPagedPolicyAwareQuery

Summary:
See D19446. This should make it easier to process larger, more complex result sets in constant memory.

Today, LiskMigrationIterator takes constant memory but can't apply needX() reqeusts or withY(...) constraints.

Using a raw Query can handle this stuff, but requires memory proportional to the size of the result set.

Offer the best of both worlds: constant memory and full access to the power of Query classes.

Test Plan:
Used this script to iterate over every commit, saw sensible behavior:

list-commits.php
<?php

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

$viewer = PhabricatorUser::getOmnipotentUser();

$query = id(new DiffusionCommitQuery())
  ->setViewer($viewer);

$iterator = new PhabricatorQueryIterator($query);
foreach ($iterator as $commit) {
  echo $commit->getID()."\n";
}

Reviewers: amckinley

Reviewed By: amckinley

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