Skip to content

NatsPublishCommand

faststream.nats.response.NatsPublishCommand #

NatsPublishCommand(
    message: SendableMessage,
    *,
    subject: str = "",
    correlation_id: str | None = None,
    headers: dict[str, str] | None = None,
    reply_to: str = "",
    stream: str | None = None,
    timeout: float = 0.5,
    schedule: Optional[Schedule] = None,
    _publish_type: PublishType,
)

Bases: PublishCommand

Source code in faststream/nats/response.py 
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
def __init__(
    self,
    message: "SendableMessage",
    *,
    subject: str = "",
    correlation_id: str | None = None,
    headers: dict[str, str] | None = None,
    reply_to: str = "",
    stream: str | None = None,
    timeout: float = 0.5,
    schedule: Optional["Schedule"] = None,
    _publish_type: PublishType,
) -> None:
    super().__init__(
        body=message,
        destination=subject,
        correlation_id=correlation_id,
        headers=headers,
        reply_to=reply_to,
        _publish_type=_publish_type,
    )

    self.stream = stream
    self.timeout = timeout
    self.schedule = schedule

stream instance-attribute #

stream = stream

timeout instance-attribute #

timeout = timeout

schedule instance-attribute #

schedule = schedule

body instance-attribute #

body = body

headers instance-attribute #

headers = headers or {}

correlation_id instance-attribute #

correlation_id = correlation_id

destination instance-attribute #

destination = destination

reply_to instance-attribute #

reply_to = reply_to

publish_type instance-attribute #

publish_type = _publish_type

batch_bodies property #

batch_bodies: tuple[Any, ...]

headers_to_publish #

headers_to_publish(*, js: bool = False) -> dict[str, str]
Source code in faststream/nats/response.py 
72
73
74
75
76
77
78
79
80
81
82
83
84
85
def headers_to_publish(self, *, js: bool = False) -> dict[str, str]:
    headers = {}

    if self.correlation_id:
        headers["correlation_id"] = self.correlation_id

    if js and self.reply_to:
        headers["reply_to"] = self.reply_to

    if self.schedule:
        headers["Nats-Schedule"] = f"@at {self.schedule.time.isoformat()}"
        headers["Nats-Schedule-Target"] = self.schedule.target

    return headers | self.headers

from_cmd classmethod #

from_cmd(
    cmd: Union[PublishCommand, NatsPublishCommand],
) -> NatsPublishCommand
Source code in faststream/nats/response.py 
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
@classmethod
def from_cmd(
    cls,
    cmd: Union["PublishCommand", "NatsPublishCommand"],
) -> "NatsPublishCommand":
    if isinstance(cmd, NatsPublishCommand):
        # NOTE: Should return a copy probably.
        return cmd

    return cls(
        message=cmd.body,
        subject=cmd.destination,
        correlation_id=cmd.correlation_id,
        headers=cmd.headers,
        reply_to=cmd.reply_to,
        _publish_type=cmd.publish_type,
    )

as_publish_command #

as_publish_command() -> PublishCommand

Method to transform handlers' Response result to DTO for publishers.

Source code in faststream/response/response.py 
22
23
24
25
26
27
28
29
def as_publish_command(self) -> "PublishCommand":
    """Method to transform handlers' Response result to DTO for publishers."""
    return PublishCommand(
        body=self.body,
        headers=self.headers,
        correlation_id=self.correlation_id,
        _publish_type=PublishType.PUBLISH,
    )

get_publish_key #

get_publish_key() -> Any | None

Get the key for publishing this message.

Override this method in subclasses to provide broker-specific keys. Default implementation returns None (no key).

RETURNS DESCRIPTION
Any | None

The key for publishing, or None if this Response type doesn't use keys.
Source code in faststream/response/response.py 
31
32
33
34
35
36
37
38
39
40
def get_publish_key(self) -> Any | None:  # noqa: PLR6301
    """Get the key for publishing this message.

    Override this method in subclasses to provide broker-specific keys.
    Default implementation returns None (no key).

    Returns:
        The key for publishing, or None if this Response type doesn't use keys.
    """
    return None

add_headers #

add_headers(
    headers: dict[str, Any], *, override: bool = True
) -> None
Source code in faststream/response/response.py 
71
72
73
74
75
76
77
78
79
80
def add_headers(
    self,
    headers: dict[str, Any],
    *,
    override: bool = True,
) -> None:
    if override:
        self.headers |= headers
    else:
        self.headers = headers | self.headers