Allow configuration to have custom UI types

Summary:
Ref T1703. This sets the stage for (but does not yet implement) custom UI types for config. In particular, a draggable list for custom fields.

I might make all the builtin types go through this at some point too, but don't really want to bother for the moment. It would be very slightly cleaner but woudn't get us much of anything.

Test Plan:
UI now renders via custom code, although that code does nothing (produces an unadorned text field):

{F45693}

Reviewers: chad

Reviewed By: chad

CC: aran

Maniphest Tasks: T1703

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

Author: epriestley

src/__phutil_library_map__.php

@@ -894,6 +894,7 @@
     'PhabricatorConfigManagementSetWorkflow' => 'applications/config/management/PhabricatorConfigManagementSetWorkflow.php',
     'PhabricatorConfigManagementWorkflow' => 'applications/config/management/PhabricatorConfigManagementWorkflow.php',
     'PhabricatorConfigOption' => 'applications/config/option/PhabricatorConfigOption.php',
+    'PhabricatorConfigOptionType' => 'applications/config/custom/PhabricatorConfigOptionType.php',
     'PhabricatorConfigProxySource' => 'infrastructure/env/PhabricatorConfigProxySource.php',
     'PhabricatorConfigResponse' => 'applications/config/response/PhabricatorConfigResponse.php',
     'PhabricatorConfigSource' => 'infrastructure/env/PhabricatorConfigSource.php',
@@ -918,6 +919,7 @@
     'PhabricatorCrumbsView' => 'view/layout/PhabricatorCrumbsView.php',
     'PhabricatorCursorPagedPolicyAwareQuery' => 'infrastructure/query/policy/PhabricatorCursorPagedPolicyAwareQuery.php',
     'PhabricatorCustomField' => 'infrastructure/customfield/field/PhabricatorCustomField.php',
+    'PhabricatorCustomFieldConfigOptionType' => 'infrastructure/customfield/config/PhabricatorCustomFieldConfigOptionType.php',
     'PhabricatorCustomFieldDataNotAvailableException' => 'infrastructure/customfield/exception/PhabricatorCustomFieldDataNotAvailableException.php',
     'PhabricatorCustomFieldImplementationIncompleteException' => 'infrastructure/customfield/exception/PhabricatorCustomFieldImplementationIncompleteException.php',
     'PhabricatorCustomFieldIndexStorage' => 'infrastructure/customfield/storage/PhabricatorCustomFieldIndexStorage.php',
@@ -2774,6 +2776,7 @@
     'PhabricatorCrumbView' => 'AphrontView',
     'PhabricatorCrumbsView' => 'AphrontView',
     'PhabricatorCursorPagedPolicyAwareQuery' => 'PhabricatorPolicyAwareQuery',
+    'PhabricatorCustomFieldConfigOptionType' => 'PhabricatorConfigOptionType',
     'PhabricatorCustomFieldDataNotAvailableException' => 'Exception',
     'PhabricatorCustomFieldImplementationIncompleteException' => 'Exception',
     'PhabricatorCustomFieldIndexStorage' => 'PhabricatorLiskDAO',

src/applications/config/controller/PhabricatorConfigEditController.php

@@ -236,67 +236,72 @@ private function readRequest(
       return array($e_value, $errors, $value, $xaction);
     }
 
-    $type = $option->getType();
-    $set_value = null;
-
-    switch ($type) {
-      case 'int':
-        if (preg_match('/^-?[0-9]+$/', trim($value))) {
-          $set_value = (int)$value;
-        } else {
-          $e_value = pht('Invalid');
-          $errors[] = pht('Value must be an integer.');
-        }
-        break;
-      case 'string':
-      case 'enum':
-        $set_value = (string)$value;
-        break;
-      case 'list<string>':
-        $set_value = $request->getStrList('value');
-        break;
-      case 'set':
-        $set_value = array_fill_keys($request->getStrList('value'), true);
-        break;
-      case 'bool':
-        switch ($value) {
-          case 'true':
-            $set_value = true;
-            break;
-          case 'false':
-            $set_value = false;
-            break;
-          default:
+    if ($option->isCustomType()) {
+      $info = $option->getCustomObject()->readRequest($option, $request);
+      list($e_value, $errors, $set_value, $value) = $info;
+    } else {
+      $type = $option->getType();
+      $set_value = null;
+
+      switch ($type) {
+        case 'int':
+          if (preg_match('/^-?[0-9]+$/', trim($value))) {
+            $set_value = (int)$value;
+          } else {
             $e_value = pht('Invalid');
-            $errors[] = pht('Value must be boolean, "true" or "false".');
-            break;
-        }
-        break;
-      case 'class':
-        if (!class_exists($value)) {
-          $e_value = pht('Invalid');
-          $errors[] = pht('Class does not exist.');
-        } else {
-          $base = $option->getBaseClass();
-          if (!is_subclass_of($value, $base)) {
+            $errors[] = pht('Value must be an integer.');
+          }
+          break;
+        case 'string':
+        case 'enum':
+          $set_value = (string)$value;
+          break;
+        case 'list<string>':
+          $set_value = $request->getStrList('value');
+          break;
+        case 'set':
+          $set_value = array_fill_keys($request->getStrList('value'), true);
+          break;
+        case 'bool':
+          switch ($value) {
+            case 'true':
+              $set_value = true;
+              break;
+            case 'false':
+              $set_value = false;
+              break;
+            default:
+              $e_value = pht('Invalid');
+              $errors[] = pht('Value must be boolean, "true" or "false".');
+              break;
+          }
+          break;
+        case 'class':
+          if (!class_exists($value)) {
             $e_value = pht('Invalid');
-            $errors[] = pht('Class is not of valid type.');
+            $errors[] = pht('Class does not exist.');
           } else {
-            $set_value = $value;
+            $base = $option->getBaseClass();
+            if (!is_subclass_of($value, $base)) {
+              $e_value = pht('Invalid');
+              $errors[] = pht('Class is not of valid type.');
+            } else {
+              $set_value = $value;
+            }
           }
-        }
-        break;
-      default:
-        $json = json_decode($value, true);
-        if ($json === null && strtolower($value) != 'null') {
-          $e_value = pht('Invalid');
-          $errors[] = pht(
-            'The given value must be valid JSON. This means, among '.
-            'other things, that you must wrap strings in double-quotes.');
-        } else {
-          $set_value = $json;
-        }
-        break;
+          break;
+        default:
+          $json = json_decode($value, true);
+          if ($json === null && strtolower($value) != 'null') {
+            $e_value = pht('Invalid');
+            $errors[] = pht(
+              'The given value must be valid JSON. This means, among '.
+              'other things, that you must wrap strings in double-quotes.');
+          } else {
+            $set_value = $json;
+          }
+          break;
+      }
     }
 
     if (!$errors) {
@@ -320,22 +325,26 @@ private function getDisplayValue(
       return null;
     }
 
-    $type = $option->getType();
-    $value = $entry->getValue();
-    switch ($type) {
-      case 'int':
-      case 'string':
-      case 'enum':
-      case 'class':
-        return $value;
-      case 'bool':
-        return $value ? 'true' : 'false';
-      case 'list<string>':
-        return implode("\n", nonempty($value, array()));
-      case 'set':
-        return implode("\n", nonempty(array_keys($value), array()));
-      default:
-        return PhabricatorConfigJSON::prettyPrintJSON($value);
+    if ($option->isCustomType()) {
+      return $option->getCustomObject()->getDisplayValue($option, $entry);
+    } else {
+      $type = $option->getType();
+      $value = $entry->getValue();
+      switch ($type) {
+        case 'int':
+        case 'string':
+        case 'enum':
+        case 'class':
+          return $value;
+        case 'bool':
+          return $value ? 'true' : 'false';
+        case 'list<string>':
+          return implode("\n", nonempty($value, array()));
+        case 'set':
+          return implode("\n", nonempty(array_keys($value), array()));
+        default:
+          return PhabricatorConfigJSON::prettyPrintJSON($value);
+      }
     }
   }
 
@@ -344,63 +353,70 @@ private function renderControl(
     $display_value,
     $e_value) {
 
-    $type = $option->getType();
-    switch ($type) {
-      case 'int':
-      case 'string':
-        $control = id(new AphrontFormTextControl());
-        break;
-      case 'bool':
-        $control = id(new AphrontFormSelectControl())
-          ->setOptions(
+    if ($option->isCustomType()) {
+      $control = $option->getCustomObject()->renderControl(
+        $option,
+        $display_value,
+        $e_value);
+    } else {
+      $type = $option->getType();
+      switch ($type) {
+        case 'int':
+        case 'string':
+          $control = id(new AphrontFormTextControl());
+          break;
+        case 'bool':
+          $control = id(new AphrontFormSelectControl())
+            ->setOptions(
+              array(
+                ''      => pht('(Use Default)'),
+                'true'  => idx($option->getBoolOptions(), 0),
+                'false' => idx($option->getBoolOptions(), 1),
+              ));
+          break;
+        case 'enum':
+          $options = array_mergev(
             array(
-              ''      => pht('(Use Default)'),
-              'true'  => idx($option->getBoolOptions(), 0),
-              'false' => idx($option->getBoolOptions(), 1),
+              array('' => pht('(Use Default)')),
+              $option->getEnumOptions(),
             ));
-        break;
-      case 'enum':
-        $options = array_mergev(
-          array(
-            array('' => pht('(Use Default)')),
-            $option->getEnumOptions(),
-          ));
-        $control = id(new AphrontFormSelectControl())
-          ->setOptions($options);
-        break;
-      case 'class':
-        $symbols = id(new PhutilSymbolLoader())
-          ->setType('class')
-          ->setAncestorClass($option->getBaseClass())
-          ->setConcreteOnly(true)
-          ->selectSymbolsWithoutLoading();
-        $names = ipull($symbols, 'name', 'name');
-        asort($names);
-        $names = array(
-          '' => pht('(Use Default)'),
-        ) + $names;
-
-        $control = id(new AphrontFormSelectControl())
-          ->setOptions($names);
-        break;
-      case 'list<string>':
-      case 'set':
-        $control = id(new AphrontFormTextAreaControl())
-          ->setCaption(pht('Separate values with newlines or commas.'));
-        break;
-      default:
-        $control = id(new AphrontFormTextAreaControl())
-          ->setHeight(AphrontFormTextAreaControl::HEIGHT_VERY_TALL)
-          ->setCustomClass('PhabricatorMonospaced')
-          ->setCaption(pht('Enter value in JSON.'));
-        break;
-    }
+          $control = id(new AphrontFormSelectControl())
+            ->setOptions($options);
+          break;
+        case 'class':
+          $symbols = id(new PhutilSymbolLoader())
+            ->setType('class')
+            ->setAncestorClass($option->getBaseClass())
+            ->setConcreteOnly(true)
+            ->selectSymbolsWithoutLoading();
+          $names = ipull($symbols, 'name', 'name');
+          asort($names);
+          $names = array(
+            '' => pht('(Use Default)'),
+          ) + $names;
+
+          $control = id(new AphrontFormSelectControl())
+            ->setOptions($names);
+          break;
+        case 'list<string>':
+        case 'set':
+          $control = id(new AphrontFormTextAreaControl())
+            ->setCaption(pht('Separate values with newlines or commas.'));
+          break;
+        default:
+          $control = id(new AphrontFormTextAreaControl())
+            ->setHeight(AphrontFormTextAreaControl::HEIGHT_VERY_TALL)
+            ->setCustomClass('PhabricatorMonospaced')
+            ->setCaption(pht('Enter value in JSON.'));
+          break;
+      }
 
-    $control
-      ->setLabel(pht('Value'))
-      ->setError($e_value)
-      ->setValue($display_value)
-      ->setName('value');
+      $control
+        ->setLabel(pht('Value'))
+        ->setError($e_value)
+        ->setValue($display_value)
+        ->setName('value');
+    }
 
     if ($option->getLocked()) {
       $control->setDisabled(true);

src/applications/config/custom/PhabricatorConfigOptionType.php

@@ -0,0 +1,39 @@
+<?php
+
+abstract class PhabricatorConfigOptionType {
+
+  public function validateOption(PhabricatorConfigOption $option, $value) {
+    return;
+  }
+
+  public function readRequest(
+    PhabricatorConfigOption $option,
+    AphrontRequest $request) {
+
+    $e_value = null;
+    $errors = array();
+    $storage_value = $request->getStr('value');
+    $display_value = $request->getStr('value');
+
+    return array($e_value, $errors, $storage_value, $display_value);
+  }
+
+  public function getDisplayValue(
+    PhabricatorConfigOption $option,
+    PhabricatorConfigEntry $entry) {
+    return $entry->getValue();
+  }
+
+  public function renderControl(
+    PhabricatorConfigOption $option,
+    $display_value,
+    $e_value) {
+
+    return id(new AphrontFormTextControl())
+      ->setName('value')
+      ->setLabel(pht('Value'))
+      ->setValue($display_value)
+      ->setError($e_value);
+  }
+
+}

src/applications/config/option/PhabricatorApplicationConfigOptions.php

@@ -15,6 +15,10 @@ public function validateOption(PhabricatorConfigOption $option, $value) {
       return;
     }
 
+    if ($option->isCustomType()) {
+      return $option->getCustomObject()->validateOption($option, $value);
+    }
+
     switch ($option->getType()) {
       case 'bool':
         if ($value !== true &&