Add bin/files cat to print a file to stdout

Summary:
Ref T7149. This makes debugging some of this stuff a bit easier by removing the HTTP part in the middle.

Particularly, I anticipate having this stream data chunk-by-chunk in the near future.

Test Plan: Ran `files cat F23`, got output.

Reviewers: btrahan

Reviewed By: btrahan

Subscribers: joshuaspence, epriestley

Maniphest Tasks: T7149

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

src/__phutil_library_map__.php

@@ -1832,6 +1832,7 @@ phutil_register_library_map(array(
     'PhabricatorFilesApplication' => 'applications/files/application/PhabricatorFilesApplication.php',
     'PhabricatorFilesApplicationStorageEnginePanel' => 'applications/files/applicationpanel/PhabricatorFilesApplicationStorageEnginePanel.php',
     'PhabricatorFilesConfigOptions' => 'applications/files/config/PhabricatorFilesConfigOptions.php',
+    'PhabricatorFilesManagementCatWorkflow' => 'applications/files/management/PhabricatorFilesManagementCatWorkflow.php',
     'PhabricatorFilesManagementCompactWorkflow' => 'applications/files/management/PhabricatorFilesManagementCompactWorkflow.php',
     'PhabricatorFilesManagementEnginesWorkflow' => 'applications/files/management/PhabricatorFilesManagementEnginesWorkflow.php',
     'PhabricatorFilesManagementMigrateWorkflow' => 'applications/files/management/PhabricatorFilesManagementMigrateWorkflow.php',
@@ -5138,6 +5139,7 @@ phutil_register_library_map(array(
     'PhabricatorFilesApplication' => 'PhabricatorApplication',
     'PhabricatorFilesApplicationStorageEnginePanel' => 'PhabricatorApplicationConfigurationPanel',
     'PhabricatorFilesConfigOptions' => 'PhabricatorApplicationConfigOptions',
+    'PhabricatorFilesManagementCatWorkflow' => 'PhabricatorFilesManagementWorkflow',
     'PhabricatorFilesManagementCompactWorkflow' => 'PhabricatorFilesManagementWorkflow',
     'PhabricatorFilesManagementEnginesWorkflow' => 'PhabricatorFilesManagementWorkflow',
     'PhabricatorFilesManagementMigrateWorkflow' => 'PhabricatorFilesManagementWorkflow',

src/applications/files/management/PhabricatorFilesManagementCatWorkflow.php

@@ -0,0 +1,39 @@
+<?php
+
+final class PhabricatorFilesManagementCatWorkflow
+  extends PhabricatorFilesManagementWorkflow {
+
+  protected function didConstruct() {
+    $this
+      ->setName('cat')
+      ->setSynopsis(
+        pht('Print the contents of a file.'))
+      ->setArguments(
+        array(
+          array(
+            'name'      => 'names',
+            'wildcard'  => true,
+          ),
+        ));
+  }
+
+  public function execute(PhutilArgumentParser $args) {
+    $console = PhutilConsole::getConsole();
+
+    $names = $args->getArg('names');
+    if (count($names) > 1) {
+      throw new PhutilArgumentUsageException(
+        pht('Specify exactly one file to print, like "F123".'));
+    } else if (!$names) {
+      throw new PhutilArgumentUsageException(
+        pht('Specify a file to print, like "F123".'));
+    }
+
+    $file = head($this->loadFilesWithNames($names));
+
+    echo $file->loadFileData();
+
+    return 0;
+  }
+
+}

src/applications/files/management/PhabricatorFilesManagementWorkflow.php

@@ -15,6 +15,13 @@ abstract class PhabricatorFilesManagementWorkflow
     }
 
     if ($names) {
+      return $this->loadFilesWithNames($names);
+    }
+
+    return null;
+  }
+
+  protected function loadFilesWithNames(array $names) {
     $query = id(new PhabricatorObjectQuery())
       ->setViewer($this->getViewer())
       ->withNames($names)
@@ -33,8 +40,4 @@ abstract class PhabricatorFilesManagementWorkflow
     return array_values($files);
   }
 
-    return null;
-  }
-
-
 }