Impose max running time for apptests.

mojo/devtools/common/devtoolslib/shell.py

 # Copyright 2015 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 
 class Shell(object):
   """Represents an abstract Mojo shell."""
 
   def ServeLocalDirectory(self, local_dir_path, port=0,
                           additional_mappings=None):
@@ skipping 26 matching lines @@
   def Run(self, arguments):
     """Runs the shell with given arguments until shell exits, passing the stdout
     mingled with stderr produced by the shell onto the stdout.
 
     Returns:
       Exit code retured by the shell or None if the exit code cannot be
       retrieved.
     """
     raise NotImplementedError()
 
-  def RunAndGetOutput(self, arguments):
+  def RunAndGetOutput(self, arguments, timeout=None):
     """Runs the shell with given arguments until shell exits and returns the
     output.
 
     Args:
       arguments: list of arguments for the shell
+      timeout: maximum running time in seconds, after which the shell will be
+          terminated
 
     Returns:
-      A tuple of (return_code, output). |return_code| is the exit code returned
-      by the shell or None if the exit code cannot be retrieved. |output| is the
-      stdout mingled with the stderr produced by the shell.
+      A tuple of (return_code, output, did_time_out). |return_code| is the exit
+      code returned by the shell or None if the exit code cannot be retrieved.
+      |output| is the stdout mingled with the stderr produced by the shell.
+      |did_time_out| is True iff the shell was terminated because it exceeded
+      the |timeout| and False otherwise.
     """
     raise NotImplementedError()