Provide 'arc call-conduit' to facilitate script integration with Phabricator

Summary:
Provide a formal mechanism for making conduit calls from other scripts.

Test Plan:
Called 'conduit.ping'.

Reviewed By: jungejason
Reviewers: aran, jungejason, tuomaspelkonen
CC: aran, jungejason
Differential Revision: 239

src/__phutil_library_map__.php

@@ -14,6 +14,7 @@ phutil_register_library_map(array(
     'ArcanistBaseUnitTestEngine' => 'unit/engine/base',
     'ArcanistBaseWorkflow' => 'workflow/base',
     'ArcanistBundle' => 'parser/bundle',
+    'ArcanistCallConduitWorkflow' => 'workflow/call-conduit',
     'ArcanistChooseInvalidRevisionException' => 'exception',
     'ArcanistChooseNoRevisionsException' => 'exception',
     'ArcanistCommitWorkflow' => 'workflow/commit',
@@ -85,6 +86,7 @@ phutil_register_library_map(array(
     'ArcanistAmendWorkflow' => 'ArcanistBaseWorkflow',
     'ArcanistApacheLicenseLinter' => 'ArcanistLicenseLinter',
     'ArcanistApacheLicenseLinterTestCase' => 'ArcanistLinterTestCase',
+    'ArcanistCallConduitWorkflow' => 'ArcanistBaseWorkflow',
     'ArcanistCommitWorkflow' => 'ArcanistBaseWorkflow',
     'ArcanistCoverWorkflow' => 'ArcanistBaseWorkflow',
     'ArcanistDiffParserTestCase' => 'ArcanistPhutilTestCase',

src/workflow/call-conduit/ArcanistCallConduitWorkflow.php

@@ -0,0 +1,87 @@
+<?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.
+ */
+
+/**
+ * Provides command-line access to the Conduit API.
+ *
+ * @group workflow
+ */
+class ArcanistCallConduitWorkflow extends ArcanistBaseWorkflow {
+
+  public function getCommandHelp() {
+    return phutil_console_format(<<<EOTEXT
+      **call-conduit** __method__
+          Supports: http, https
+          Allows you to make a raw Conduit method call. Call parameters are read
+          as a JSON blob from stdin. Results are written to stdout as a JSON
+          blob. This workflow is primarily useful for writing scripts which
+          integrate with Phabricator.
+EOTEXT
+      );
+  }
+
+  public function getArguments() {
+    return array(
+      '*' => 'method',
+    );
+  }
+
+  public function shouldShellComplete() {
+    return false;
+  }
+
+  public function requiresConduit() {
+    return true;
+  }
+
+  public function run() {
+    $method = $this->getArgument('method', array());
+    if (count($method) !== 1) {
+      throw new ArcanistUsageException(
+        "Provide exactly one Conduit method name.");
+    }
+    $method = reset($method);
+
+    $params = @file_get_contents('php://stdin');
+    $params = json_decode($params, true);
+    if (!is_array($params)) {
+      throw new ArcanistUsageException(
+        "Provide method parameters on stdin as a JSON blob.");
+    }
+
+    $error = null;
+    $error_message = null;
+    try {
+      $result = $this->getConduit()->callMethodSynchronous(
+        $method,
+        $params);
+    } catch (ConduitClientException $ex) {
+      $error = $ex->getErrorCode();
+      $error_message = $ex->getMessage();
+      $result = null;
+    }
+
+    echo json_encode(array(
+      'error'         => $error,
+      'errorMessage'  => $error_message,
+      'response'      => $result,
+    ))."\n";
+
+    return 0;
+  }
+}

src/workflow/call-conduit/__init__.php

@@ -0,0 +1,15 @@
+<?php
+/**
+ * This file is automatically generated. Lint this module to rebuild it.
+ * @generated
+ */
+
+
+
+phutil_require_module('arcanist', 'exception/usage');
+phutil_require_module('arcanist', 'workflow/base');
+
+phutil_require_module('phutil', 'console');
+
+
+phutil_require_source('ArcanistCallConduitWorkflow.php');