twisted.internet.utils : API documentation

Function	getProcessOutput	Spawn a process and return its output as a deferred returning a `bytes`.
Function	getProcessValue	Spawn a process and return its exit code as a Deferred.
Function	getProcessOutputAndValue	No summary
Function	runWithWarningsSuppressed	Run the function `f`, but with some warnings suppressed.
Function	suppressWarnings	Wrap `f` in a callable which suppresses the indicated warnings before invoking `f` and unsuppresses them afterwards. If f returns a Deferred, warnings will remain suppressed until the Deferred fires.
Function	_callProtocolWithDeferred	Undocumented
Class	_UnexpectedErrorOutput	Standard error data was received where it was not expected. This is a subclass of `IOError` to preserve backward compatibility with the previous error behavior of `getProcessOutput`.
Class	_BackRelay	Trivial protocol for communicating with a process and turning its output into the result of a `Deferred`.
Class	_ValueGetter	Undocumented
Class	_EverythingGetter	Undocumented
Function	_resetWarningFilters	Undocumented

def _callProtocolWithDeferred(protocol, executable, args, env, path, reactor=None, protoArgs=()): (source)

Undocumented

def getProcessOutput(executable, args=(), env={}, path=None, reactor=None, errortoo=0): (source)

Spawn a process and return its output as a deferred returning a bytes.

Parameters	executable	The file name to run and get the output of - the full path should be used.
	args	the command line arguments to pass to the process; a sequence of strings. The first string should NOT be the executable's name.
	env	the environment variables to pass to the process; a dictionary of strings.
	path	the path to run the subprocess in - defaults to the current directory.
	reactor	the reactor to use - defaults to the default reactor
	errortoo	If true, include stderr in the result. If false, if stderr is received the returned `Deferred` will errback with an `IOError` instance with a `processEnded` attribute. The `processEnded` attribute refers to a `Deferred` which fires when the executed process ends.

def getProcessValue(executable, args=(), env={}, path=None, reactor=None): (source)

Spawn a process and return its exit code as a Deferred.

def getProcessOutputAndValue(executable, args=(), env={}, path=None, reactor=None, stdinBytes=None): (source)

Spawn a process and returns a Deferred that will be called back with its output (from stdout and stderr) and it's exit code as (out, err, code) If a signal is raised, the Deferred will errback with the stdout and stderr up to that point, along with the signal, as (out, err, signalNum)

def _resetWarningFilters(passthrough, addedFilters): (source)

Undocumented

def runWithWarningsSuppressed(suppressedWarnings, f, *a, **kw): (source)

Run the function f, but with some warnings suppressed.

Parameters	suppressedWarnings	A list of arguments to pass to filterwarnings. Must be a sequence of 2-tuples (args, kwargs).
	f	A callable, followed by its arguments and keyword arguments
	a	Undocumented
	kw	Undocumented

def suppressWarnings(f, *suppressedWarnings): (source)

Wrap f in a callable which suppresses the indicated warnings before invoking f and unsuppresses them afterwards. If f returns a Deferred, warnings will remain suppressed until the Deferred fires.