t.i.utils : module documentation

Part of twisted.internet View Source

Utility methods.
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 getProcessOutput Spawn a process and return its output as a deferred returning a string.
Function getProcessValue Spawn a process and return its exit code as a Deferred.
Function getProcessOutputAndValue No summary
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
def runWithWarningsSuppressed(suppressedWarnings, f, *a, **kw): (source)
Run the function f, but with some warnings suppressed.
ParameterssuppressedWarningsA list of arguments to pass to filterwarnings. Must be a sequence of 2-tuples (args, kwargs).
fA callable, followed by its arguments and keyword arguments
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.
def _callProtocolWithDeferred(protocol, executable, args, env, path, reactor=None): (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 string.
ParametersexecutableThe file name to run and get the output of - the full path should be used.
argsthe command line arguments to pass to the process; a sequence of strings. The first string should NOT be the executable's name.
envthe environment variables to pass to the processs; a dictionary of strings.
paththe path to run the subprocess in - defaults to the current directory.
reactorthe reactor to use - defaults to the default reactor
errortooIf 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): (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)
API Documentation for Twisted, generated by pydoctor at 2013-04-03 11:20:05.