PyHolfuy 0.1__tar.gz → 0.3__tar.gz

{pyholfuy-0.1/pyholfuy.egg-info → pyholfuy-0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyholfuy
-Version: 0.1
+Version: 0.3
 Summary: A Python library for interacting with Holfuy weather stations.
 Author-email: Håvard Dagenborg <haavardj@dagenborg.net>
 License-Expression: MIT
@@ -16,15 +16,7 @@ Provides-Extra: test
 Requires-Dist: aioresponses==0.7.8; extra == "test"
 Requires-Dist: coverage==7.8.0; extra == "test"
 Requires-Dist: mypy==1.15.0; extra == "test"
-Requires-Dist: pytest-asyncio==0.26.0; extra == "test"
-Requires-Dist: pytest-cov==6.1.1; extra == "test"
-Requires-Dist: pytest-error-for-skips==2.0.2; extra == "test"
-Requires-Dist: pytest-timeout==2.3.1; extra == "test"
-Requires-Dist: pytest==8.3.5; extra == "test"
-Requires-Dist: ruff==0.11.7; extra == "test"
-Requires-Dist: syrupy==4.9.1; extra == "test"
 Provides-Extra: dev
-Requires-Dist: pre-commit==4.2.0; extra == "dev"
 Dynamic: license-file
 
 ![Holfy Logo](https://holfuy.com/image/logo/holfuy-logo.png)
@@ -34,7 +26,7 @@ A Python library for talking to [Holfuy Weather Stations](https://holfuy.com/).
 
 You need an API key to access the service. To obtain one, please visit the [Holfuy API](https://api.holfuy.com/live/) pages.
 
-The Library only access live data.
+The library can only access live data.
 
 ## Example Code
 Here is an example of how to use the library.
@@ -46,10 +38,22 @@ from holfuy import HolfuyService
 
 async def main():
     async with aiohttp.ClientSession() as session:
-    s = HolfuyService("", session)
-    data = await s.fetch_data(["101"])
-    print(data)
+        s = HolfuyService("", session)
+        data = await s.fetch_data(["101"])
+        print(data)
 
 if __name__ == "__main__":
     asyncio.run(main())
 ```
+
+## Return value and errors
+
+`fetch_data()` returns `{"measurements": [...]}` with one entry per station, also when
+a single station is requested. A station the key cannot read is still listed, with
+`error` and `errorCode` instead of data.
+
+It raises, all subclasses of `holfuy.HolfuyError`:
+
+- `HolfuyAuthError`: the API key is rejected, or it has no access to any requested station.
+- `HolfuyConnectionError`: network error, timeout, or an HTTP error status.
+- `HolfuyError`: any other unexpected reply.

pyholfuy-0.3/README.md

@@ -0,0 +1,38 @@
+![Holfy Logo](https://holfuy.com/image/logo/holfuy-logo.png)
+
+# PyHolfuy
+A Python library for talking to [Holfuy Weather Stations](https://holfuy.com/).
+
+You need an API key to access the service. To obtain one, please visit the [Holfuy API](https://api.holfuy.com/live/) pages.
+
+The library can only access live data.
+
+## Example Code
+Here is an example of how to use the library.
+
+```python
+import aiohttp
+import asyncio
+from holfuy import HolfuyService
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        s = HolfuyService("", session)
+        data = await s.fetch_data(["101"])
+        print(data)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Return value and errors
+
+`fetch_data()` returns `{"measurements": [...]}` with one entry per station, also when
+a single station is requested. A station the key cannot read is still listed, with
+`error` and `errorCode` instead of data.
+
+It raises, all subclasses of `holfuy.HolfuyError`:
+
+- `HolfuyAuthError`: the API key is rejected, or it has no access to any requested station.
+- `HolfuyConnectionError`: network error, timeout, or an HTTP error status.
+- `HolfuyError`: any other unexpected reply.

pyholfuy-0.3/holfuy/__init__.py

@@ -0,0 +1,162 @@
+"""Library to handle connection with Holfuy Live API."""
+
+import asyncio
+import logging
+
+from typing import Any
+
+import aiohttp
+from aiohttp import ClientSession
+
+from .const import (
+    CONF_TEMPERATURE_UNIT_CELSIUS,
+    CONF_WIND_SPEED_UNIT_MS,
+    CONF_AVERAGING_NEWEST,
+    CONF_MODE_JSON,
+    STATIONS_ALL,
+)
+from .exceptions import HolfuyAuthError, HolfuyConnectionError, HolfuyError
+
+__all__ = [
+    "HolfuyAuthError",
+    "HolfuyConnectionError",
+    "HolfuyError",
+    "HolfuyService",
+]
+
+TIMEOUT = 30
+_LOGGER = logging.getLogger(__name__)
+
+API_URL = "https://api.holfuy.com/live/"
+
+# noqa: E501
+#### API Description
+# URL Format:  https://api.holfuy.com/live/?s=101&pw=pass&m=JSON&tu=C&su=m/s
+#
+# s: station(s) ID e.g. s=101 or you can get the data from more stations by one query as well (coma separated list) e.g. s=101,102,103 . If you would get all stations' data (to which you have access) by one single API call please use the "all" string -> s=all .
+# pw: password for the API access (it could be sent by a POST "pw" parameter also)
+# m:mode XML or CSV or JSON default: CSV
+# avg:averaging "0": newest data from the station, "1" newest quarter hourly average, "2" newest hourly average (default = 0)
+# su: wind speed unit: knots, km/h, m/s, mph, default: m/s
+# tu: temperature unit C:Celsius , F: Fahrenheit default: Celsius
+# batt: add this parameter to get the station's battery voltage (JSON only).
+# cam: add this parameter to the URL for timestamp of the last picture from the camera. (JSON only, only for stations with a camera)
+# daily: add this parameter to get daily Max-Min temperatures and precipitation since last midnight CE(S)T (JSON only, max 5 stations)
+# loc: add this parameter to the URL to get the station's location in reply too (JSON only)
+# utc: add this parameter to the URL for timestamps in UTC, otherwise times will be in CE(S)T
+# Data: DateTime: time of the last data / average in ".date('T')." (Central European Time) or in UTC if utc param is set.
+#####
+
+
+class HolfuyService:
+    """Representation of Holfuy weather data."""
+
+    def __init__(
+        self,
+        api_key: str,
+        session: ClientSession,
+        temperature_unit:str=CONF_TEMPERATURE_UNIT_CELSIUS,
+        wind_speed_unit:str=CONF_WIND_SPEED_UNIT_MS,
+        timestamps_in_utc:bool=False,
+    ) -> None:
+        """Initialize the Weather object."""
+
+        self._api_url = API_URL
+        self._api_key = api_key
+        self._wind_speed_unit = wind_speed_unit
+        self._temperature_unit = temperature_unit
+        self._timestamps_in_utc = timestamps_in_utc
+        self._session = session
+
+
+    async def fetch_data(
+        self,
+        stations: list[str] | None = None,
+        averaging_mode=CONF_AVERAGING_NEWEST,
+        include_battery=False,
+        include_daily=False,
+        include_location=False,
+    ) -> dict[str, Any]:
+        """Get the latest data from Holfuy.
+
+        Returns {"measurements": [...]}, one entry per station. A station the key
+        cannot read is still listed, with "error" and "errorCode" instead of data.
+
+        Raises HolfuyAuthError if the key is rejected or can read none of the
+        requested stations, HolfuyConnectionError on network errors, timeouts and
+        HTTP errors, and HolfuyError on any other unexpected reply.
+        """
+
+        params = {
+            "pw": self._api_key,
+            "m": CONF_MODE_JSON,
+            "tu": self._temperature_unit,
+            "su": self._wind_speed_unit,
+            "avg": averaging_mode,
+        }
+
+        if self._timestamps_in_utc:
+            params["utc"] = ""
+
+        if include_battery:
+            params["batt"] = ""
+
+        if include_daily:
+            params["daily"] = ""
+
+        if include_location:
+            params["loc"] = ""
+
+        if stations:
+            params["s"] = ",".join(map(str, stations))
+        else:
+            params["s"] = STATIONS_ALL
+
+        try:
+            # The timeout covers the whole exchange, body included, and the
+            # context manager releases the connection back to the pool.
+            async with (
+                asyncio.timeout(TIMEOUT),
+                self._session.get(self._api_url, params=params) as resp,
+            ):
+                if resp.status >= 400:
+                    raise HolfuyConnectionError(
+                        f"Holfuy API returned HTTP {resp.status}"
+                    )
+
+                # A rejected key gets HTTP 200 with the plain text "No access".
+                if resp.content_type != "application/json":
+                    text = (await resp.text()).strip()
+                    if text.lower().startswith("no access"):
+                        raise HolfuyAuthError("Holfuy API rejected the API key")
+                    raise HolfuyError(
+                        f"Unexpected response from Holfuy API: {text[:100]!r}"
+                    )
+
+                result = await resp.json()
+
+        except (TimeoutError, aiohttp.ClientError) as err:
+            # Only the type name: aiohttp messages can contain the URL, and
+            # with it the API key.
+            raise HolfuyConnectionError(
+                f"Cannot reach Holfuy API: {type(err).__name__}"
+            ) from err
+        except ValueError as err:
+            raise HolfuyError("Unable to parse JSON response from Holfuy API") from err
+
+        # Request for a single station is not enveloped in a list of
+        # measurements objects. Make data consistent for all request types before it
+        # is returned.
+        if stations and len(stations) == 1:
+            result = {"measurements": [result]}
+
+        measurements = result.get("measurements") if isinstance(result, dict) else None
+        if not isinstance(measurements, list):
+            raise HolfuyError("Unexpected response from Holfuy API: no measurements")
+
+        if measurements and all(
+            m.get("errorCode") == "no_access" for m in measurements
+        ):
+            raise HolfuyAuthError("API key has no access to the requested stations")
+
+        return result

{pyholfuy-0.1 → pyholfuy-0.3}/holfuy/const.py

@@ -1,6 +1,6 @@
 CONF_MODE_JSON = "JSON"  # We only handle JSON from the api
-CONF_MODE_XML = "CSV"
-CONF_MODE_CSV = "XML"
+CONF_MODE_XML = "XML"
+CONF_MODE_CSV = "CSV"
 
 CONF_AVERAGING_NEWEST = 0
 CONF_AVERAGING_QUARTERLY = 1
@@ -11,8 +11,8 @@ CONF_WIND_SPEED_UNIT_KMH = "km/h"
 CONF_WIND_SPEED_UNIT_MS = "m/s"
 CONF_WIND_SPEED_UNIT_MPH = "mph"
 
-CONF_TEMPERATURE_UNIT_CELSUIS = "Celsius"
-CONF_TEMPERATURE_UNIT_FAHRENHEIT = "Fahrenheit"
+CONF_TEMPERATURE_UNIT_CELSIUS = "C"
+CONF_TEMPERATURE_UNIT_FAHRENHEIT = "F"
 
 CONF_OPTION_BATT = "batt"
 CONF_OPTION_DAILY = "daily"

pyholfuy-0.3/holfuy/exceptions.py

@@ -0,0 +1,13 @@
+"""Exceptions raised by the Holfuy library."""
+
+
+class HolfuyError(Exception):
+    """Base class for all Holfuy errors, raised as is for unexpected replies."""
+
+
+class HolfuyConnectionError(HolfuyError):
+    """The API could not be reached, timed out or returned an HTTP error."""
+
+
+class HolfuyAuthError(HolfuyError):
+    """The API key was rejected, or it has no access to any requested station."""

pyholfuy-0.3/holfuy/test_holfuy.py

@@ -0,0 +1,178 @@
+import asyncio
+from unittest import IsolatedAsyncioTestCase, mock
+from unittest.mock import AsyncMock, MagicMock, patch
+import json
+
+import aiohttp
+
+RESP_142 =  json.loads("""{"stationId":142,"stationName":"THPK Ersfjord","location":{"latitude":"69.70017",
+"longitude":"18.63842","altitude":130},"dateTime":"2025-05-19 15:45:00","wind":{"speed":9.4,"gust":13.3,"min":0,
+"unit":"m/s","direction":245},"battery":4.15,"daily":{"max_temp":0,"min_temp":0},"temperature":0}""")
+
+RESP_ALL = json.loads("""{"measurements":[{"stationId":142,"stationName":"THPK Ersfjord","location":{"latitude":"69.70017",
+"longitude":"18.63842","altitude":130},"dateTime":"2025-05-19 15:45:00","wind":{"speed":9.4,"gust":13.3,"min":0,
+"unit":"m/s","direction":245},"battery":4.15,"daily":{"max_temp":0,"min_temp":0},"temperature":0},
+{"stationId":207,"stationName":"THPK Finnvikdalen","location":{"latitude":"69.76117",
+"longitude":"18.85657","altitude":270},"dateTime":"2025-05-19 15:45:00",
+"wind":{"speed":10,"gust":13.6,"min":0,"unit":"m/s","direction":339},"battery":4.14,
+"daily":{"max_temp":7.5,"min_temp":4.5},"temperature":4.7},{"stationId":299,"stationName":"THPK Fjellheisen",
+"location":{"latitude":"69.63116","longitude":"18.99377","altitude":420},"dateTime":"2025-05-19 15:45:00",
+"wind":{"speed":7.8,"gust":10.3,"min":0,"unit":"m/s","direction":256},"battery":4.14,
+"daily":{"max_temp":5.7,"min_temp":0},"temperature":3.6}]}""")
+
+RESP_AUTHERROR=json.loads("""
+{"measurements":[{"stationId":105,"error":"Sorry, you don't have access for this station.","errorCode":"no_access"},
+{"stationId":106,"error":"Sorry, you don't have access for this station.","errorCode":"no_access"}]}""")
+
+from holfuy import (
+    HolfuyAuthError,
+    HolfuyConnectionError,
+    HolfuyService,
+)
+
+
+def _get_returning(resp):
+    """Mock session.get() as an async context manager yielding resp."""
+    ctx = MagicMock()
+    ctx.__aenter__ = AsyncMock(return_value=resp)
+    ctx.__aexit__ = AsyncMock(return_value=False)
+    return MagicMock(return_value=ctx)
+
+from holfuy.const import (
+    CONF_TEMPERATURE_UNIT_CELSIUS,
+    CONF_WIND_SPEED_UNIT_MS,
+    CONF_AVERAGING_NEWEST,
+)
+
+
+class TestHolfuyService(IsolatedAsyncioTestCase):
+    def setUp(self):
+        """Set up test cases."""
+        self.session = AsyncMock(spec=aiohttp.ClientSession)
+        self.api = HolfuyService(
+            "test_api_key",
+            self.session,
+            CONF_TEMPERATURE_UNIT_CELSIUS,
+            CONF_WIND_SPEED_UNIT_MS,
+            False,
+        )
+
+    async def test_fetch_data_single_station(self):
+        """Test fetching data for a single station."""
+        mock_response = RESP_142
+
+        mock_resp = AsyncMock()
+        mock_resp.status = 200
+        mock_resp.content_type = "application/json"
+        mock_resp.json = AsyncMock(return_value=mock_response)
+
+        self.session.get = _get_returning(mock_resp)
+
+        result = await self.api.fetch_data(["142"])
+
+        expected_params = {
+            "pw": "test_api_key",
+            "m": "JSON",
+            "tu": CONF_TEMPERATURE_UNIT_CELSIUS,
+            "su": CONF_WIND_SPEED_UNIT_MS,
+            "avg": CONF_AVERAGING_NEWEST,
+            "s": "142",
+        }
+
+        self.session.get.assert_called_once_with(
+            "https://api.holfuy.com/live/",
+            params=expected_params
+        )
+
+        self.assertEqual(result["measurements"][0]["stationId"], 142)
+
+    async def test_fetch_data_all_stations(self):
+        """Test fetching data for multiple stations."""
+        mock_response = RESP_ALL
+
+        mock_resp = AsyncMock()
+        mock_resp.status = 200
+        mock_resp.content_type = "application/json"
+        mock_resp.json = AsyncMock(return_value=mock_response)
+        self.session.get = _get_returning(mock_resp)
+
+        result = await self.api.fetch_data(None)
+
+        expected_params = {
+            "pw": "test_api_key",
+            "m": "JSON",
+            "tu": CONF_TEMPERATURE_UNIT_CELSIUS,
+            "su": CONF_WIND_SPEED_UNIT_MS,
+            "avg": CONF_AVERAGING_NEWEST,
+            "s": "all",
+        }
+
+        self.session.get.assert_called_once_with(
+            "https://api.holfuy.com/live/",
+            params=expected_params
+        )
+
+        self.assertEqual(result, mock_response)
+
+    async def test_fetch_data_error_response(self):
+        """Test handling of error responses."""
+        mock_resp = AsyncMock()
+        mock_resp.status = 404
+
+        self.session.get = _get_returning(mock_resp)
+
+        with self.assertRaises(HolfuyConnectionError):
+            await self.api.fetch_data(None)
+
+    async def test_fetch_data_invalid_access_token(self):
+        """Test handling of error responses."""
+        mock_resp = AsyncMock()
+        mock_resp.status = 200
+        mock_resp.content_type = "application/json"
+        mock_response =  RESP_AUTHERROR
+
+        mock_resp.json = AsyncMock(return_value=mock_response)
+
+        self.session.get = _get_returning(mock_resp)
+
+        with self.assertRaises(HolfuyAuthError):
+            await self.api.fetch_data(["105","106"])
+
+        expected_params = {
+            "pw": "test_api_key",
+            "m": "JSON",
+            "tu": CONF_TEMPERATURE_UNIT_CELSIUS,
+            "su": CONF_WIND_SPEED_UNIT_MS,
+            "avg": CONF_AVERAGING_NEWEST,
+            "s": "105,106",
+        }
+
+        self.session.get.assert_called_once_with(
+            "https://api.holfuy.com/live/",
+            params=expected_params
+        )
+
+    async def test_fetch_data_timeout(self):
+        """Test handling of timeout errors."""
+        self.session.get = MagicMock(side_effect=asyncio.TimeoutError)
+
+        with self.assertRaises(HolfuyConnectionError):
+            await self.api.fetch_data(None)
+
+    async def test_fetch_data_client_error(self):
+        """Test handling of client errors."""
+        self.session.get = MagicMock(side_effect=aiohttp.ClientError)
+
+        with self.assertRaises(HolfuyConnectionError):
+            await self.api.fetch_data(None)
+
+    async def test_fetch_data_rejected_key(self):
+        """A rejected key gets HTTP 200 with a plain-text "No access" body."""
+        mock_resp = AsyncMock()
+        mock_resp.status = 200
+        mock_resp.content_type = "text/html"
+        mock_resp.text = AsyncMock(return_value="No access")
+        self.session.get = _get_returning(mock_resp)
+
+        with self.assertRaises(HolfuyAuthError):
+            await self.api.fetch_data(None)

{pyholfuy-0.1 → pyholfuy-0.3/pyholfuy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyholfuy
-Version: 0.1
+Version: 0.3
 Summary: A Python library for interacting with Holfuy weather stations.
 Author-email: Håvard Dagenborg <haavardj@dagenborg.net>
 License-Expression: MIT
@@ -16,15 +16,7 @@ Provides-Extra: test
 Requires-Dist: aioresponses==0.7.8; extra == "test"
 Requires-Dist: coverage==7.8.0; extra == "test"
 Requires-Dist: mypy==1.15.0; extra == "test"
-Requires-Dist: pytest-asyncio==0.26.0; extra == "test"
-Requires-Dist: pytest-cov==6.1.1; extra == "test"
-Requires-Dist: pytest-error-for-skips==2.0.2; extra == "test"
-Requires-Dist: pytest-timeout==2.3.1; extra == "test"
-Requires-Dist: pytest==8.3.5; extra == "test"
-Requires-Dist: ruff==0.11.7; extra == "test"
-Requires-Dist: syrupy==4.9.1; extra == "test"
 Provides-Extra: dev
-Requires-Dist: pre-commit==4.2.0; extra == "dev"
 Dynamic: license-file
 
 ![Holfy Logo](https://holfuy.com/image/logo/holfuy-logo.png)
@@ -34,7 +26,7 @@ A Python library for talking to [Holfuy Weather Stations](https://holfuy.com/).
 
 You need an API key to access the service. To obtain one, please visit the [Holfuy API](https://api.holfuy.com/live/) pages.
 
-The Library only access live data.
+The library can only access live data.
 
 ## Example Code
 Here is an example of how to use the library.
@@ -46,10 +38,22 @@ from holfuy import HolfuyService
 
 async def main():
     async with aiohttp.ClientSession() as session:
-    s = HolfuyService("", session)
-    data = await s.fetch_data(["101"])
-    print(data)
+        s = HolfuyService("", session)
+        data = await s.fetch_data(["101"])
+        print(data)
 
 if __name__ == "__main__":
     asyncio.run(main())
 ```
+
+## Return value and errors
+
+`fetch_data()` returns `{"measurements": [...]}` with one entry per station, also when
+a single station is requested. A station the key cannot read is still listed, with
+`error` and `errorCode` instead of data.
+
+It raises, all subclasses of `holfuy.HolfuyError`:
+
+- `HolfuyAuthError`: the API key is rejected, or it has no access to any requested station.
+- `HolfuyConnectionError`: network error, timeout, or an HTTP error status.
+- `HolfuyError`: any other unexpected reply.

{pyholfuy-0.1 → pyholfuy-0.3}/pyholfuy.egg-info/SOURCES.txt

@@ -4,6 +4,8 @@ README.md
 pyproject.toml
 holfuy/__init__.py
 holfuy/const.py
+holfuy/exceptions.py
+holfuy/test_holfuy.py
 pyholfuy.egg-info/PKG-INFO
 pyholfuy.egg-info/SOURCES.txt
 pyholfuy.egg-info/dependency_links.txt

pyholfuy-0.3/pyholfuy.egg-info/requires.txt

@@ -0,0 +1,8 @@
+aiohttp>=3.9.4
+
+[dev]
+
+[test]
+aioresponses==0.7.8
+coverage==7.8.0
+mypy==1.15.0

{pyholfuy-0.1 → pyholfuy-0.3}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyholfuy"
-version = "0.1"
+version = "0.3"
 description = "A Python library for interacting with Holfuy weather stations."
 authors = [{name="Håvard Dagenborg", email="haavardj@dagenborg.net"}]
 license = "MIT"
@@ -29,24 +29,11 @@ test = [
   "aioresponses==0.7.8",
   "coverage==7.8.0",
   "mypy==1.15.0",
-  "pytest-asyncio==0.26.0",
-  "pytest-cov==6.1.1",
-  "pytest-error-for-skips==2.0.2",
-  "pytest-timeout==2.3.1",
-  "pytest==8.3.5",
-  "ruff==0.11.7",
-  "syrupy==4.9.1",
 ]
 dev = [
-  "pre-commit==4.2.0",
 ]
 
-[tool.ruff]
-line-length = 88
-indent-width = 4
-select = ["E", "F", "W", "C", "N", "Q"]
 
 [tool.pylint]
 max-line-length = 88
 disable = ["C0114", "C0115", "C0116"]
-

pyholfuy-0.1/README.md

@@ -1,26 +0,0 @@
-![Holfy Logo](https://holfuy.com/image/logo/holfuy-logo.png)
-
-# PyHolfuy
-A Python library for talking to [Holfuy Weather Stations](https://holfuy.com/).
-
-You need an API key to access the service. To obtain one, please visit the [Holfuy API](https://api.holfuy.com/live/) pages.
-
-The Library only access live data.
-
-## Example Code
-Here is an example of how to use the library.
-
-```python
-import aiohttp
-import asyncio
-from holfuy import HolfuyService
-
-async def main():
-    async with aiohttp.ClientSession() as session:
-    s = HolfuyService("", session)
-    data = await s.fetch_data(["101"])
-    print(data)
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```

pyholfuy-0.1/holfuy/__init__.py

@@ -1,131 +0,0 @@
-"""Library to handle connection with Holfuy Live API."""
-
-import asyncio
-import logging
-
-from typing import Any
-
-import aiohttp
-
-from .const import (
-    CONF_TEMPERATURE_UNIT_CELSUIS,
-    CONF_WIND_SPEED_UNIT_MS,
-    CONF_AVERAGING_NEWEST,
-    CONF_MODE_JSON,
-    STATIONS_ALL,
-)
-
-TIMEOUT = 30
-_LOGGER = logging.getLogger(__name__)
-
-API_URL = "http://api.holfuy.com/live/"
-
-# noqa: E501
-#### API Description
-# URL Format:  http://api.holfuy.com/live/?s=101&pw=pass&m=JSON&tu=C&su=m/s
-#
-# s: station(s) ID e.g. s=101 or you can get the data from more stations by one query as well (coma separated list) e.g. s=101,102,103 . If you would get all stations' data (to which you have access) by one single API call please use the "all" string -> s=all .
-# pw: password for the API access (it could be sent by a POST "pw" parameter also)
-# m:mode XML or CSV or JSON default: CSV
-# avg:averaging "0": newest data from the station, "1" newest quarter hourly average, "2" newest hourly average (default = 0)
-# su: wind speed unit: knots, km/h, m/s, mph, default: m/s
-# tu: temperature unit C:Celsius , F: Fahrenheit default: Celsius
-# batt: add this parameter to get the station's battery voltage (JSON only).
-# cam: add this parameter to the URL for timestamp of the last picture from the camera. (JSON only, only for stations with a camera)
-# daily: add this parameter to get daily Max-Min temperatures and precipitation since last midnight CE(S)T (JSON only, max 5 stations)
-# loc: add this parameter to the URL to get the station's location in reply too (JSON only)
-# utc: add this parameter to the URL for timestamps in UTC, otherwise times will be in CE(S)T
-# Data: DateTime: time of the last data / average in ".date('T')." (Central European Time) or in UTC if utc param is set.
-#####
-
-
-class HolfuyService:
-    """Representation of Holfuy weather data."""
-
-    def __init__(
-        self,
-        api_key: str,
-        websession=None,
-        temperature_unit=CONF_TEMPERATURE_UNIT_CELSUIS,
-        wind_speed_unit=CONF_WIND_SPEED_UNIT_MS,
-        timestamps_in_utc=False,
-    ) -> None:
-        """Initialize the Weather object."""
-
-        self._api_url = API_URL
-        self._api_key = api_key
-        self._wind_speed_unit = wind_speed_unit
-        self._temperature_unit = temperature_unit
-        self._timestamps_in_utc = timestamps_in_utc
-
-        if websession is None:
-
-            async def _create_session():
-                return aiohttp.ClientSession()
-
-            loop = asyncio.get_event_loop()
-            self._websession = loop.run_until_complete(_create_session())
-        else:
-            self._websession = websession
-
-    async def fetch_data(
-        self,
-        stations: list[str] | None = None,
-        averaging_mode=CONF_AVERAGING_NEWEST,
-        include_battery=False,
-        include_daily=False,
-        include_location=False,
-    ) -> dict[str, Any] | None:
-        """Get the latest data from Holfuy."""
-
-        params = {
-            "pw": self._api_key,
-            "m": CONF_MODE_JSON,
-            "tu": self._temperature_unit,
-            "su": self._wind_speed_unit,
-            "avg": averaging_mode,
-        }
-
-        if self._timestamps_in_utc:
-            params["utc"] = ""
-
-        if include_battery:
-            params["batt"] = ""
-
-        if include_daily:
-            params["daily"] = ""
-
-        if include_location:
-            params["loc"] = ""
-
-        if stations:
-            params["s"] = ",".join(map(str, stations))
-        else:
-            params["s"] = STATIONS_ALL
-
-        try:
-            async with asyncio.timeout(TIMEOUT):
-                resp = await self._websession.get(self._api_url, params=params)
-
-            if resp.status >= 400:
-                _LOGGER.error("%s returned %s", self._api_url, resp.status)
-                return None
-
-            result = await resp.json()
-
-            # Request for a single station is not enveloped in a list of
-            # measurements objects. Make data consistent for all request types before it
-            #  is returned.
-            if stations and len(stations) == 1:
-                result = {"measurements": result}
-
-            return result
-
-        except (TimeoutError, aiohttp.ClientError) as err:
-            _LOGGER.error(
-                "Access to %s returned error '%s'", self._api_url, type(err).__name__
-            )
-            return None
-        except ValueError:
-            _LOGGER.exception("Unable to parse json response from %s", self._api_url)
-            return None

pyholfuy-0.1/pyholfuy.egg-info/requires.txt

@@ -1,16 +0,0 @@
-aiohttp>=3.9.4
-
-[dev]
-pre-commit==4.2.0
-
-[test]
-aioresponses==0.7.8
-coverage==7.8.0
-mypy==1.15.0
-pytest-asyncio==0.26.0
-pytest-cov==6.1.1
-pytest-error-for-skips==2.0.2
-pytest-timeout==2.3.1
-pytest==8.3.5
-ruff==0.11.7
-syrupy==4.9.1