pytest-mqtt 0.1.0

About

pytest-mqtt supports testing systems based on MQTT by providing test fixtures for pytest.

It has been conceived for the fine terkin-datalogger and mqttwarn programs.

Details

Usage

@pytest.mark.capmqtt_decode_utf8
def test_mqtt_send_receive(mosquitto, capmqtt):
    """
    Basic send/receive roundtrip, with ASCII text payload (`str`).
    By using the `capmqtt_decode_utf8` marker, the payloads will also be received
    as `str`, after decoding them from `utf-8`.
    """

    # Submit two MQTT messages.
    capmqtt.publish(topic="foo", payload="bar")

    # Demonstrate the `messages` property.
    assert capmqtt.messages == [
        MqttMessage(topic="foo", payload="bar", userdata=None),
    ]

    # Demonstrate the `records` property.
    assert capmqtt.records == [
        ("foo", "bar", None),
    ]

The capmqtt_decode_utf8 setting can be enabled in three ways.

1. Session-wide, per pytestconfig option, for example within conftest.py:

   @pytest.fixture(scope="session", autouse=True)
   def configure_capmqtt_decode_utf8(pytestconfig):
       pytestconfig.option.capmqtt_decode_utf8 = True

2. On the module level, just say capmqtt_decode_utf8 = True on top of your file.

3. On individual test cases as a test case marker.

Issues

• Both fixtures currently do not support changing the MQTT broker hostname and port number differently than localhost:1883.

• The mosquitto fixture currently does not support either authentication or encryption.

• capmqtt should be able to capture messages only from specified topics.

Development

git clone https://github.com/mqtt-tools/pytest-mqtt
cd pytest-mqtt
python3 -m venv .venv
source .venv/bin/activate
pip install --editable=.[test,develop]
poe test

Project information