tools.find_run_binary Namespace Reference

Functions
	run_command (args)
	find_path_to_program (program)

Detailed Description

Module that finds and runs a binary by looking in the likely locations.

Function Documentation

find_path_to_program()

tools.find_run_binary.find_path_to_program

(

program

)

Returns path to an existing program binary.

Args:
  program: Basename of the program to find (e.g., 'render_pictures').

Returns:
  Absolute path to the program binary, as a string.

Raises:
  Exception: unable to find the program binary.

Definition at line 36 of file find_run_binary.py.

def find_path_to_program(program):
  """Returns path to an existing program binary.
 
  Args:
    program: Basename of the program to find (e.g., 'render_pictures').
 
  Returns:
    Absolute path to the program binary, as a string.
 
  Raises:
    Exception: unable to find the program binary.
  """
  trunk_path = os.path.abspath(os.path.join(os.path.dirname(__file__),
                                            os.pardir))
  possible_paths = [os.path.join(trunk_path, 'out', 'Release', program),
                    os.path.join(trunk_path, 'out', 'Debug', program),
                    os.path.join(trunk_path, 'out', 'Release',
                                 program + '.exe'),
                    os.path.join(trunk_path, 'out', 'Debug',
                                 program + '.exe')]
  for try_path in possible_paths:
    if os.path.isfile(try_path):
      return try_path
  raise Exception('cannot find %s in paths %s; maybe you need to '
                  'build %s?' % (program, possible_paths, program))
 

run_command()

tools.find_run_binary.run_command

(

args

)

Runs a program from the command line and returns stdout.

Args:
  args: Command line to run, as a list of string parameters. args[0] is the
        binary to run.

Returns:
  stdout from the program, as a single string.

Raises:
  Exception: the program exited with a nonzero return code.

Definition at line 14 of file find_run_binary.py.

def run_command(args):
  """Runs a program from the command line and returns stdout.
 
  Args:
    args: Command line to run, as a list of string parameters. args[0] is the
          binary to run.
 
  Returns:
    stdout from the program, as a single string.
 
  Raises:
    Exception: the program exited with a nonzero return code.
  """
  proc = subprocess.Popen(args,
                          stdout=subprocess.PIPE,
                          stderr=subprocess.PIPE)
  (stdout, stderr) = proc.communicate()
  if proc.returncode is not 0:
    raise Exception('command "%s" failed: %s' % (args, stderr))
  return stdout