Provide builtin definitions for "Blame Revision" and "Revert Plan" fields

Summary:
This is just to ease transitions for any installs which use these fields (e.g.,
Facebook). I'll write some docs and a migration script once this stuff is a
little more solid, too.

Depends on D800.

Technically these are "better" than the current fields since they show up other
places than the edit screen (derp derp).

Test Plan: Created a field selector which provides these; verified they work by
typing stuff into them and saving the revision.
Reviewed By: jungejason
Reviewers: jungejason, tuomaspelkonen, aran
CC: aran, epriestley, jungejason
Differential Revision: 801

src/__phutil_library_map__.php

@@ -134,6 +134,7 @@ phutil_register_library_map(array(
     'DifferentialAction' => 'applications/differential/constants/action',
     'DifferentialAddCommentView' => 'applications/differential/view/addcomment',
     'DifferentialAuxiliaryField' => 'applications/differential/storage/auxiliaryfield',
+    'DifferentialBlameRevisionFieldSpecification' => 'applications/differential/field/specification/blamerev',
     'DifferentialCCWelcomeMail' => 'applications/differential/mail/ccwelcome',
     'DifferentialChangeType' => 'applications/differential/constants/changetype',
     'DifferentialChangeset' => 'applications/differential/storage/changeset',
@@ -175,6 +176,7 @@ phutil_register_library_map(array(
     'DifferentialNewDiffMail' => 'applications/differential/mail/newdiff',
     'DifferentialPrimaryPaneView' => 'applications/differential/view/primarypane',
     'DifferentialReplyHandler' => 'applications/differential/replyhandler',
+    'DifferentialRevertPlanFieldSpecification' => 'applications/differential/field/specification/revertplan',
     'DifferentialReviewRequestMail' => 'applications/differential/mail/reviewrequest',
     'DifferentialRevision' => 'applications/differential/storage/revision',
     'DifferentialRevisionCommentListView' => 'applications/differential/view/revisioncommentlist',
@@ -773,6 +775,7 @@ phutil_register_library_map(array(
     'DarkConsoleXHProfPlugin' => 'DarkConsolePlugin',
     'DifferentialAddCommentView' => 'AphrontView',
     'DifferentialAuxiliaryField' => 'DifferentialDAO',
+    'DifferentialBlameRevisionFieldSpecification' => 'DifferentialFieldSpecification',
     'DifferentialCCWelcomeMail' => 'DifferentialReviewRequestMail',
     'DifferentialChangeset' => 'DifferentialDAO',
     'DifferentialChangesetDetailView' => 'AphrontView',
@@ -800,6 +803,7 @@ phutil_register_library_map(array(
     'DifferentialNewDiffMail' => 'DifferentialReviewRequestMail',
     'DifferentialPrimaryPaneView' => 'AphrontView',
     'DifferentialReplyHandler' => 'PhabricatorMailReplyHandler',
+    'DifferentialRevertPlanFieldSpecification' => 'DifferentialFieldSpecification',
     'DifferentialReviewRequestMail' => 'DifferentialMail',
     'DifferentialRevision' => 'DifferentialDAO',
     'DifferentialRevisionCommentListView' => 'AphrontView',

src/applications/differential/field/specification/blamerev/DifferentialBlameRevisionFieldSpecification.php

@@ -0,0 +1,73 @@
+<?php
+
+/*
+ * Copyright 2011 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+final class DifferentialBlameRevisionFieldSpecification
+  extends DifferentialFieldSpecification {
+
+  private $value;
+
+  public function getStorageKey() {
+    return 'phabricator:blame-revision';
+  }
+
+  public function getValueForStorage() {
+    return $this->value;
+  }
+
+  public function setValueFromStorage($value) {
+    $this->value = $value;
+    return $this;
+  }
+
+  public function shouldAppearOnEdit() {
+    return true;
+  }
+
+  public function setValueFromRequest(AphrontRequest $request) {
+    $this->value = $request->getStr('aux:phabricator:blame-revision');
+    return $this;
+  }
+
+  public function renderEditControl() {
+    return id(new AphrontFormTextControl())
+      ->setLabel('Blame Revision')
+      ->setCaption('Revision which broke the stuff which this change fixes.')
+      ->setName('aux:phabricator:blame-revision')
+      ->setValue($this->value);
+  }
+
+  public function validateField() {
+    return;
+  }
+
+  public function shouldAppearOnRevisionView() {
+    return true;
+  }
+
+  public function renderLabelForRevisionView() {
+    return 'Blame Revision:';
+  }
+
+  public function renderValueForRevisionView() {
+    if (!$this->value) {
+      return null;
+    }
+    return phutil_escape_html($this->value);
+  }
+
+}

src/applications/differential/field/specification/blamerev/__init__.php

@@ -0,0 +1,16 @@
+<?php
+/**
+ * This file is automatically generated. Lint this module to rebuild it.
+ * @generated
+ */
+
+
+
+phutil_require_module('phabricator', 'applications/differential/field/specification/base');
+phutil_require_module('phabricator', 'view/form/control/text');
+
+phutil_require_module('phutil', 'markup');
+phutil_require_module('phutil', 'utils');
+
+
+phutil_require_source('DifferentialBlameRevisionFieldSpecification.php');

src/applications/differential/field/specification/revertplan/DifferentialRevertPlanFieldSpecification.php

@@ -0,0 +1,73 @@
+<?php
+
+/*
+ * Copyright 2011 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+final class DifferentialRevertPlanFieldSpecification
+  extends DifferentialFieldSpecification {
+
+  private $value;
+
+  public function getStorageKey() {
+    return 'phabricator:revert-plan';
+  }
+
+  public function getValueForStorage() {
+    return $this->value;
+  }
+
+  public function setValueFromStorage($value) {
+    $this->value = $value;
+    return $this;
+  }
+
+  public function shouldAppearOnEdit() {
+    return true;
+  }
+
+  public function setValueFromRequest(AphrontRequest $request) {
+    $this->value = $request->getStr('aux:phabricator:revert-plan');
+    return $this;
+  }
+
+  public function renderEditControl() {
+    return id(new AphrontFormTextAreaControl())
+      ->setLabel('Revert Plan')
+      ->setName('aux:phabricator:revert-plan')
+      ->setCaption('Special steps required to safely revert this change.')
+      ->setValue($this->value);
+  }
+
+  public function validateField() {
+    return;
+  }
+
+  public function shouldAppearOnRevisionView() {
+    return true;
+  }
+
+  public function renderLabelForRevisionView() {
+    return 'Revert Plan:';
+  }
+
+  public function renderValueForRevisionView() {
+    if (!$this->value) {
+      return null;
+    }
+    return phutil_escape_html($this->value);
+  }
+
+}

src/applications/differential/field/specification/revertplan/__init__.php

@@ -0,0 +1,16 @@
+<?php
+/**
+ * This file is automatically generated. Lint this module to rebuild it.
+ * @generated
+ */
+
+
+
+phutil_require_module('phabricator', 'applications/differential/field/specification/base');
+phutil_require_module('phabricator', 'view/form/control/textarea');
+
+phutil_require_module('phutil', 'markup');
+phutil_require_module('phutil', 'utils');
+
+
+phutil_require_source('DifferentialRevertPlanFieldSpecification.php');