outcome

Capture the outcome of Python function calls.

outcome Permissive license MIT OR Apache-2.0 AGING ★ 36 v1.3.0.post0 released 2023-10-26

Install

outcome on PyPI

pip

pip install outcome

uv

uv add outcome

poetry

poetry add outcome

Package facts

License	MIT OR Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.7)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — attrs
Maintenance	aging — 1,022 days since the last release
Last repo commit	2026-02-02
First released	2018-03-24
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: outcome-1.3.0.post0-py2.py3-none-any.whl

Keywords: result

Development Status :: 5 - Production/StableFramework :: TrioIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseLicense :: OSI Approved :: MIT LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIX :: LinuxProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTyping :: Typed

About outcome

from the package's own PyPI description — quoted content, verbatim

.. image:: https://img.shields.io/badge/chat-join%20now-blue.svg :target: https://gitter.im/python-trio/general :alt: Join chatroom

.. image:: https://img.shields.io/badge/docs-read%20now-blue.svg :target: https://outcome.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

.. image:: https://travis-ci.org/python-trio/trio.svg?branch=master :target: https://travis-ci.org/python-trio/outcome :alt: Automated test status (Linux and MacOS)

.. image:: https://ci.appveyor.com/api/projects/status/c54uu4rxlgs2usmj/branch/master?svg=true :target: https://ci.appveyor.com/project/RazerM/outcome/history :alt: Automated test status (Windows)

.. image:: https://codecov.io/gh/python-trio/trio/branch/master/graph/badge.svg :target: https://codecov.io/gh/python-trio/outcome :alt: Test coverage

outcome

Welcome to outcome <https://github.com/python-trio/outcome>__!

Capture the outcome of Python function calls. Extracted from the Trio <https://github.com/python-trio/trio>__ project.

License: Your choice of MIT or Apache License 2.0

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Captures the outcome of Python function calls as either a success value or an exception, providing a structured way to handle and propagate results without raising.

Low friction: pure Python wheel with a single lightweight dependency on attrs. Last release was 1022 days ago with status marked aging, though the repository remains active and not archived.

Dual-licensed under MIT or Apache-2.0 (your choice), both permissive licenses with minimal restrictions on use, modification, or distribution.

Usage

pip install outcome

from outcome import capture

result = capture(lambda: None)
print(result)

Requires Python 3.7 or later.

Verdict: Stable, well-maintained utility for structured result handling extracted from the Trio async framework. No known vulnerabilities, permissive dual licensing, and minimal dependencies make it a low-risk addition. The aging maintenance status reflects infrequent updates rather than abandonment—appropriate for a mature, focused library.

Needs verification

Whether the 1022-day gap since last release reflects active maintenance or de facto dormancy for this particular use case.
Real-world adoption patterns beyond the Trio ecosystem to assess whether this is a general-purpose tool or primarily used internally.

result type pythonexception handling wrappercapture function outcomesuccess or error valuefunctional error handlingoutcome monadresult pattern