File: api.rst

package info (click to toggle)
python-outcome 1.3.0.post0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 208 kB
  • sloc: python: 548; makefile: 12
file content (37 lines) | stat: -rw-r--r-- 749 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
.. _api-reference:

=============
API Reference
=============

.. module:: outcome

.. autofunction:: capture

.. autofunction:: acapture

.. autoclass:: Outcome
   :members:
   :inherited-members:

.. py:data:: Maybe
   :value: Value[ResultT] | Error

A convenience alias to a union of both results. This allows type checkers to perform
exhaustiveness checking when ``isinstance()`` is used with either class::

    outcome: Maybe[int] = capture(some_function, 1, 2, 3)
    if isinstance(outcome, Value):
        # Type checkers know it's a Value[int] here.
    else:
        # It must be an Error.

.. autoclass:: Value
   :members:
   :inherited-members:

.. autoclass:: Error
   :members:
   :inherited-members:

.. autoclass:: AlreadyUsedError