Skip to content

NatsSubscriberSpecification

faststream.nats.subscriber.specification.NatsSubscriberSpecification #

NatsSubscriberSpecification(
    _outer_config: T_BrokerConfig,
    specification_config: T_SpecificationConfig,
    calls: CallsCollection[Any],
)

Bases: SubscriberSpecification[NatsBrokerConfig, NatsSubscriberSpecificationConfig]

Source code in faststream/_internal/endpoint/subscriber/specification.py 
34
35
36
37
38
39
40
41
def __init__(
    self,
    _outer_config: "T_BrokerConfig",
    specification_config: "T_SpecificationConfig",
    calls: "CallsCollection[Any]",
) -> None:
    super().__init__(_outer_config, specification_config)
    self.calls = calls

subject property #

subject: Address

The subject this endpoint was declared with, and its Broker address.

filter_subjects property #

filter_subjects: list[str]

The subjects a JetStream consumer filters on, and their Broker addresses.

subjects property #

subjects: list[str]

The subjects this endpoint reads, one channel each.

A JetStream consumer with no subject reaches its stream through filter_subjects, and each of those is an address in its own right.

channel_labels property #

channel_labels: list[str]

config instance-attribute #

config = specification_config

include_in_schema property #

include_in_schema: bool

calls instance-attribute #

calls = calls

description property #

description: str | None

call_name property #

call_name: str

name property #

name: str

The key of the first channel this endpoint names.

get_schema #

get_schema() -> dict[str, SubscriberSpec]
Source code in faststream/nats/subscriber/specification.py 
50
51
52
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
78
def get_schema(self) -> dict[str, SubscriberSpec]:
    payloads = self.get_payloads()

    subjects = self.subjects
    split = len(subjects) > 1

    channels = {}
    for subject in subjects:
        name = self._channel_key(subject, split=split)

        channels[name] = SubscriberSpec(
            address=subject,
            description=self.description,
            operation=Operation(
                message=Message(
                    title=f"{name}:Message",
                    payload=resolve_payloads(payloads),
                ),
                bindings=None,
            ),
            bindings=ChannelBinding(
                nats=nats.ChannelBinding(
                    subject=subject,
                    queue=self.config.queue,
                ),
            ),
        )

    return channels

get_payloads #

get_payloads() -> list[tuple[dict[str, Any], str]]
Source code in faststream/_internal/endpoint/subscriber/specification.py 
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
def get_payloads(self) -> list[tuple["dict[str, Any]", str]]:
    payloads: list[tuple[dict[str, Any], str]] = []

    call_name = self.call_name

    for h in self.calls:
        if h.dependant is None:
            msg = "You should setup `Handler` at first."
            raise SetupError(msg)

        body = parse_handler_params(
            h.dependant,
            prefix=f"{self.config.title_ or call_name}:Message",
        )
        payloads.append((body, to_camelcase(h.name)))

    if not self.calls:
        payloads.append(
            (
                {
                    "title": f"{self.config.title_ or call_name}:Message:Payload",
                },
                to_camelcase(call_name),
            ),
        )

    return payloads