Change dart:io to use Future for one-shot operations.

runtime/bin/process.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
- * [Process] objects are used to start new processes and interact with
- * them.
+ * [Process] is used to start new processes.
  */
-interface Process default _Process {
+class Process {
   /**
-   * Creates a new process object and starts a process running the
-   * [executable] with the specified [arguments]. When the process has
-   * been successfully started [onStart] is called. If the process
-   * fails to start [onError] is called.
+   * Starts a process running the [executable] with the specified
+   * [arguments]. Returns an [InteractiveProcess] object that can be
+   * used to interact with the process.
+   *
+   * An optional [ProcessOptions] object can be passed to specify
+   * options other than the executable and the arguments.
+   */
+  static InteractiveProcess start(String executable,
+                                  List<String> arguments,
+                                  [ProcessOptions options]) {
+    return _Process.start(executable, arguments, options);
+  }
+
+  /**
+   * Starts a process and runs it non-interactively to completion. The
+   * process run is [executable] with the specified [arguments].
    *
    * An optional [ProcessOptions] object can be passed to specify
    * options other than the executable and the arguments.
    *
-   * No data can be written to the process stdin and the process
-   * cannot be closed nor killed before [onStart] has been invoked.
+   * Returns a [:Future<ProcessResult>:] that completes with the
+   * result of running the process, i.e., exit code, standard out and
+   * standard in.
    */
-  Process.start(String executable,
-                List<String> arguments,
-                [ProcessOptions options]);
+  static Future<ProcessResult> run(String executable,
+                                   List<String> arguments,
+                                   [ProcessOptions options]) {
+    return _Process.run(executable, arguments, options);
+  }
+}
 
-  /**
-   * Creates a new process object, starts a process and runs it
-   * non-interactively to completion. The process run is [executable]
-   * with the specified [arguments]. When the process has been
-   * successfully started [onStart] is called. If the process fails to
-   * start [onError] is called.
-   *
-   * Options other than the executable and the arguments are specified
-   * using a [ProcessOptions] object. If no options are required,
-   * [null] can be passed as the options.
-   *
-   * No communication via [stdin], [stdout] or [stderr] can take place
-   * with a non-interactive process. Instead, the process is run to
-   * completion at which point the exit code and stdout and stderr are
-   * supplied to the [callback] parameter.
-   */
-  Process.run(String executable,
-              List<String> arguments,
-              ProcessOptions options,
-              void callback(int exitCode, String stdout, String stderr));
-
+/**
+ * [InteractiveProcess] represents a process which users can
+ * communicate with using streams.
+ *
+ * When the process has been successfully started [onStart] is
+ * called. If the process fails to start [onError] is called.
+ *
+ * No data can be written to the process stdin and the process
+ * cannot be closed nor killed before [onStart] has been invoked.
+ */
+interface InteractiveProcess {
   /**
    * Returns an input stream of the process stdout.
    *
    * Throws an [UnsupportedOperationException] if the process is
    * non-interactive.
    */
   InputStream get stdout();
 
   /**
    * Returns an input stream of the process stderr.
@@ skipping 44 matching lines @@
    * process to free the system resources associated with it. Usually,
    * close should be called in [onExit]. Once a process has been
    * closed it can no longer be killed and [onExit] is detached so the
    * application is not notified of process termination.
    */
   void close();
 }
 
 
 /**
+ * [ProcessResult] represents the result of running a non-interactive
+ * process started with [:Process.run:].
+ */
+interface ProcessResult {
+  /**
+   * Exit code for the process.
+   */
+  int get exitCode();
+
+  /**
+   * Standard output from the process as a string.
+   */
+  String get stdout();
+
+  /**
+   * Standard error from the process as a string.
+   */
+  String get stderr();
+}
+
+
+/**
  * [ProcessOptions] represents the options that can be supplied when
  * starting a process.
  */
 class ProcessOptions {
   /**
    * The working directory from which the process is started.  Note
    * that the change of directory occurs before executing the process
    * on some platforms, which may have impact when using relative
    * paths for the executable and the arguments.
    */
@@ skipping 28 matching lines @@
    * Currently, only ASCII environment variables are supported and
    * errors are likely to occur if an environment variables with
    * code-points outside the ASCII range is passed in.
    */
   Map<String, String> environment;
 }
 
 
 class ProcessException implements Exception {
   const ProcessException([String this.message, int this.errorCode = 0]);
-  String toString() => "ProcessException: $message";
+  String toString() => "ProcessException: $message ($errorCode)";
 
   /**
    * Contains the system message for the process exception if any.
    */
   final String message;
 
   /**
    * Contains the OS error code for the process exception if any.
    */
   final int errorCode;
 }