invoke.exceptions.Failure

Exception subclass representing failure of a command execution. "Failure" may mean the command executed and the shell indicated an unusual result (usually, a non-zero exit code), or it may mean something else, like a ``sudo`` command which was aborted when the supplied password failed authentication. Two attributes allow introspection to determine the nature of the problem: * ``result``: a `.Result` instance with info about the command being executed and, if it ran to completion, how it exited. * ``reason``: a wrapped exception instance if applicable (e.g. a `.StreamWatcher` raised `WatcherError`) or ``None`` otherwise, in which case, it's probably a `Failure` subclass indicating its own specific nature, such as `UnexpectedExit` or `CommandTimedOut`. This class is only rarely raised by itself; most of the time `.Runner.run` (or a wrapper of same, such as `.Context.sudo`) will raise a specific subclass like `UnexpectedExit` or `AuthFailure`. .. versionadded:: 1.0