Skip to content

NatsMessage

faststream.nats.message.NatsMessage dataclass #

NatsMessage(raw_message, body, headers=dict(), batch_headers=list(), path=dict(), content_type=None, reply_to='', message_id=gen_cor_id(), correlation_id=gen_cor_id())

Bases: StreamMessage[Msg]

A class to represent a NATS message.

raw_message instance-attribute #

raw_message

body instance-attribute #

body

headers class-attribute instance-attribute #

headers = field(default_factory=dict)

batch_headers class-attribute instance-attribute #

batch_headers = field(default_factory=list)

path class-attribute instance-attribute #

path = field(default_factory=dict)

content_type class-attribute instance-attribute #

content_type = None

reply_to class-attribute instance-attribute #

reply_to = ''

message_id class-attribute instance-attribute #

message_id = field(default_factory=gen_cor_id)

correlation_id class-attribute instance-attribute #

correlation_id = field(default_factory=gen_cor_id)

processed class-attribute instance-attribute #

processed = field(default=False, init=False)

committed class-attribute instance-attribute #

committed = field(default=None, init=False)

decoded_body property writable #

decoded_body

decode async #

decode()

Serialize the message by lazy decoder.

Source code in faststream/broker/message.py
async def decode(self) -> Optional["DecodedMessage"]:
    """Serialize the message by lazy decoder."""
    # TODO: make it lazy after `decoded_body` removed
    return self._decoded_body

ack async #

ack()
Source code in faststream/nats/message.py
async def ack(self) -> None:
    # Check `self.raw_message._ackd` instead of `self.committed`
    # to be compatible with `self.raw_message.ack()`
    if not self.raw_message._ackd:
        await self.raw_message.ack()
        await super().ack()

nack async #

nack(delay=None)
Source code in faststream/nats/message.py
async def nack(
    self,
    delay: Union[int, float, None] = None,
) -> None:
    if not self.raw_message._ackd:
        await self.raw_message.nak(delay=delay)
        await super().nack()

reject async #

reject()
Source code in faststream/nats/message.py
async def reject(self) -> None:
    if not self.raw_message._ackd:
        await self.raw_message.term()
        await super().reject()

in_progress async #

in_progress()
Source code in faststream/nats/message.py
async def in_progress(self) -> None:
    if not self.raw_message._ackd:
        await self.raw_message.in_progress()