Add a "--dry-run" flag to "bin/repository rebuild-identities"

Summary: Ref T13444. Allow the effects of performing an identity rebuild to be previewed without committing to any changes.

Test Plan: Ran "bin/repository rebuild-identities --all-identities" with and without "--dry-run".

Maniphest Tasks: T13444

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

src/applications/diffusion/identity/DiffusionRepositoryIdentityEngine.php

···
 
   private $viewer;
   private $sourcePHID;
+  private $dryRun;
 
   public function setViewer(PhabricatorUser $viewer) {
     $this->viewer = $viewer;
···
     }
 
     return $this->sourcePHID;
+  }
+
+  public function setDryRun($dry_run) {
+    $this->dryRun = $dry_run;
+    return $this;
+  }
+
+  public function getDryRun() {
+    return $this->dryRun;
   }
 
   public function newResolvedIdentity($raw_identity) {
···
 
     $resolved_phid = $this->resolveIdentity($identity);
 
-    $identity
-      ->setAutomaticGuessedUserPHID($resolved_phid)
-      ->save();
+    $identity->setAutomaticGuessedUserPHID($resolved_phid);
+
+    if ($this->getDryRun()) {
+      $identity->makeEphemeral();
+    } else {
+      $identity->save();
+    }
 
     return $identity;
   }

src/applications/repository/management/PhabricatorRepositoryManagementRebuildIdentitiesWorkflow.php

···
   extends PhabricatorRepositoryManagementWorkflow {
 
   private $identityCache = array();
+  private $phidCache = array();
+  private $dryRun;
 
   protected function didConstruct() {
     $this
···
             'repeat' => true,
             'help' => pht('Rebuild identities for a raw commit string.'),
           ),
+          array(
+            'name' => 'dry-run',
+            'help' => pht('Show changes, but do not make any changes.'),
+          ),
         ));
   }
 
···
     $viewer = $this->getViewer();
 
     $rebuilt_anything = false;
-
 
     $all_repositories = $args->getArg('all-repositories');
     $repositories = $args->getArg('repository');
···
         pht(
           'Flags "--all-identities" and "--raw" are not '.
           'compatible.'));
+    }
+
+    $dry_run = $args->getArg('dry-run');
+    $this->dryRun = $dry_run;
+
+    if ($this->dryRun) {
+      $this->logWarn(
+        pht('DRY RUN'),
+        pht('This is a dry run, so no changes will be written.'));
     }
 
     if ($all_repositories || $repositories) {
···
     $raw_identity) {
 
     if (!isset($this->identityCache[$raw_identity])) {
-      $viewer = $this->getViewer();
-
-      $identity = id(new DiffusionRepositoryIdentityEngine())
-        ->setViewer($viewer)
+      $identity = $this->newIdentityEngine()
         ->setSourcePHID($commit->getPHID())
         ->newResolvedIdentity($raw_identity);
 
···
   }
 
   private function rebuildIdentities($identities) {
-    $viewer = $this->getViewer();
+    $dry_run = $this->dryRun;
 
     foreach ($identities as $identity) {
       $raw_identity = $identity->getIdentityName();
···
       $old_auto = $identity->getAutomaticGuessedUserPHID();
       $old_assign = $identity->getManuallySetUserPHID();
 
-      $identity = id(new DiffusionRepositoryIdentityEngine())
-        ->setViewer($viewer)
+      $identity = $this->newIdentityEngine()
         ->newUpdatedIdentity($identity);
 
       $this->identityCache[$raw_identity] = $identity;
···
           pht('No changes to identity.'));
       } else {
         if (!$same_auto) {
-          $this->logWarn(
-            pht('AUTOMATIC PHID'),
-            pht(
-              'Automatic user updated from "%s" to "%s".',
-              $this->renderPHID($old_auto),
-              $this->renderPHID($new_auto)));
+          if ($dry_run) {
+            $this->logWarn(
+              pht('DETECTED PHID'),
+              pht(
+                '(Dry Run) Would update detected user from "%s" to "%s".',
+                $this->renderPHID($old_auto),
+                $this->renderPHID($new_auto)));
+          } else {
+            $this->logWarn(
+              pht('DETECTED PHID'),
+              pht(
+                'Detected user updated from "%s" to "%s".',
+                $this->renderPHID($old_auto),
+                $this->renderPHID($new_auto)));
+          }
         }
         if (!$same_assign) {
-          $this->logWarn(
-            pht('ASSIGNED PHID'),
-            pht(
-              'Assigned user updated from "%s" to "%s".',
-              $this->renderPHID($old_assign),
-              $this->renderPHID($new_assign)));
+          if ($dry_run) {
+            $this->logWarn(
+              pht('ASSIGNED PHID'),
+              pht(
+                '(Dry Run) Would update assigned user from "%s" to "%s".',
+                $this->renderPHID($old_assign),
+                $this->renderPHID($new_assign)));
+          } else {
+            $this->logWarn(
+              pht('ASSIGNED PHID'),
+              pht(
+                'Assigned user updated from "%s" to "%s".',
+                $this->renderPHID($old_assign),
+                $this->renderPHID($new_assign)));
+          }
         }
       }
     }
···
   private function renderPHID($phid) {
     if ($phid == null) {
       return pht('NULL');
-    } else {
-      return $phid;
     }
+
+    if (!isset($this->phidCache[$phid])) {
+      $viewer = $this->getViewer();
+      $handles = $viewer->loadHandles(array($phid));
+      $this->phidCache[$phid] = pht(
+        '%s <%s>',
+        $handles[$phid]->getFullName(),
+        $phid);
+    }
+
+    return $this->phidCache[$phid];
+  }
+
+  private function newIdentityEngine() {
+    $viewer = $this->getViewer();
+
+    return id(new DiffusionRepositoryIdentityEngine())
+      ->setViewer($viewer)
+      ->setDryRun($this->dryRun);
   }
 
 }