dbus2mqtt 0.4.1__py3-none-any.whl → 0.4.3__py3-none-any.whl

dbus2mqtt/config/__init__.py

@@ -107,8 +107,14 @@ class FlowActionMqttPublishConfig:
     type: Literal["mqtt_publish"] = "mqtt_publish"
     payload_type: Literal["json", "yaml", "text", "binary"] = "json"
 
+@dataclass
+class FlowActionLogConfig:
+    msg: str
+    type: Literal["log"] = "log"
+    level: Literal["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"] = "INFO"
+
 FlowActionConfig = Annotated[
-    FlowActionMqttPublishConfig | FlowActionContextSetConfig,
+    FlowActionMqttPublishConfig | FlowActionContextSetConfig | FlowActionLogConfig,
     Field(discriminator="type")
 ]
 
@@ -157,6 +163,7 @@ class MqttConfig:
     username: str
     password: SecretStr
     port: int = 1883
+    subscription_topics: list[str] = field(default_factory=lambda: ['dbus2mqtt/#'])
 
 @dataclass
 class Config:

dbus2mqtt/dbus/dbus_client.py

@@ -512,7 +512,7 @@ class DbusClient:
                 # clean lingering interface messgage handler from bus
                 self.bus.remove_message_handler(proxy_interface._message_handler)
 
-            # For now that InterfacesRemoved signal means the entire object is removed form D-Bus
+            # For now that InterfacesRemoved signal means the entire object is removed from D-Bus
             del self.subscriptions[bus_name].path_objects[path]
 
         # cleanup the entire BusNameSubscriptions if no more objects are subscribed

dbus2mqtt/flow/actions/log_action.py

@@ -0,0 +1,36 @@
+
+import logging
+
+from jinja2.exceptions import TemplateError
+
+from dbus2mqtt import AppContext
+from dbus2mqtt.config import FlowActionLogConfig
+from dbus2mqtt.flow import FlowAction, FlowExecutionContext
+
+logger = logging.getLogger(__name__)
+
+class LogAction(FlowAction):
+
+    def __init__(self, config: FlowActionLogConfig, app_context: AppContext):
+        self.config = config
+        self.templating = app_context.templating
+
+    async def execute(self, context: FlowExecutionContext):
+
+        render_context = context.get_aggregated_context()
+
+        log_msg = self.config.msg
+        log_level = logging._nameToLevel.get(self.config.level.upper(), logging.INFO)
+
+        try:
+            log_msg = await self.templating.async_render_template(
+                templatable=self.config.msg,
+                context=render_context,
+                res_type=str
+            )
+
+        except TemplateError as e:
+            logger.warning(f"Error rendering jinja template, flow: '{context.name or ''}', msg={e}, msg={self.config.msg}, render_context={render_context}", exc_info=True)
+            return
+
+        logger.log(level=log_level, msg=log_msg)

dbus2mqtt/flow/flow_processor.py

@@ -17,6 +17,7 @@ from dbus2mqtt.config import (
 from dbus2mqtt.event_broker import FlowTriggerMessage
 from dbus2mqtt.flow import FlowAction, FlowExecutionContext
 from dbus2mqtt.flow.actions.context_set import ContextSetAction
+from dbus2mqtt.flow.actions.log_action import LogAction
 from dbus2mqtt.flow.actions.mqtt_publish import MqttPublishAction
 
 logger = logging.getLogger(__name__)
@@ -102,8 +103,11 @@ class FlowActionContext:
             action = None
             if action_config.type == "context_set":
                 action = ContextSetAction(action_config, self.app_context)
-            if action_config.type == "mqtt_publish":
+            elif action_config.type == "mqtt_publish":
                 action = MqttPublishAction(action_config, self.app_context)
+            elif action_config.type == "log":
+                action = LogAction(action_config, self.app_context)
+
             if action:
                 res.append(action)
 

dbus2mqtt/mqtt/mqtt_client.py

@@ -13,6 +13,8 @@ import paho.mqtt.client as mqtt
 import yaml
 
 from paho.mqtt.enums import CallbackAPIVersion
+from paho.mqtt.packettypes import PacketTypes
+from paho.mqtt.properties import Properties
 from paho.mqtt.subscribeoptions import SubscribeOptions
 
 from dbus2mqtt import AppContext
@@ -27,8 +29,11 @@ class MqttClient:
         self.event_broker = app_context.event_broker
 
         unique_client_id_postfix = ''.join(random.choices(string.ascii_lowercase + string.digits, k=6))
+        self.client_id_prefix = "dbus2mqtt-"
+        self.client_id = f"{self.client_id_prefix}{unique_client_id_postfix}"
+
         self.client = mqtt.Client(
-            client_id=f"dbus2mqtt-client-{unique_client_id_postfix}",
+            client_id=self.client_id,
             protocol=mqtt.MQTTv5,
             callback_api_version=CallbackAPIVersion.VERSION2
         )
@@ -84,7 +89,16 @@ class MqttClient:
                 if first_message:
                     await asyncio.wait_for(self.connected_event.wait(), timeout=5)
 
-                self.client.publish(topic=msg.topic, payload=payload or "").wait_for_publish(timeout=1000)
+                publish_properties = Properties(PacketTypes.PUBLISH)
+                publish_properties.UserProperty = ("client_id", self.client_id)
+
+                publish_info = self.client.publish(
+                    topic=msg.topic,
+                    payload=payload or "",
+                    properties=publish_properties
+                )
+                publish_info.wait_for_publish(timeout=1000)
+
                 if first_message:
                     logger.info(f"First message published: topic={msg.topic}, payload={payload_log_msg}")
                     first_message = False
@@ -100,22 +114,29 @@ class MqttClient:
             logger.warning(f"on_connect: Failed to connect: {reason_code}. Will retry connection")
         else:
             logger.info(f"on_connect: Connected to {self.config.host}:{self.config.port}")
-            # Subscribing in on_connect() means that if we lose the connection and
-            # reconnect then subscriptions will be renewed.
-            # TODO: Determine topics based on config
-            client.subscribe("dbus2mqtt/#", options=SubscribeOptions(noLocal=True))
+
+            subscriptions = [(t, SubscribeOptions(noLocal=True)) for t in self.config.subscription_topics]
+            client.subscribe(subscriptions)
 
             self.loop.call_soon_threadsafe(self.connected_event.set)
 
     def on_message(self, client: mqtt.Client, userdata: Any, msg: mqtt.MQTTMessage):
 
-        # TODO: Skip messages being sent by other dbus2mqtt clients
-
+        # Skip retained messages
         payload = msg.payload.decode()
         if msg.retain:
             logger.info(f"on_message: skipping msg with retain=True, topic={msg.topic}, payload={payload}")
             return
 
+        # Skip messages being sent by other dbus2mqtt clients
+        if msg.properties:
+            user_properties: list[tuple[str, object]] = getattr(msg.properties, "UserProperty", [])
+            client_id = next((str(v) for k, v in user_properties if k == "client_id"), None)
+            if client_id and client_id != self.client_id:
+                logger.info(f"on_message: skipping msg from another dbus2mqtt client, topic={msg.topic}, client_id={client_id}")
+            if client_id and client_id.startswith(self.client_id_prefix):
+                return
+
         try:
             json_payload = json.loads(payload) if payload else {}
             logger.debug(f"on_message: msg.topic={msg.topic}, msg.payload={json.dumps(json_payload)}")

dbus2mqtt/template/templating.py

@@ -1,3 +1,4 @@
+import urllib.parse
 
 from datetime import datetime
 from typing import Any, TypeVar
@@ -7,11 +8,18 @@ from jinja2.nativetypes import NativeEnvironment
 
 TemplateResultType = TypeVar('TemplateResultType')
 
+def urldecode(string):
+    return urllib.parse.unquote(string)
+
 class TemplateEngine:
     def __init__(self):
 
         engine_globals = {}
         engine_globals['now'] = datetime.now
+        engine_globals['urldecode'] = urldecode
+
+        engine_filters = {}
+        engine_filters['urldecode'] = urldecode
 
         self.jinja2_env = NativeEnvironment(
             loader=BaseLoader(),
@@ -32,6 +40,9 @@ class TemplateEngine:
         self.jinja2_env.globals.update(engine_globals)
         self.jinja2_async_env.globals.update(engine_globals)
 
+        self.jinja2_env.filters.update(engine_filters)
+        self.jinja2_async_env.filters.update(engine_filters)
+
     def add_functions(self, custom_functions: dict[str, Any]):
         self.jinja2_env.globals.update(custom_functions)
         self.jinja2_async_env.globals.update(custom_functions)

{dbus2mqtt-0.4.1.dist-info → dbus2mqtt-0.4.3.dist-info}/METADATA

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: dbus2mqtt
-Version: 0.4.1
-Summary: A Python tool to expose Linux D-Bus signals, methods and properties over MQTT - featuring templating, payload enrichment and Home Assistant-ready examples 
-Project-URL: Repository, https://github.com/jwnmulder/dbus2mqtt.git
+Version: 0.4.3
+Summary: General purpose DBus to MQTT bridge - expose signals, methods and properties over MQTT - featuring jinja based templating, payload enrichment and MPRIS / BlueZ / Home Assistant ready examples 
+Project-URL: Documentation, https://jwnmulder.github.io/dbus2mqtt
+Project-URL: Source, https://github.com/jwnmulder/dbus2mqtt
 Project-URL: Issues, https://github.com/jwnmulder/dbus2mqtt/issues
 License-Expression: MIT
 License-File: LICENSE
-Keywords: dbus,home-assistant,mpris,mqtt,python
-Classifier: Development Status :: 4 - Beta
+Keywords: bluez,bridge,dbus,home-assistant,jinja2,mpris,mqtt,python
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
@@ -16,6 +17,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Home Automation
 Requires-Python: >=3.10
 Requires-Dist: apscheduler>=3.11.0
 Requires-Dist: colorlog>=6.9.0
@@ -32,12 +34,12 @@ Description-Content-Type: text/markdown
 
 # dbus2mqtt
 
-**dbus2mqtt** is a Python application that bridges **Linux D-Bus** with **MQTT**.
-It lets you forward D-Bus signals and properties to MQTT topics, call D-Bus methods via MQTT messages, and shape payloads using flexible **Jinja2 templating**.
+**dbus2mqtt** is a Python application that bridges **DBus** with **MQTT**.
+It lets you forward Linux D-Bus signals and properties to MQTT topics, call D-Bus methods via MQTT messages, and shape payloads using flexible **Jinja2 templating**.
 
 This makes it easy to integrate Linux desktop services or system signals into MQTT-based workflows - including **Home Assistant**.
 
-## ✨ Features
+## Features
 
 * 🔗 Forward **D-Bus signals** to MQTT topics.
 * 🧠 Enrich or transform **MQTT payloads** using Jinja2 templates and additional D-Bus calls.
@@ -49,11 +51,11 @@ This makes it easy to integrate Linux desktop services or system signals into MQ
 
 **dbus2mqtt** is considered stable for the use-cases it has been tested against, and is actively being developed. Documentation is continuously being improved.
 
-Initial testing has focused on MPRIS integration. A table of tested MPRIS players and their supported methods can be found here: [home_assistant_media_player.md](https://github.com/jwnmulder/dbus2mqtt/blob/main/docs/examples/home_assistant_media_player.md)
+Initial testing has focused on MPRIS integration. A table of tested MPRIS players and their supported methods can be found here: [Mediaplayer integration with Home Assistant](https://jwnmulder.github.io/dbus2mqtt/examples/home_assistant_media_player/)
 
 ## Getting started with dbus2mqtt
 
-Create a `config.yaml` file with the contents shown below. This configuration will expose all bus properties from the `org.mpris.MediaPlayer2.Player` interface to MQTT on the `dbus2mqtt/org.mpris.MediaPlayer2/state` topic. Have a look at [docs/examples](https://github.com/jwnmulder/dbus2mqtt/blob/main/docs/examples.md) for more examples
+Create a `config.yaml` file with the contents shown below. This configuration will expose all bus properties from the `org.mpris.MediaPlayer2.Player` interface to MQTT on the `dbus2mqtt/org.mpris.MediaPlayer2/state` topic.
 
 ```yaml
 dbus:
@@ -92,6 +94,7 @@ MQTT__USERNAME=
 MQTT__PASSWORD=
 ```
 
+
 ### Install and run dbus2mqtt
 
 ```bash
@@ -129,7 +132,8 @@ sudo docker logs dbus2mqtt -f
 
 ## Examples
 
-This repository contains examples under [docs/examples](https://github.com/jwnmulder/dbus2mqtt/blob/main//docs/examples.md). The most complete one being [MPRIS to Home Assistant Media Player integration](https://github.com/jwnmulder/dbus2mqtt/blob/main/docs/examples/home_assistant_media_player.md)
+More dbus2mqtt examples can be found here: [examples](https://jwnmulder.github.io/dbus2mqtt/examples/).
+The most complete one being [MPRIS to Home Assistant Media Player integration](https://jwnmulder.github.io/dbus2mqtt/examples/home_assistant_media_player/)
 
 ## Configuration reference
 
@@ -154,6 +158,8 @@ or
 mqtt:
   host: localhost
   port: 1883
+  subscription_topics:
+    - dbus2mqtt/#
 ```
 
 ### Exposing dbus methods
@@ -224,8 +230,8 @@ dbus:
 
 ## Flows
 
-TODO: Document flows, for now see the [MPRIS to Home Assistant Media Player integration](https://github.com/jwnmulder/dbus2mqtt/blob/main/docs/examples/home_assistant_media_player.md) example
+A reference of all supported flow triggers and actions can be found on [Flows](https://jwnmulder.github.io/dbus2mqtt/flows/)
 
 ## Jinja templating
 
-TODO: Document Jinja templating, for now see the [MPRIS to Home Assistant Media Player integration](https://github.com/jwnmulder/dbus2mqtt/blob/main/docs/examples/home_assistant_media_player.md) example
+TODO: Document Jinja templating, for now see the [MPRIS to Home Assistant Media Player integration](https://jwnmulder.github.io/dbus2mqtt/examples/home_assistant_media_player/) example

{dbus2mqtt-0.4.1.dist-info → dbus2mqtt-0.4.3.dist-info}/RECORD

@@ -2,22 +2,23 @@ dbus2mqtt/__init__.py,sha256=VunubKEH4_lne9Ttd2YRpyXjZMIAzyD2eiJ2sfvvTFU,362
 dbus2mqtt/__main__.py,sha256=NAoa3nwgBSQI22eWzzRx61SIDThDwXmUofWWZU3_4-Q,71
 dbus2mqtt/event_broker.py,sha256=Hp5yurhP8FkAO-y0l2grygHxR2e37ZQ7QScjcQDA2UU,1334
 dbus2mqtt/main.py,sha256=Kr2LRVxWcPDtNwCj8Eqz9TxtGLAVrV4q0nizKh1pLXc,4539
-dbus2mqtt/config/__init__.py,sha256=LXQg2cZ_vMvhAl7_cC6G3gxCaLCq9uaTfZqw7OEXkPQ,5104
+dbus2mqtt/config/__init__.py,sha256=947_dLVt8qq7P3p15jGIy5Vf1jUUMGrh1xr_DVhZclQ,5372
 dbus2mqtt/config/jsonarparse.py,sha256=VJGFeyQJcOE6bRXlSRr3FClvN_HnmiIlEGmOgNM0oCc,1214
-dbus2mqtt/dbus/dbus_client.py,sha256=zWz9V0lbGzbb3AifqWrwkOaC9OdZtQbfHhkSSJfXMi8,39690
+dbus2mqtt/dbus/dbus_client.py,sha256=WHsmOiaJ5SY6zk-C99m83MEpycnUyGpsYmGopJJbPE8,39690
 dbus2mqtt/dbus/dbus_types.py,sha256=NmPD9um499e49Pk8DWH4IrIPQh1BinHYQgoXllCNiDw,777
 dbus2mqtt/dbus/dbus_util.py,sha256=h-1Y8Mvz9bj9X7mPZ8LghkvXDrujdJHK0__AOW373hE,697
 dbus2mqtt/dbus/introspection_patches/mpris_playerctl.py,sha256=q93d_Yp93u3Y-9q0dRdKW5hrij9GK3CFqKhUWVE8uw4,5883
 dbus2mqtt/dbus/introspection_patches/mpris_vlc.py,sha256=Cf-o-05W6gUoKpcYR7n0dRi-CrbeASPTwkyEzZGnU3Y,4241
 dbus2mqtt/flow/__init__.py,sha256=tAL-CjXQHq_tGTKctIdOZ5teVKBtcJs6Astq_RdruV8,1540
-dbus2mqtt/flow/flow_processor.py,sha256=-fJ5JPFcFqz1RokKaqjdHoU-EPg5McAERKYFwIkMzgU,8749
+dbus2mqtt/flow/flow_processor.py,sha256=N-btGap1wqnM4zKyulH_5KQhGi0IRlsK2cHrrnomMQQ,8922
 dbus2mqtt/flow/actions/context_set.py,sha256=dIT39MJJVb0wuRI_ZM3ssnXYfa-iyB4o_UZD-1BZL2g,1087
+dbus2mqtt/flow/actions/log_action.py,sha256=2_-YEKkX5kvFzK6x4v-Hx3u2PEM8fip_4buMg_ij-oI,1156
 dbus2mqtt/flow/actions/mqtt_publish.py,sha256=psNkTvaR3JZwAwpM4AqiZTDnA5UQX9r4CUZ1LA7iRW4,2366
-dbus2mqtt/mqtt/mqtt_client.py,sha256=R0ZNUmOr8Lg8s2TuUcjH3BvEPPlNK731tzO0tNVvqqs,5167
+dbus2mqtt/mqtt/mqtt_client.py,sha256=P6rxVNA2M_wxhI3RcHpvayEEmcUQGGDG6hkLmjiqY1w,6056
 dbus2mqtt/template/dbus_template_functions.py,sha256=UEoXK2PqDKF6jR4vTFHQwq58f5APnOJr7B1_I1zW8yM,2449
-dbus2mqtt/template/templating.py,sha256=ZLp1A8PFAs_-Bndx4yGqyppaDfh8marHlK7P3bFInu4,4144
-dbus2mqtt-0.4.1.dist-info/METADATA,sha256=LR9PxxTxJ6TcxHpa8YKg9E6uWRDWYRBbpQ5-o5QGTxQ,8114
-dbus2mqtt-0.4.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dbus2mqtt-0.4.1.dist-info/entry_points.txt,sha256=pmmacoHCsvTTUB5dIPaY4i0H9gX7BQlpd3rBU-Jbv3A,50
-dbus2mqtt-0.4.1.dist-info/licenses/LICENSE,sha256=a4bIEgyA9rrnAfUN90CgbgZ6BQIFHeABkk0JihiBaxM,1074
-dbus2mqtt-0.4.1.dist-info/RECORD,,
+dbus2mqtt/template/templating.py,sha256=YzE6-pBoATrV7nXkgxSiLlbxgbC65-2wGiFPHgIDd9g,4470
+dbus2mqtt-0.4.3.dist-info/METADATA,sha256=XcxIrk2rZt7HWU1ch1Eqx2DzVIQgvsjpwYMZ0q6on2A,8071
+dbus2mqtt-0.4.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dbus2mqtt-0.4.3.dist-info/entry_points.txt,sha256=pmmacoHCsvTTUB5dIPaY4i0H9gX7BQlpd3rBU-Jbv3A,50
+dbus2mqtt-0.4.3.dist-info/licenses/LICENSE,sha256=a4bIEgyA9rrnAfUN90CgbgZ6BQIFHeABkk0JihiBaxM,1074
+dbus2mqtt-0.4.3.dist-info/RECORD,,