Skip to content

Context

faststream.utils.context.types.Context #

Context(real_name: str = '', *, default: Any = _empty, initial: Optional[Callable[..., Any]] = None, cast: bool = False, prefix: str = '')

Bases: CustomField

A class to represent a context.

METHOD DESCRIPTION
__init__

constructor method
use

method to use the context

Initialize the object.

PARAMETER DESCRIPTION
real_name

The real name of the object.

TYPE: str DEFAULT: ''

default

The default value of the object.

TYPE: Any DEFAULT: _empty

initial

The initial value builder.

TYPE: Optional[Callable[..., Any]] DEFAULT: None

cast

Whether to cast the object.

TYPE: bool DEFAULT: False

prefix

The prefix to be added to the name of the object.

TYPE: str DEFAULT: ''

RAISES DESCRIPTION
TypeError

If the default value is not provided.
Source code in faststream/utils/context/types.py 
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
def __init__(
    self,
    real_name: str = "",
    *,
    default: Any = _empty,
    initial: Optional[Callable[..., Any]] = None,
    cast: bool = False,
    prefix: str = "",
) -> None:
    """Initialize the object.

    Args:
        real_name: The real name of the object.
        default: The default value of the object.
        initial: The initial value builder.
        cast: Whether to cast the object.
        prefix: The prefix to be added to the name of the object.

    Raises:
        TypeError: If the default value is not provided.
    """
    self.name = real_name
    self.default = default
    self.prefix = prefix
    self.initial = initial
    super().__init__(
        cast=cast,
        required=(default is _empty),
    )

cast instance-attribute #

cast: bool = cast

default instance-attribute #

default = default

field instance-attribute #

field = False

initial instance-attribute #

initial = initial

name instance-attribute #

name = real_name

param_name instance-attribute #

param_name: str

prefix instance-attribute #

prefix = prefix

required instance-attribute #

required: bool = required

set_param_name #

set_param_name(name: str) -> Cls
Source code in fast_depends/library/model.py 
30
31
32
def set_param_name(self: Cls, name: str) -> Cls:
    self.param_name = name
    return self

use #

use(**kwargs: Any) -> AnyDict

Use the given keyword arguments.

PARAMETER DESCRIPTION
**kwargs

Keyword arguments to be used

TYPE: Any DEFAULT: {}

RETURNS DESCRIPTION
AnyDict

A dictionary containing the updated keyword arguments
RAISES DESCRIPTION
KeyError

If the parameter name is not found in the keyword arguments
AttributeError

If the parameter name is not a valid attribute
Source code in faststream/utils/context/types.py 
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
def use(self, /, **kwargs: Any) -> AnyDict:
    """Use the given keyword arguments.

    Args:
        **kwargs: Keyword arguments to be used

    Returns:
        A dictionary containing the updated keyword arguments

    Raises:
        KeyError: If the parameter name is not found in the keyword arguments
        AttributeError: If the parameter name is not a valid attribute
    """
    name = f"{self.prefix}{self.name or self.param_name}"

    if (
        v := resolve_context_by_name(
            name=name,
            default=self.default,
            initial=self.initial,
        )
    ) is not _empty:
        kwargs[self.param_name] = v

    return kwargs

use_field #

use_field(kwargs: Dict[str, Any]) -> None
Source code in fast_depends/library/model.py 
38
39
def use_field(self, kwargs: Dict[str, Any]) -> None:
    raise NotImplementedError("You should implement `use_field` method.")