Tutorial¶
Outcome provides a function for capturing the outcome of a Python function call, so that it can be passed around. The basic rule is:
result = outcome.capture(f, *args, **kwargs)
x = result.unwrap()
is the same as:
x = f(*args, **kwargs)
even if f
raises an error.
There’s also acapture()
:
result = await outcome.acapture(f, *args, **kwargs)
x = result.unwrap()
which, like before, is the same as:
x = await f(*args, **kwargs)
An Outcome object can only be unwrapped once. A second attempt would raise an
AlreadyUsedError
.
See the API Reference for the types involved.