dbus2mqtt 0.1.1__tar.gz → 0.2.0__tar.gz

dbus2mqtt-0.2.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

dbus2mqtt-0.2.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

dbus2mqtt-0.2.0/.github/release-drafter.yml

@@ -0,0 +1,51 @@
+name-template: 'v$RESOLVED_VERSION 🌈'
+tag-template: 'v$RESOLVED_VERSION'
+exclude-labels:
+  - dependencies
+categories:
+  - title: 💥 Breaking changes
+    labels:
+      - breaking-change
+  - title: 🚀 Features
+    labels:
+      - feature
+      - enhancement
+  - title: 🐛 Bug Fixes
+    labels:
+      - fix
+      - bugfix
+      - bug
+  - title: 🧰 Maintenance
+    labels:
+      - chore
+      - documentation
+exclude-contributors:
+  - jwnmulder
+autolabeler:
+  - label: enhancement
+    branch:
+      - '/feature\/.+/'
+  - label: fix
+    branch:
+      - '/fix\/.+/'
+    title:
+      - '/fix/i'
+version-resolver:
+  major:
+    labels:
+      - major
+  minor:
+    labels:
+      - minor
+      - feature
+      - enhancement
+      - breaking-change  # minor until we are on 1.x
+  patch:
+    labels:
+      - patch
+  default: patch
+change-template: '* $TITLE (#$NUMBER)'
+template: |
+  ## Changes
+
+  $CHANGES

dbus2mqtt-0.2.0/.github/scripts/release-versions.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+import json
+import subprocess
+import sys
+
+from packaging import version
+
+
+def get_versions_from_git_tags() -> list[version.Version]:
+    result = subprocess.run(
+        ["git", "tag"],
+        capture_output=True, text=True, check=True
+    )
+    tags = result.stdout.strip().splitlines()
+    versions = [t.lstrip("v") for t in tags if t.startswith("v")]
+
+    parsed_versions = []
+    for v in versions:
+        try:
+            parsed = version.parse(v)
+            parsed_versions.append(parsed)
+        except Exception as e:
+            print(f"Error parsing version {v}: {e}")
+
+    return parsed_versions
+
+def latest_version_by_cycle(versions: list[version.Version], cycles: list[str]) -> dict[str, version.Version]:
+    res = {}
+    for cycle in cycles:
+        parsed_cycle = version.parse(cycle)
+
+        for v in versions:
+            # check if version is in cycle range
+            # cycle can be major or major.minor or major.minor.patch
+            if len(v.release) > len(parsed_cycle.release):
+                # update if version is later within cycle
+                if cycle not in cycles or v > parsed_cycle:
+                    res[cycle] = v
+    return res
+
+def main():
+    args = sys.argv[1:]
+    if not args:
+        print("Usage: release-versions.py 0.1 0.2 1.0 ...")
+        sys.exit(1)
+
+    versions = get_versions_from_git_tags()
+    cycles = latest_version_by_cycle(versions, args)
+
+    # Detect the overall latest version
+    overall_latest = max(versions) if versions else None
+
+    cycle_details = []
+    for cycle in args:
+        latest = cycles.get(cycle)
+        if latest:
+            cycle_details.append({
+                "cycle": cycle,
+                "latestVersion": latest.base_version,
+                "isLatestStable": latest == overall_latest
+            })
+
+    print(json.dumps(cycle_details))
+
+if __name__ == "__main__":
+    main()

dbus2mqtt-0.1.1/.github/workflows/main.yml → dbus2mqtt-0.2.0/.github/workflows/ci.yml

@@ -1,4 +1,4 @@
-name: main
+name: CI
 
 "on":
   push:

dbus2mqtt-0.2.0/.github/workflows/docker-dev.yml

@@ -0,0 +1,74 @@
+name: docker-dev
+
+"on":
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  docker:
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: "Set up Python"
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+
+      - name: Determine version from hatch
+        id: version
+        run: echo "PRETEND_VERSION=$(uvx hatch version)" >> "$GITHUB_OUTPUT"
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            jwnmulder/dbus2mqtt
+            ghcr.io/jwnmulder/dbus2mqtt
+          tags: |
+            type=raw,value=dev,enable=${{ github.ref == format('refs/heads/{0}', 'main') }}
+          labels: |
+            org.opencontainers.image.source=https://github.com/jwnmulder/dbus2mqtt
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to DockerHub
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          username: jwnmulder
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Login to GHCR
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: jwnmulder
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./docker/Dockerfile.latest
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            PRETEND_VERSION=${{ steps.version.outputs.PRETEND_VERSION }}

dbus2mqtt-0.2.0/.github/workflows/docker-stable.yml

@@ -0,0 +1,97 @@
+name: docker-stable releases
+
+"on":
+  push:
+    branches:
+      - main
+    paths:
+      - "docker/**"
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  setup:
+    runs-on: ubuntu-latest
+    outputs:
+      versions_matrix: ${{ steps.supported_release_versions.outputs.versions_matrix }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Determine supported release versions
+        id: supported_release_versions
+        run: |
+          SUPPORTED_CYCLES=("0.1" "0.2" "0.3" "0.4" "0.5" "0.6" "0.7" "0.8" "0.9" "1.0" "2.0")
+
+          VERSIONS_JSON=$(python3 .github/scripts/release-versions.py "${SUPPORTED_CYCLES[@]}")
+
+          # Wrap the output into matrix include
+          VERSIONS_MATRIX=$(echo "$VERSIONS_JSON" | jq -c '{include: [.[] | {cycle: .cycle, version: .latestVersion, isLatestStable: .isLatestStable}]}')
+
+          echo "VERSIONS_MATRIX=$VERSIONS_MATRIX"
+          echo "versions_matrix=$VERSIONS_MATRIX" >> $GITHUB_OUTPUT
+  docker:
+    runs-on: ubuntu-latest
+    needs: setup
+    permissions:
+      packages: write
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJson(needs.setup.outputs.versions_matrix) }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            jwnmulder/dbus2mqtt
+            ghcr.io/jwnmulder/dbus2mqtt
+          tags: |
+            type=raw,value=latest,enable=${{ matrix.isLatestStable }}
+            type=pep440,pattern={{major}},value=${{ matrix.version }},enable=${{ !startsWith(matrix.version, '0.') }}
+            type=pep440,pattern={{major}}.{{minor}},value=${{ matrix.version }}
+            type=pep440,pattern={{major}}.{{minor}}.{{patch}},value=${{ matrix.version }}
+          # type=ref,event=branch
+          # type=ref,event=pr
+          # type=semver,pattern={{version}},value=${{ matrix.version }}
+          labels: |
+            org.opencontainers.image.source=https://github.com/jwnmulder/dbus2mqtt
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to DockerHub
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          username: jwnmulder
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Login to GHCR
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: jwnmulder
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./docker/Dockerfile.pypi
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            DBUS2MQTT_VERSION=${{ matrix.version }}

{dbus2mqtt-0.1.1 → dbus2mqtt-0.2.0}/.github/workflows/publish.yml

@@ -1,11 +1,3 @@
-# This workflow will upload a Python Package to PyPI when a release is created
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
-
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-
 name: Upload Python Package
 
 "on":

dbus2mqtt-0.2.0/.gitignore

@@ -0,0 +1,25 @@
+# https://github.com/github/gitignore/blob/main/Python.gitignore
+# https://github.com/github/gitignore/blob/main/VisualStudio.gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+
+# Environments
+.env
+.venv
+
+# Ruff stuff:
+.ruff_cache/
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace

{dbus2mqtt-0.1.1 → dbus2mqtt-0.2.0}/.pre-commit-config.yaml

@@ -42,7 +42,7 @@ repos:
           - I
 
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.6.14
+    rev: 0.6.16
     hooks:
       - id: uv-lock
 

dbus2mqtt-0.2.0/.python-version

@@ -0,0 +1 @@
+3.10

dbus2mqtt-0.2.0/.vscode/launch.json

@@ -0,0 +1,13 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "dbus2mqtt - home_assistant_media_player",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "dbus2mqtt",
+            "console": "integratedTerminal",
+            "args": "--config docs/examples/home_assistant_media_player.yaml"
+        }
+    ]
+}

{dbus2mqtt-0.1.1 → dbus2mqtt-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dbus2mqtt
-Version: 0.1.1
+Version: 0.2.0
 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
 Project-URL: Issues, https://github.com/jwnmulder/dbus2mqtt/issues
@@ -9,6 +9,7 @@ License-File: LICENSE
 Keywords: dbus,home-assistant,mpris,mqtt,python
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -31,8 +32,6 @@ Description-Content-Type: text/markdown
 
 # dbus2mqtt
 
-> **⚠️ Warning:** This project has no releases yet. Running from source works. Docker images and Python packages are planned but not yet available.
-
 **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**.
 
@@ -46,12 +45,11 @@ This makes it easy to integrate Linux desktop services or system signals into MQ
 * 📡 Expose **D-Bus methods** for remote control via MQTT messages.
 * 🏠 Includes example configurations for **MPRIS** and **Home Assistant Media Player** integration.
 
-TODO list
+## Project status
+
+**dbus2mqtt** is considered stable for the use-cases it has been tested against, and is actively being developed. Documentation is continuously being improved.
 
-* Create a release on PyPI
-* Release a docker image
-* Improve error handling when deleting message with 'retain' set. WARNING:dbus2mqtt.mqtt_client:on_message: Unexpected payload, expecting json, topic=dbus2mqtt/org.mpris.MediaPlayer2/command, payload=, error=Expecting value: line 1 column 1 (char 0)
-* Property set only works the first time, need to restart after which the first set will work again
+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)
 
 ## Getting started with dbus2mqtt
 
@@ -82,7 +80,7 @@ dbus:
               topic: dbus2mqtt/org.mpris.MediaPlayer2/state
               payload_type: json
               payload_template: |
-                {{ dbus_call(mpris_bus_name, path, 'org.freedesktop.DBus.Properties', 'GetAll', ['org.mpris.MediaPlayer2.Player']) | to_yaml }}
+                {{ dbus_call(mpris_bus_name, path, 'org.freedesktop.DBus.Properties', 'GetAll', ['org.mpris.MediaPlayer2.Player']) }}
 ```
 
 MQTT connection details can be configured in that same `config.yaml` file or via environment variables. For now create a `.env` file with the following contents.
@@ -94,17 +92,17 @@ MQTT__USERNAME=
 MQTT__PASSWORD=
 ```
 
-### Running from source
-
-To run dbus2mqtt from source (requires uv to be installed)
+### Install and run dbus2mqtt
 
 ```bash
-uv run main.py --config config.yaml
+python -m pip install dbus2mqtt
+dbus2mqtt --config config.yaml
 ```
 
+
 ### Run using docker with auto start behavior
 
-To build and run dbus2mqtt using Docker with the [home_assistant_media_player.yaml](docs/examples/home_assistant_media_player.yaml) example from this repository
+To build and run dbus2mqtt using Docker with the [home_assistant_media_player.yaml](https://github.com/jwnmulder/dbus2mqtt/blob/main/docs/examples/home_assistant_media_player.yaml) example from this repository.
 
 ```bash
 # setup configuration
@@ -112,10 +110,8 @@ mkdir -p $HOME/.config/dbus2mqtt
 cp docs/examples/home_assistant_media_player.yaml $HOME/.config/dbus2mqtt/config.yaml
 cp .env.example $HOME/.config/dbus2mqtt/.env
 
-# build image
-docker build -t jwnmulder/dbus2mqtt:latest .
-
 # run image and automatically start on reboot
+sudo docker pull jwnmulder/dbus2mqtt
 docker run --detach --name dbus2mqtt \
   --volume "$HOME"/.config/dbus2mqtt:"$HOME"/.config/dbus2mqtt \
   --volume /run/user:/run/user \
@@ -133,7 +129,7 @@ sudo docker logs dbus2mqtt -f
 
 ## Examples
 
-This repository contains some examples under [docs/examples](docs/examples.md). The most complete one being [MPRIS to Home Assistant Media Player integration](docs/examples/home_assistant_media_player.md)
+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)
 
 ## Configuration reference
 
@@ -169,7 +165,7 @@ dbus:
       path: /org/mpris/MediaPlayer2
       interfaces:
         - interface: org.mpris.MediaPlayer2.Player
-          mqtt_call_method_topic: dbus2mqtt/org.mpris.MediaPlayer2/command
+          mqtt_command_topic: dbus2mqtt/org.mpris.MediaPlayer2/command
           methods:
             - method: Pause
             - method: Play
@@ -216,8 +212,8 @@ dbus:
 
 ## Flows
 
-TODO: Document flows, for now see the [MPRIS to Home Assistant Media Player integration](docs/examples/home_assistant_media_player.md) example
+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
 
 ## Jinja templating
 
-TODO: Document Jinja templating, for now see the [MPRIS to Home Assistant Media Player integration](docs/examples/home_assistant_media_player.md) example
+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

{dbus2mqtt-0.1.1 → dbus2mqtt-0.2.0}/README.md

@@ -1,7 +1,5 @@
 # dbus2mqtt
 
-> **⚠️ Warning:** This project has no releases yet. Running from source works. Docker images and Python packages are planned but not yet available.
-
 **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**.
 
@@ -15,12 +13,11 @@ This makes it easy to integrate Linux desktop services or system signals into MQ
 * 📡 Expose **D-Bus methods** for remote control via MQTT messages.
 * 🏠 Includes example configurations for **MPRIS** and **Home Assistant Media Player** integration.
 
-TODO list
+## Project status
+
+**dbus2mqtt** is considered stable for the use-cases it has been tested against, and is actively being developed. Documentation is continuously being improved.
 
-* Create a release on PyPI
-* Release a docker image
-* Improve error handling when deleting message with 'retain' set. WARNING:dbus2mqtt.mqtt_client:on_message: Unexpected payload, expecting json, topic=dbus2mqtt/org.mpris.MediaPlayer2/command, payload=, error=Expecting value: line 1 column 1 (char 0)
-* Property set only works the first time, need to restart after which the first set will work again
+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)
 
 ## Getting started with dbus2mqtt
 
@@ -51,7 +48,7 @@ dbus:
               topic: dbus2mqtt/org.mpris.MediaPlayer2/state
               payload_type: json
               payload_template: |
-                {{ dbus_call(mpris_bus_name, path, 'org.freedesktop.DBus.Properties', 'GetAll', ['org.mpris.MediaPlayer2.Player']) | to_yaml }}
+                {{ dbus_call(mpris_bus_name, path, 'org.freedesktop.DBus.Properties', 'GetAll', ['org.mpris.MediaPlayer2.Player']) }}
 ```
 
 MQTT connection details can be configured in that same `config.yaml` file or via environment variables. For now create a `.env` file with the following contents.
@@ -63,17 +60,17 @@ MQTT__USERNAME=
 MQTT__PASSWORD=
 ```
 
-### Running from source
-
-To run dbus2mqtt from source (requires uv to be installed)
+### Install and run dbus2mqtt
 
 ```bash
-uv run main.py --config config.yaml
+python -m pip install dbus2mqtt
+dbus2mqtt --config config.yaml
 ```
 
+
 ### Run using docker with auto start behavior
 
-To build and run dbus2mqtt using Docker with the [home_assistant_media_player.yaml](docs/examples/home_assistant_media_player.yaml) example from this repository
+To build and run dbus2mqtt using Docker with the [home_assistant_media_player.yaml](https://github.com/jwnmulder/dbus2mqtt/blob/main/docs/examples/home_assistant_media_player.yaml) example from this repository.
 
 ```bash
 # setup configuration
@@ -81,10 +78,8 @@ mkdir -p $HOME/.config/dbus2mqtt
 cp docs/examples/home_assistant_media_player.yaml $HOME/.config/dbus2mqtt/config.yaml
 cp .env.example $HOME/.config/dbus2mqtt/.env
 
-# build image
-docker build -t jwnmulder/dbus2mqtt:latest .
-
 # run image and automatically start on reboot
+sudo docker pull jwnmulder/dbus2mqtt
 docker run --detach --name dbus2mqtt \
   --volume "$HOME"/.config/dbus2mqtt:"$HOME"/.config/dbus2mqtt \
   --volume /run/user:/run/user \
@@ -102,7 +97,7 @@ sudo docker logs dbus2mqtt -f
 
 ## Examples
 
-This repository contains some examples under [docs/examples](docs/examples.md). The most complete one being [MPRIS to Home Assistant Media Player integration](docs/examples/home_assistant_media_player.md)
+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)
 
 ## Configuration reference
 
@@ -138,7 +133,7 @@ dbus:
       path: /org/mpris/MediaPlayer2
       interfaces:
         - interface: org.mpris.MediaPlayer2.Player
-          mqtt_call_method_topic: dbus2mqtt/org.mpris.MediaPlayer2/command
+          mqtt_command_topic: dbus2mqtt/org.mpris.MediaPlayer2/command
           methods:
             - method: Pause
             - method: Play
@@ -185,8 +180,8 @@ dbus:
 
 ## Flows
 
-TODO: Document flows, for now see the [MPRIS to Home Assistant Media Player integration](docs/examples/home_assistant_media_player.md) example
+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
 
 ## Jinja templating
 
-TODO: Document Jinja templating, for now see the [MPRIS to Home Assistant Media Player integration](docs/examples/home_assistant_media_player.md) example
+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

dbus2mqtt-0.1.1/Dockerfile → dbus2mqtt-0.2.0/docker/Dockerfile.latest

@@ -2,9 +2,12 @@
 
 # First, build the application in the `/app` directory.
 # See `Dockerfile` for details.
-FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim AS builder
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim AS builder
 ENV UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy
 
+ARG PRETEND_VERSION
+ENV SETUPTOOLS_SCM_PRETEND_VERSION=${PRETEND_VERSION}
+
 # Disable Python downloads, because we want to use the system interpreter
 # across both images. If using a managed Python version, it needs to be
 # copied from the build image into the final image; see `standalone.Dockerfile`
@@ -17,13 +20,12 @@ RUN --mount=type=cache,target=/root/.cache/uv \
     --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
     uv sync --frozen --no-install-project --no-dev
 
-ADD src/ pyproject.toml uv.lock .python-version README.md /app
+ADD src/ pyproject.toml uv.lock README.md /app
 RUN --mount=type=cache,target=/root/.cache/uv \
     uv sync --frozen --no-dev
 
-
 # Then, use a final image without uv
-FROM python:3.12-slim-bookworm
+FROM python:3.13-slim-bookworm
 # It is important to use the image that matches the builder, as the path to the
 # Python executable must be the same, e.g., using `python:3.12-slim-bookworm`
 # will fail.

dbus2mqtt-0.2.0/docker/Dockerfile.pypi

@@ -0,0 +1,12 @@
+FROM python:3.13-slim-bookworm
+
+WORKDIR /app
+
+ARG DBUS2MQTT_VERSION=latest
+
+RUN pip install --no-cache-dir dbus2mqtt=="$DBUS2MQTT_VERSION"
+
+ENTRYPOINT ["python", "-m", "dbus2mqtt"]
+
+# show help message by default
+CMD ["--help"]