t.i.utils : module documentation

Part of twisted.internet View Source

Utility methods.
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 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): (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)
def _resetWarningFilters(passthrough, addedFilters): (source)
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.
API Documentation for Twisted, generated by pydoctor at 2011-10-27 16:27:37.