DiffusionLookSoonConduitAPIMethod.php
2e7f2b735702stable

DiffusionLookSoonConduitAPIMethod.php
View Options

			<?php

			final class DiffusionLookSoonConduitAPIMethod
			extends DiffusionConduitAPIMethod {

			public function getAPIMethodName() {
			return 'diffusion.looksoon';
			}

			public function getMethodStatus() {
			return self::METHOD_STATUS_UNSTABLE;
			}

			public function getMethodDescription() {
			return pht(
			'Advises Phabricator to look for new commits in a repository as soon '.
			'as possible. This advice is most useful if you have just pushed new '.
			'commits to that repository.');
			}

			protected function defineReturnType() {
			return 'void';
			}

			protected function defineParamTypes() {
			return array(
			'callsigns' => 'optional list<string> (deprecated)',
			'repositories' => 'optional list<string>',
			'urgency' => 'optional string',
			);
			}

			protected function execute(ConduitAPIRequest $request) {
			// NOTE: The "urgency" parameter does nothing, it is just a hilarious joke
			// which exemplifies the boundless clever wit of this project.

			$identifiers = $request->getValue('repositories');

			if (!$identifiers) {
			$identifiers = $request->getValue('callsigns');
			}

			if (!$identifiers) {
			return null;
			}

			$repositories = id(new PhabricatorRepositoryQuery())
			->setViewer($request->getUser())
			->withIdentifiers($identifiers)
			->execute();

			foreach ($repositories as $repository) {
			$repository->writeStatusMessage(
			PhabricatorRepositoryStatusMessage::TYPE_NEEDS_UPDATE,
			PhabricatorRepositoryStatusMessage::CODE_OKAY);
			}

			return null;
			}

			}