Skip to content

Context

faststream._internal.context.context_type.Context #

Context(
    real_name: str = "",
    *,
    default: Any = EMPTY,
    initial: Callable[..., Any] | None = 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: Callable[..., Any] | None 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/_internal/context/context_type.py 
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
def __init__(
    self,
    real_name: str = "",
    *,
    default: Any = EMPTY,
    initial: Callable[..., Any] | None = 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),
    )

param_name instance-attribute #

param_name: str

name instance-attribute #

name = real_name

default instance-attribute #

default = default

prefix instance-attribute #

prefix = prefix

initial instance-attribute #

initial = initial

cast instance-attribute #

cast: bool = cast

required instance-attribute #

required: bool = required

field instance-attribute #

field = False

use #

use(**kwargs: Any) -> dict[str, Any]

Use the given keyword arguments.

PARAMETER DESCRIPTION
**kwargs

Keyword arguments to be used

TYPE: Any DEFAULT: {}

RETURNS DESCRIPTION
dict[str, Any]

A dictionary containing the updated keyword arguments
Source code in faststream/_internal/context/context_type.py 
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
def use(self, /, **kwargs: Any) -> dict[str, Any]:
    """Use the given keyword arguments.

    Args:
        **kwargs: Keyword arguments to be used

    Returns:
        A dictionary containing the updated keyword arguments
    """
    name = f"{self.prefix}{self.name or self.param_name}"

    if EMPTY != (  # noqa: SIM300
        v := resolve_context_by_name(
            name=name,
            default=self.default,
            initial=self.initial,
            context=kwargs["context__"],
        )
    ):
        kwargs[self.param_name] = v

    else:
        kwargs.pop(self.param_name, None)

    return kwargs

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_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