python-openhab-rest-client 21.4.0__tar.gz → 21.4.1__tar.gz

{python_openhab_rest_client-21.4.0/python_openhab_rest_client.egg-info → python_openhab_rest_client-21.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-openhab-rest-client
-Version: 21.4.0
+Version: 21.4.1
 Summary: A Python client for the openHAB REST API. This library enables easy interaction with the openHAB REST API to control smart home devices, retrieve status information, and process events.
 Home-page: https://github.com/Michdo93/python-openhab-rest-client
 Author: Michael Christian Dörflinger
@@ -84,6 +84,76 @@ Install via pip:
 pip install python-openhab-rest-client
 ```
 
+Here is the complete section translated into English, formatted to match your README:
+
+---
+
+### Secure HTTPS & Self-Signed Certificates (TLS)
+
+When running openHAB over HTTPS with a custom or self-signed certificate, you must ensure that Python (via the underlying `requests` library) trusts the certificate and successfully validates the hostname.
+
+#### 1. Switch openHAB to HTTPS
+
+1. **Disable HTTP:**
+Open the configuration file `/etc/openhab/services/org.ops4j.pax.web.cfg` (if it is not existing, create it) and set:
+```properties
+org.osgi.service.http.enabled=false
+org.osgi.service.http.secure.enabled=true
+org.ops4j.pax.web.ssl.port=8443
+```
+
+It could also help to edit the `/etc/default/openhab` file and make this changes:
+
+```
+#########################
+## PORTS
+## The ports openHAB will bind its HTTP/HTTPS web server to.
+
+#OPENHAB_HTTP_PORT=8080
+OPENHAB_HTTPS_PORT=8443
+```
+
+This ensures openHAB runs exclusively on the secure HTTPS port (default `8443`).
+2. **Generate Keystore with a Proper SAN (Subject Alternative Name):**
+Modern OpenSSL and Python versions strictly require a SAN entry in the certificate to prevent hostname mismatches. Create a new keystore using Java's `keytool` (replace `<your-hostname>` with your actual hostname):
+```bash
+sudo rm /var/lib/openhab/etc/keystore
+sudo keytool -genkeypair -alias openhab -keyalg RSA -keysize 2048 -validity 365 \
+  -keystore /var/lib/openhab/etc/keystore -storepass openhab -keypass openhab \
+  -dname "CN=openhab" -ext "san=dns:<your-hostname>,ip:127.0.0.1,dns:localhost"
+sudo chown openhab:openhab /var/lib/openhab/etc/keystore
+sudo systemctl restart openhab
+```
+
+3. **Export the Certificate in PEM Format:**
+Export the public certificate so your Python client can read and trust it:
+```bash
+sudo keytool -exportcert -rfc -alias openhab -keystore /var/lib/openhab/etc/keystore \
+  -storepass openhab -file /home/$USER/openhab-exported.crt
+sudo chown $USER:$USER /home/$USER/openhab-exported.crt
+```
+
+#### 2. Usage in the Python Client
+
+Since self-signed certificates are rejected by default, you can pass the absolute path to the exported `.crt` file via the `verify` parameter of the client. The library will cryptographically verify the connection against your certificate:
+
+```python
+from openhab import OpenHABClient, Items
+
+client = OpenHABClient(
+    url="https://<your-hostname>:8443", 
+    username="openhab", 
+    password="habopen", 
+    verify="/home/smarthome/openhab-exported.crt"
+)
+
+itemsAPI = Items(client)
+allItems = itemsAPI.getItems()
+print("All Items:", allItems)
+```
+
+*(Note: For the asynchronous client `AsyncOpenHABClient`, the `verify` parameter works the exact same way via `aiohttp`.)*
+
 ## Usage
 
 Basically, you always need the `OpenHABClient` (or `AsyncOpenHABClient` for async usage). Regardless of whether you carry out a normal `REST request` or one via `SSE`.
@@ -3009,6 +3079,27 @@ This project is licensed under the MIT License. See the [LICENSE](LICENSE) file
 
 ## Changelog
 
+### 21.4.1
+
+Bug fixes (found while writing the examples of the book »openHAB & Python-Entwicklung«
+against openHAB 5.2.3):
+
+- **`Sitemaps.getSitemapEvents()` / `getFullSitemapEvents()`** read the SSE endpoints like a
+  normal response and failed after 10 s with "Read timed out". They now open the stream via
+  `executeSSE()` and return it (read it with `iterSSELines()` and `parseSSEData()` – sitemap
+  events have no `topic`). Note: bind the subscription to a page first with
+  `getSitemapPage(sitemap, page, subscriptionID=...)`; openHAB answers the stream request only
+  when the first event arrives.
+- **`Rules.setModuleConfigParam()`** sent the value with `json.dumps()`, so `10` was stored as
+  `"10"` (with quotes) and e.g. an `ItemCommandAction` sent an invalid command. The value is now
+  sent as plain text.
+- **`Links.deleteAllLinks()`** failed with `500 No message body writer` because of the missing
+  `Accept: application/json` header. It now returns openHAB's answer, e.g. `{"count": 1}`.
+- **`Persistence.deleteItemData()`** reported every `400` as "Invalid filter parameters.";
+  openHAB also uses `400` for read-only services such as rrd4j. openHAB's reason is appended now.
+- **`Voice.interpretText()` / `interpretTextBatch()`** dropped the interpreter's answer on `400`
+  (e.g. "Entschuldigung, aber das habe ich nicht verstanden."). It is appended now.
+
 ### 21.4.0
 
 Bug fixes (all found against openHAB 5.2.3):

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/README.md

@@ -57,6 +57,76 @@ Install via pip:
 pip install python-openhab-rest-client
 ```
 
+Here is the complete section translated into English, formatted to match your README:
+
+---
+
+### Secure HTTPS & Self-Signed Certificates (TLS)
+
+When running openHAB over HTTPS with a custom or self-signed certificate, you must ensure that Python (via the underlying `requests` library) trusts the certificate and successfully validates the hostname.
+
+#### 1. Switch openHAB to HTTPS
+
+1. **Disable HTTP:**
+Open the configuration file `/etc/openhab/services/org.ops4j.pax.web.cfg` (if it is not existing, create it) and set:
+```properties
+org.osgi.service.http.enabled=false
+org.osgi.service.http.secure.enabled=true
+org.ops4j.pax.web.ssl.port=8443
+```
+
+It could also help to edit the `/etc/default/openhab` file and make this changes:
+
+```
+#########################
+## PORTS
+## The ports openHAB will bind its HTTP/HTTPS web server to.
+
+#OPENHAB_HTTP_PORT=8080
+OPENHAB_HTTPS_PORT=8443
+```
+
+This ensures openHAB runs exclusively on the secure HTTPS port (default `8443`).
+2. **Generate Keystore with a Proper SAN (Subject Alternative Name):**
+Modern OpenSSL and Python versions strictly require a SAN entry in the certificate to prevent hostname mismatches. Create a new keystore using Java's `keytool` (replace `<your-hostname>` with your actual hostname):
+```bash
+sudo rm /var/lib/openhab/etc/keystore
+sudo keytool -genkeypair -alias openhab -keyalg RSA -keysize 2048 -validity 365 \
+  -keystore /var/lib/openhab/etc/keystore -storepass openhab -keypass openhab \
+  -dname "CN=openhab" -ext "san=dns:<your-hostname>,ip:127.0.0.1,dns:localhost"
+sudo chown openhab:openhab /var/lib/openhab/etc/keystore
+sudo systemctl restart openhab
+```
+
+3. **Export the Certificate in PEM Format:**
+Export the public certificate so your Python client can read and trust it:
+```bash
+sudo keytool -exportcert -rfc -alias openhab -keystore /var/lib/openhab/etc/keystore \
+  -storepass openhab -file /home/$USER/openhab-exported.crt
+sudo chown $USER:$USER /home/$USER/openhab-exported.crt
+```
+
+#### 2. Usage in the Python Client
+
+Since self-signed certificates are rejected by default, you can pass the absolute path to the exported `.crt` file via the `verify` parameter of the client. The library will cryptographically verify the connection against your certificate:
+
+```python
+from openhab import OpenHABClient, Items
+
+client = OpenHABClient(
+    url="https://<your-hostname>:8443", 
+    username="openhab", 
+    password="habopen", 
+    verify="/home/smarthome/openhab-exported.crt"
+)
+
+itemsAPI = Items(client)
+allItems = itemsAPI.getItems()
+print("All Items:", allItems)
+```
+
+*(Note: For the asynchronous client `AsyncOpenHABClient`, the `verify` parameter works the exact same way via `aiohttp`.)*
+
 ## Usage
 
 Basically, you always need the `OpenHABClient` (or `AsyncOpenHABClient` for async usage). Regardless of whether you carry out a normal `REST request` or one via `SSE`.
@@ -2982,6 +3052,27 @@ This project is licensed under the MIT License. See the [LICENSE](LICENSE) file
 
 ## Changelog
 
+### 21.4.1
+
+Bug fixes (found while writing the examples of the book »openHAB & Python-Entwicklung«
+against openHAB 5.2.3):
+
+- **`Sitemaps.getSitemapEvents()` / `getFullSitemapEvents()`** read the SSE endpoints like a
+  normal response and failed after 10 s with "Read timed out". They now open the stream via
+  `executeSSE()` and return it (read it with `iterSSELines()` and `parseSSEData()` – sitemap
+  events have no `topic`). Note: bind the subscription to a page first with
+  `getSitemapPage(sitemap, page, subscriptionID=...)`; openHAB answers the stream request only
+  when the first event arrives.
+- **`Rules.setModuleConfigParam()`** sent the value with `json.dumps()`, so `10` was stored as
+  `"10"` (with quotes) and e.g. an `ItemCommandAction` sent an invalid command. The value is now
+  sent as plain text.
+- **`Links.deleteAllLinks()`** failed with `500 No message body writer` because of the missing
+  `Accept: application/json` header. It now returns openHAB's answer, e.g. `{"count": 1}`.
+- **`Persistence.deleteItemData()`** reported every `400` as "Invalid filter parameters.";
+  openHAB also uses `400` for read-only services such as rrd4j. openHAB's reason is appended now.
+- **`Voice.interpretText()` / `interpretTextBatch()`** dropped the interpreter's answer on `400`
+  (e.g. "Entschuldigung, aber das habe ich nicht verstanden."). It is appended now.
+
 ### 21.4.0
 
 Bug fixes (all found against openHAB 5.2.3):

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/AsyncLinks.py

@@ -185,7 +185,8 @@ class AsyncLinks:
         :return: The API response when all links are successfully deleted.
         """
         try:
-            response = await self.client.delete(f"/links/{object}")
+            response = await self.client.delete(f"/links/{object}",
+                                          headers={"Accept": "application/json"})
 
             if isinstance(response, StatusResponse):
                 status_code = response["status"]

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/AsyncPersistence.py

@@ -308,7 +308,8 @@ class AsyncPersistence:
         except aiohttp.ClientResponseError as err:
             status_code = err.status
             if status_code == 400:
-                return {"error": "Invalid filter parameters."}
+                # openHAB uses 400 for invalid filters and for read-only services (e.g. rrd4j)
+                return {"error": f"Invalid filter parameters or service not modifiable: {str(err)}"}
             elif status_code == 404:
                 return {"error": "Unknown persistence service."}
             else:

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/AsyncRules.py

@@ -315,7 +315,7 @@ class AsyncRules:
         """
         try:
             response = await self.client.put(f"/rules/{ruleUID}/{moduleCategory}/{moduleID}/config/{param}",
-                                       data=json.dumps(value), headers={'Content-Type': 'text/plain'})
+                                       data=str(value), headers={"Content-Type": "text/plain"})
 
             if isinstance(response, StatusResponse):
                 status_code = response["status"]

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/AsyncSitemaps.py

@@ -14,6 +14,18 @@ class AsyncSitemaps:
         """
         self.client = client
 
+    async def _openEventStream(self, path: str, params: dict, errors: dict):
+        """Opens a sitemap SSE stream; returns the streaming response or {"error": ...}."""
+        try:
+            return await self.client.executeSSE(path, params=params)
+        except aiohttp.ClientResponseError as err:
+            statusCode = err.status
+            if statusCode in errors:
+                return {"error": errors[statusCode]}
+            return {"error": f"HTTP error {statusCode}: {str(err)}"}
+        except (aiohttp.ClientError, asyncio.TimeoutError) as err:
+            return {"error": f"Request error: {str(err)}"}
+
     async def getSitemaps(self):
         """
         Get all available sitemaps.
@@ -175,82 +187,33 @@ class AsyncSitemaps:
 
     async def getSitemapEvents(self, subscriptionID: str, sitemapName: str = None, pageID: str = None):
         """
-        Get sitemap events.
+        Opens the event stream (SSE) of a sitemap subscription for one page.
 
-        :param subscriptionID: The ID of the subscription.
-        :param sitemap: The name of the sitemap (optional).
-        :param pageID: The ID of the page (optional).
+        :param subscriptionID: The ID of the subscription (see subscribeToSitemapEvents()).
+        :param sitemapName: The name of the sitemap.
+        :param pageID: The ID of the page (the sitemap name for the home page).
 
-        :return: The events (JSON).
+        :return: A SSE stream (aiohttp.ClientResponse, read it with iterSSEEvents()) or {"error": ...}.
         """
-        try:
-            response = await self.client.get(
-                f"/sitemaps/events/{subscriptionID}", params={"sitemap": sitemapName, "pageid": pageID})
-
-            if isinstance(response, StatusResponse):
-                status_code = response["status"]
-            else:
-                return response
-
-        except aiohttp.ClientResponseError as err:
-            status_code = err.status
-            if status_code == 400:
-                return {"error": "Missing sitemap or page parameter, or page not linked successfully to the subscription."}
-            elif status_code == 404:
-                return {"error": "Subscription not found."}
-            else:
-                return {"error": f"HTTP error {status_code}: {str(err)}"}
-
-        except (aiohttp.ClientError, asyncio.TimeoutError) as err:
-            return {"error": f"Request error: {str(err)}"}
-
-        if status_code == 200:
-            return {"message": "OK"}
-        elif status_code == 404:
-            return {"error": "Subscription not found."}
-        elif status_code == 400:
-            return {"error": "Missing sitemap or page parameter, or page not linked successfully to the subscription."}
-
-        return {"error": f"Unexpected response: {status_code}"}
+        return await self._openEventStream(
+            f"/rest/sitemaps/events/{subscriptionID}", {"sitemap": sitemapName, "pageid": pageID},
+            {400: "Missing sitemap or page parameter, or page not linked successfully to the subscription.",
+             404: "Subscription not found."})
 
     async def getFullSitemapEvents(self, subscriptionID: str, sitemapName: str = None):
         """
-        Get sitemap events for a whole sitemap. Not recommended due to potentially high traffic.
+        Opens the event stream (SSE) of a sitemap subscription for the whole sitemap.
+        Not recommended due to potentially high traffic.
 
         :param subscriptionID: The ID of the subscription.
-        :param sitemap: The name of the sitemap (optional).
+        :param sitemapName: The name of the sitemap.
 
-        :return: The events for the entire sitemap (JSON).
+        :return: A SSE stream (aiohttp.ClientResponse) or {"error": ...}.
         """
-        try:
-            response = await self.client.get(
-                f"/sitemaps/events/{subscriptionID}/*", params={"sitemap": sitemapName})
-
-            if isinstance(response, StatusResponse):
-                status_code = response["status"]
-            else:
-                return response
-
-        except aiohttp.ClientResponseError as err:
-            status_code = err.status
-            if status_code == 400:
-                return {"error": "Missing sitemap parameter, or sitemap not linked successfully to the subscription."}
-            elif status_code == 404:
-                return {"error": "Subscription not found."}
-            else:
-                return {"error": f"HTTP error {status_code}: {str(err)}"}
-
-        except (aiohttp.ClientError, asyncio.TimeoutError) as err:
-            return {"error": f"Request error: {str(err)}"}
-
-        if status_code == 200:
-            return {"message": "OK"}
-        elif status_code == 404:
-            return {"error": "Subscription not found."}
-        elif status_code == 400:
-            return {"error": "Missing sitemap parameter, or sitemap not linked successfully to the subscription."}
-
-        return {"error": f"Unexpected response: {status_code}"}
+        return await self._openEventStream(
+            f"/rest/sitemaps/events/{subscriptionID}/*", {"sitemap": sitemapName},
+            {400: "Missing sitemap parameter, or sitemap not linked successfully to the subscription.",
+             404: "Subscription not found."})
 
     async def subscribeToSitemapEvents(self):
         """

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/AsyncVoice.py

@@ -190,7 +190,8 @@ class AsyncVoice:
         except aiohttp.ClientResponseError as err:
             status_code = err.status
             if status_code == 400:
-                return {"error": "Interpretation exception occurs."}
+                # openHAB explains in its error message why the text was not understood
+                return {"error": f"Interpretation exception occurs: {str(err)}"}
             elif status_code == 404:
                 return {"error": "No human language interpreter was found."}
             else:
@@ -272,7 +273,8 @@ class AsyncVoice:
         except aiohttp.ClientResponseError as err:
             status_code = err.status
             if status_code == 400:
-                return {"error": "Interpretation exception occurs."}
+                # openHAB explains in its error message why the text was not understood
+                return {"error": f"Interpretation exception occurs: {str(err)}"}
             elif status_code == 404:
                 return {"error": "No human language interpreter was found."}
             else:

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/Links.py

@@ -182,7 +182,8 @@ class Links:
         :return: The API response when all links are successfully deleted.
         """
         try:
-            response = self.client.delete(f"/links/{object}")
+            response = self.client.delete(f"/links/{object}",
+                                          headers={"Accept": "application/json"})
 
             if isinstance(response, StatusResponse):
                 status_code = response["status"]

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/Persistence.py

@@ -305,7 +305,8 @@ class Persistence:
         except requests.exceptions.HTTPError as err:
             status_code = err.response.status_code
             if status_code == 400:
-                return {"error": "Invalid filter parameters."}
+                # openHAB uses 400 for invalid filters and for read-only services (e.g. rrd4j)
+                return {"error": f"Invalid filter parameters or service not modifiable: {str(err)}"}
             elif status_code == 404:
                 return {"error": "Unknown persistence service."}
             else:

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/Rules.py

@@ -312,7 +312,7 @@ class Rules:
         """
         try:
             response = self.client.put(f"/rules/{ruleUID}/{moduleCategory}/{moduleID}/config/{param}",
-                                       data=json.dumps(value), headers={'Content-Type': 'text/plain'})
+                                       data=str(value), headers={"Content-Type": "text/plain"})
 
             if isinstance(response, StatusResponse):
                 status_code = response["status"]

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/Sitemaps.py

@@ -11,6 +11,18 @@ class Sitemaps:
         """
         self.client = client
 
+    def _openEventStream(self, path: str, params: dict, errors: dict):
+        """Opens a sitemap SSE stream; returns the streaming response or {"error": ...}."""
+        try:
+            return self.client.executeSSE(path, params=params)
+        except requests.exceptions.HTTPError as err:
+            statusCode = err.response.status_code
+            if statusCode in errors:
+                return {"error": errors[statusCode]}
+            return {"error": f"HTTP error {statusCode}: {str(err)}"}
+        except requests.exceptions.RequestException as err:
+            return {"error": f"Request error: {str(err)}"}
+
     def getSitemaps(self):
         """
         Get all available sitemaps.
@@ -172,82 +184,33 @@ class Sitemaps:
 
     def getSitemapEvents(self, subscriptionID: str, sitemapName: str = None, pageID: str = None):
         """
-        Get sitemap events.
+        Opens the event stream (SSE) of a sitemap subscription for one page.
 
-        :param subscriptionID: The ID of the subscription.
-        :param sitemap: The name of the sitemap (optional).
-        :param pageID: The ID of the page (optional).
+        :param subscriptionID: The ID of the subscription (see subscribeToSitemapEvents()).
+        :param sitemapName: The name of the sitemap.
+        :param pageID: The ID of the page (the sitemap name for the home page).
 
-        :return: The events (JSON).
+        :return: A SSE stream (requests.Response, read it with iterSSEEvents()) or {"error": ...}.
         """
-        try:
-            response = self.client.get(
-                f"/sitemaps/events/{subscriptionID}", params={"sitemap": sitemapName, "pageid": pageID})
-
-            if isinstance(response, StatusResponse):
-                status_code = response["status"]
-            else:
-                return response
-
-        except requests.exceptions.HTTPError as err:
-            status_code = err.response.status_code
-            if status_code == 400:
-                return {"error": "Missing sitemap or page parameter, or page not linked successfully to the subscription."}
-            elif status_code == 404:
-                return {"error": "Subscription not found."}
-            else:
-                return {"error": f"HTTP error {status_code}: {str(err)}"}
-
-        except requests.exceptions.RequestException as err:
-            return {"error": f"Request error: {str(err)}"}
-
-        if status_code == 200:
-            return {"message": "OK"}
-        elif status_code == 404:
-            return {"error": "Subscription not found."}
-        elif status_code == 400:
-            return {"error": "Missing sitemap or page parameter, or page not linked successfully to the subscription."}
-
-        return {"error": f"Unexpected response: {status_code}"}
+        return self._openEventStream(
+            f"/rest/sitemaps/events/{subscriptionID}", {"sitemap": sitemapName, "pageid": pageID},
+            {400: "Missing sitemap or page parameter, or page not linked successfully to the subscription.",
+             404: "Subscription not found."})
 
     def getFullSitemapEvents(self, subscriptionID: str, sitemapName: str = None):
         """
-        Get sitemap events for a whole sitemap. Not recommended due to potentially high traffic.
+        Opens the event stream (SSE) of a sitemap subscription for the whole sitemap.
+        Not recommended due to potentially high traffic.
 
         :param subscriptionID: The ID of the subscription.
-        :param sitemap: The name of the sitemap (optional).
+        :param sitemapName: The name of the sitemap.
 
-        :return: The events for the entire sitemap (JSON).
+        :return: A SSE stream (requests.Response) or {"error": ...}.
         """
-        try:
-            response = self.client.get(
-                f"/sitemaps/events/{subscriptionID}/*", params={"sitemap": sitemapName})
-
-            if isinstance(response, StatusResponse):
-                status_code = response["status"]
-            else:
-                return response
-
-        except requests.exceptions.HTTPError as err:
-            status_code = err.response.status_code
-            if status_code == 400:
-                return {"error": "Missing sitemap parameter, or sitemap not linked successfully to the subscription."}
-            elif status_code == 404:
-                return {"error": "Subscription not found."}
-            else:
-                return {"error": f"HTTP error {status_code}: {str(err)}"}
-
-        except requests.exceptions.RequestException as err:
-            return {"error": f"Request error: {str(err)}"}
-
-        if status_code == 200:
-            return {"message": "OK"}
-        elif status_code == 404:
-            return {"error": "Subscription not found."}
-        elif status_code == 400:
-            return {"error": "Missing sitemap parameter, or sitemap not linked successfully to the subscription."}
-
-        return {"error": f"Unexpected response: {status_code}"}
+        return self._openEventStream(
+            f"/rest/sitemaps/events/{subscriptionID}/*", {"sitemap": sitemapName},
+            {400: "Missing sitemap parameter, or sitemap not linked successfully to the subscription.",
+             404: "Subscription not found."})
 
     def subscribeToSitemapEvents(self):
         """

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/Voice.py

@@ -187,7 +187,8 @@ class Voice:
         except requests.exceptions.HTTPError as err:
             status_code = err.response.status_code
             if status_code == 400:
-                return {"error": "Interpretation exception occurs."}
+                # openHAB explains in its error message why the text was not understood
+                return {"error": f"Interpretation exception occurs: {str(err)}"}
             elif status_code == 404:
                 return {"error": "No human language interpreter was found."}
             else:
@@ -269,7 +270,8 @@ class Voice:
         except requests.exceptions.HTTPError as err:
             status_code = err.response.status_code
             if status_code == 400:
-                return {"error": "Interpretation exception occurs."}
+                # openHAB explains in its error message why the text was not understood
+                return {"error": f"Interpretation exception occurs: {str(err)}"}
             elif status_code == 404:
                 return {"error": "No human language interpreter was found."}
             else:

{python_openhab_rest_client-21.4.0 → python_openhab_rest_client-21.4.1}/openhab/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "21.4.0"
+__version__ = "21.4.1"
 
 from .Actions import Actions
 from .Addons import Addons