[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  final class DiffusionLookSoonConduitAPIMethod
   4    extends DiffusionConduitAPIMethod {
   5  
   6    public function getAPIMethodName() {
   7      return 'diffusion.looksoon';
   8    }
   9  
  10    public function getMethodStatus() {
  11      return self::METHOD_STATUS_UNSTABLE;
  12    }
  13  
  14    public function getMethodDescription() {
  15      return pht(
  16        'Advises Phabricator to look for new commits in a repository as soon '.
  17        'as possible. This advice is most useful if you have just pushed new '.
  18        'commits to that repository.');
  19    }
  20  
  21    public function defineReturnType() {
  22      return 'void';
  23    }
  24  
  25    public function defineParamTypes() {
  26      return array(
  27        'callsigns' => 'required list<string>',
  28        'urgency' => 'optional string',
  29      );
  30    }
  31  
  32    public function defineErrorTypes() {
  33      return array();
  34    }
  35  
  36    protected function execute(ConduitAPIRequest $request) {
  37      // NOTE: The "urgency" parameter does nothing, it is just a hilarious joke
  38      // which exemplifies the boundless clever wit of this project.
  39  
  40      $callsigns = $request->getValue('callsigns');
  41      if (!$callsigns) {
  42        return null;
  43      }
  44  
  45      $repositories = id(new PhabricatorRepositoryQuery())
  46        ->setViewer($request->getUser())
  47        ->withCallsigns($callsigns)
  48        ->execute();
  49  
  50      foreach ($repositories as $repository) {
  51        $repository->writeStatusMessage(
  52          PhabricatorRepositoryStatusMessage::TYPE_NEEDS_UPDATE,
  53          PhabricatorRepositoryStatusMessage::CODE_OKAY);
  54      }
  55  
  56      return null;
  57    }
  58  
  59  }