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 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
|
from abc import abstractmethod
from collections.abc import Callable
from typing import Generic, TypeVar
from typing_extensions import Never
from returns.primitives.hkt import KindN
_FirstType = TypeVar('_FirstType')
_SecondType = TypeVar('_SecondType')
_ThirdType = TypeVar('_ThirdType')
_UpdatedType = TypeVar('_UpdatedType')
_BindableType = TypeVar('_BindableType', bound='BindableN')
class BindableN(Generic[_FirstType, _SecondType, _ThirdType]):
"""
Represents a "context" in which calculations can be executed.
``Bindable`` allows you to bind together
a series of calculations while maintaining
the context of that specific container.
In contrast to :class:`returns.interfaces.lashable.LashableN`,
works with the first type argument.
"""
__slots__ = ()
@abstractmethod
def bind(
self: _BindableType,
function: Callable[
[_FirstType],
KindN[_BindableType, _UpdatedType, _SecondType, _ThirdType],
],
) -> KindN[_BindableType, _UpdatedType, _SecondType, _ThirdType]:
"""
Applies 'function' to the result of a previous calculation.
And returns a new container.
"""
#: Type alias for kinds with one type argument.
Bindable1 = BindableN[_FirstType, Never, Never]
#: Type alias for kinds with two type arguments.
Bindable2 = BindableN[_FirstType, _SecondType, Never]
#: Type alias for kinds with three type arguments.
Bindable3 = BindableN[_FirstType, _SecondType, _ThirdType]
|