Package distutils :: Module spawn
[hide private]
[frames] | no frames]

Module spawn

distutils.spawn

Provides the 'spawn()' function, a front-end to various platform- specific functions for launching another program in a sub-process. Also provides the 'find_executable()' to search the path for a given executable name.

Functions [hide private]
 
spawn(cmd, search_path=1, verbose=0, dry_run=0)
Run another program, specified as a command list 'cmd', in a new process.
 
_nt_quote_args(args)
Quote command-line arguments for DOS/Windows conventions: just wraps every argument which contains blanks in double quotes, and returns a new argument list.
 
_spawn_nt(cmd, search_path=1, verbose=0, dry_run=0)
 
_spawn_os2(cmd, search_path=1, verbose=0, dry_run=0)
 
_spawn_posix(cmd, search_path=1, verbose=0, dry_run=0)
 
find_executable(executable, path=None)
Try to find 'executable' in the directories listed in 'path' (a string listing directories separated by 'os.pathsep'; defaults to os.environ['PATH']).
Variables [hide private]
  __revision__ = '$Id: spawn.py 37828 2004-11-10 22:23:15Z loewi...

Imports: sys, os, string, DistutilsPlatformError, DistutilsArgError, LibError, DistutilsInternalError, DistutilsSetupError, DistutilsOptionError, DistutilsClassError, DistutilsModuleError, DistutilsFileError, CCompilerError, CompileError, LinkError, DistutilsExecError, DistutilsGetoptError, DistutilsTemplateError, DistutilsError, UnknownFileError, PreprocessError, log


Function Details [hide private]

spawn(cmd, search_path=1, verbose=0, dry_run=0)

 

Run another program, specified as a command list 'cmd', in a new process. 'cmd' is just the argument list for the new process, ie. cmd[0] is the program to run and cmd[1:] are the rest of its arguments. There is no way to run a program with a name different from that of its executable.

If 'search_path' is true (the default), the system's executable search path will be used to find the program; otherwise, cmd[0] must be the exact path to the executable. If 'dry_run' is true, the command will not actually be run.

Raise DistutilsExecError if running the program fails in any way; just return on success.

find_executable(executable, path=None)

 

Try to find 'executable' in the directories listed in 'path' (a string listing directories separated by 'os.pathsep'; defaults to os.environ['PATH']). Returns the complete filename or None if not found.


Variables Details [hide private]

__revision__

Value:
'$Id: spawn.py 37828 2004-11-10 22:23:15Z loewis $'