Skip to content

TestKafkaBroker

faststream.kafka.testing.TestKafkaBroker #

TestKafkaBroker(broker, with_real=False, connect_only=None)

Bases: TestBroker[KafkaBroker]

A class to test Kafka brokers.

Source code in faststream/_internal/testing/broker.py 
45
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
71
72
73
def __init__(
    self,
    broker: Broker,
    with_real: bool = False,
    connect_only: bool | None = None,
) -> None:
    self.with_real = with_real
    self.broker = broker

    if connect_only is None:
        try:
            connect_only = is_contains_context_name(
                self.__class__.__name__,
                TestApp.__name__,
            )
        except Exception:  # pragma: no cover
            warnings.warn(
                (
                    "\nError `{e!r}` occurred at `{self.__class__.__name__}` AST parsing."
                    "\n`connect_only` is set to `False` by default."
                ),
                category=RuntimeWarning,
                stacklevel=1,
            )

            connect_only = False

    self.connect_only = connect_only
    self._fake_subscribers: list[SubscriberUsecase[Any]] = []

with_real instance-attribute #

with_real = with_real

broker instance-attribute #

broker = broker

connect_only instance-attribute #

connect_only = connect_only

create_publisher_fake_subscriber staticmethod #

create_publisher_fake_subscriber(broker, publisher)
Source code in faststream/kafka/testing.py 
61
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
89
90
91
92
93
94
95
96
97
@staticmethod
def create_publisher_fake_subscriber(
    broker: KafkaBroker,
    publisher: "LogicPublisher",
) -> tuple["LogicSubscriber[Any]", bool]:
    sub: LogicSubscriber[Any] | None = None
    for handler in broker.subscribers:
        handler = cast("LogicSubscriber[Any]", handler)
        if _is_handler_matches(handler, publisher.topic, publisher.partition):
            sub = handler
            break

    if sub is None:
        is_real = False

        topic_name = publisher.topic

        if publisher.partition:
            tp = TopicPartition(
                topic=topic_name,
                partition=publisher.partition,
            )
            sub = broker.subscriber(
                partitions=[tp],
                batch=isinstance(publisher, BatchPublisher),
                persistent=False,
            )
        else:
            sub = broker.subscriber(
                topic_name,
                batch=isinstance(publisher, BatchPublisher),
                persistent=False,
            )
    else:
        is_real = True

    return sub, is_real