pyaqvify 0.0.1__tar.gz

pyaqvify-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Åke Strandberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyaqvify-0.0.1/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: pyaqvify
+Version: 0.0.1
+Summary: Python async library for PyAqvify integration with Home Assistant
+Author-email: Ake Strandberg <ake@strandberg.eu>
+License: MIT
+Project-URL: Repository, https://github.com/astrandb/pyaqvify
+Project-URL: BugTracker, https://github.com/astrandb/pyaqvify/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Requires-Python: >=3.14.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Dynamic: license-file
+
+## pyaqvify
+
+Python library for Aqvify integration with Home Assistant.
+The library is distributed via pypi.org.
+
+### Installation
+
+```bash
+$ pip install pyaqvify
+```

pyaqvify-0.0.1/README.md

@@ -0,0 +1,10 @@
+## pyaqvify
+
+Python library for Aqvify integration with Home Assistant.
+The library is distributed via pypi.org.
+
+### Installation
+
+```bash
+$ pip install pyaqvify
+```

pyaqvify-0.0.1/pyaqvify/__init__.py

@@ -0,0 +1,14 @@
+"""Library for Aqvify integration with Home Assistant."""
+
+from .const import VERSION as __version__
+from .model import AqvifyAccount, AqvifyDeviceData, AqvifyDevices
+from .pyaqvify import AqvifyAPI, AqvifyAuthException
+
+__all__ = [
+    "AqvifyAPI",
+    "AqvifyAccount",
+    "AqvifyAuthException",
+    "AqvifyDeviceData",
+    "AqvifyDevices",
+    "__version__",
+]

pyaqvify-0.0.1/pyaqvify/const.py

@@ -0,0 +1,7 @@
+"""Constants for pyaqvify."""
+
+VERSION = "0.0.1"
+
+AQVIFY_API = "https://public.aqvify.com/api/v1"
+
+AIO_TIMEOUT = 15

pyaqvify-0.0.1/pyaqvify/model.py

@@ -0,0 +1,71 @@
+"""Data models for Aqvify API."""
+
+
+class AqvifyDevices:
+    """Data for all devices from API."""
+
+    def __init__(self, raw_data: dict) -> None:
+        """Initialize AqvifyDevices."""
+        self.raw_data = raw_data
+
+    @property
+    def raw(self) -> dict:
+        """Return raw data."""
+        return self.raw_data
+
+    @property
+    def devices(self) -> list[str]:
+        """Return list of all devices."""
+
+        return list(self.raw_data.keys())
+
+
+class AqvifyDeviceData:
+    """Data for a single device from API."""
+
+    def __init__(self, raw_data: dict) -> None:
+        """Initialize AqvifyDeviceData."""
+        self.raw_data = raw_data
+
+    @property
+    def raw(self) -> dict:
+        """Return raw data."""
+        return self.raw_data
+
+    @property
+    def date_time(self) -> str | None:
+        """Return the date and time."""
+        return self.raw_data.get("dateTime")
+
+    @property
+    def water_level(self) -> int | float | None:
+        """Return the water level."""
+        return self.raw_data.get("waterLevel")
+
+    @property
+    def meter_value(self) -> int | float | None:
+        """Return the meter value."""
+        return self.raw_data.get("meterValue")
+
+    @property
+    def status(self) -> str | None:
+        """Return the status."""
+        return self.raw_data.get("status")
+
+
+class AqvifyAccount:
+    """Data for account from API."""
+
+    def __init__(self, raw_data: dict) -> None:
+        """Initialize AqvifyAccount."""
+        self.raw_data = raw_data
+
+    @property
+    def raw(self) -> dict:
+        """Return raw data."""
+        return self.raw_data
+
+    @property
+    def account_id(self) -> str:
+        """Return the account ID."""
+        return self.raw_data.get("accountId", "")

pyaqvify-0.0.1/pyaqvify/pyaqvify.py

@@ -0,0 +1,95 @@
+"""Library for Aqvify API."""
+
+import asyncio
+import logging
+from typing import Any
+
+from aiohttp import ClientResponse, ClientResponseError, ClientSession
+
+from .const import AIO_TIMEOUT, AQVIFY_API as AQVIFY_API
+
+_LOGGER = logging.getLogger(__name__)
+
+ACCEPT_DATA = "application/json"
+
+
+class AqvifyAPI:
+    """Class to communicate with the Aqvify API."""
+
+    def __init__(self, api_key: str, websession: ClientSession) -> None:
+        """Initialize the API and store the api_key so we can make requests."""
+        self.api_key = api_key
+        self.websession = websession
+
+    async def request(
+        self, method: str, endpoint: str, **kwargs: Any
+    ) -> ClientResponse:
+        """Make a request."""
+        if headers := kwargs.pop("headers", {}):
+            headers = dict(headers)
+
+        headers["x-api-secret"] = self.api_key
+
+        res = await self.websession.request(
+            method,
+            f"{AQVIFY_API}{endpoint}",
+            **kwargs,
+            headers=headers,
+        )
+        res.raise_for_status()
+        return res
+
+    async def authenticate(self) -> bool:
+        """Test if we can authenticate with the host."""
+        try:
+            await self.get_account_id()
+        except AqvifyAuthException:
+            return False
+        return True
+
+    async def get_devices(self) -> dict[str, Any]:
+        """Get all devices."""
+        async with asyncio.timeout(AIO_TIMEOUT):
+            res = await self.request(
+                "GET",
+                endpoint="/Device/Devices",
+                headers={"Accept": ACCEPT_DATA},
+            )
+            res.raise_for_status()
+        return await res.json()
+
+    async def get_device_latest_data(self, device_id: str) -> dict[str, Any]:
+        """Get data for a specific device."""
+        async with asyncio.timeout(AIO_TIMEOUT):
+            res = await self.request(
+                "GET",
+                endpoint=f"/DeviceData/LatestValue/?deviceKey={device_id}",
+                headers={"Accept": ACCEPT_DATA},
+            )
+            res.raise_for_status()
+        return await res.json()
+
+    async def get_account_id(self) -> dict[str, Any]:
+        """Get current account_id from api."""
+        try:
+            res = await self.request(
+                "GET",
+                endpoint="/User/GetAccountId",
+                headers={"Accept": ACCEPT_DATA},
+            )
+            return await res.json()
+        except ClientResponseError as exc:
+            _LOGGER.debug(
+                "API get_account_id failed. Status: %s, - %s", exc.code, exc.message
+            )
+            if exc.code == 401:
+                raise AqvifyAuthException from exc
+            raise
+
+
+class AqvifyException(Exception):
+    """Generic aqvify exception."""
+
+
+class AqvifyAuthException(AqvifyException):
+    """Authentication failure."""

pyaqvify-0.0.1/pyaqvify.egg-info/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: pyaqvify
+Version: 0.0.1
+Summary: Python async library for PyAqvify integration with Home Assistant
+Author-email: Ake Strandberg <ake@strandberg.eu>
+License: MIT
+Project-URL: Repository, https://github.com/astrandb/pyaqvify
+Project-URL: BugTracker, https://github.com/astrandb/pyaqvify/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Requires-Python: >=3.14.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Dynamic: license-file
+
+## pyaqvify
+
+Python library for Aqvify integration with Home Assistant.
+The library is distributed via pypi.org.
+
+### Installation
+
+```bash
+$ pip install pyaqvify
+```

pyaqvify-0.0.1/pyaqvify.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+pyaqvify/__init__.py
+pyaqvify/const.py
+pyaqvify/model.py
+pyaqvify/py.typed
+pyaqvify/pyaqvify.py
+pyaqvify.egg-info/PKG-INFO
+pyaqvify.egg-info/SOURCES.txt
+pyaqvify.egg-info/dependency_links.txt
+pyaqvify.egg-info/requires.txt
+pyaqvify.egg-info/top_level.txt

pyaqvify-0.0.1/pyaqvify.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyaqvify-0.0.1/pyaqvify.egg-info/requires.txt

@@ -0,0 +1 @@
+aiohttp

pyaqvify-0.0.1/pyaqvify.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyaqvify

pyaqvify-0.0.1/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["setuptools>=80.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyaqvify"
+license = { text = "MIT" }
+dynamic = ["version"]
+authors = [{ name = "Ake Strandberg", email = "ake@strandberg.eu" }]
+description = "Python async library for PyAqvify integration with Home Assistant"
+readme = "README.md"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Development Status :: 4 - Beta",
+]
+dependencies = ["aiohttp"]
+requires-python = ">=3.14.0"
+
+[project.urls]
+Repository = "https://github.com/astrandb/pyaqvify"
+BugTracker = "https://github.com/astrandb/pyaqvify/issues"
+
+[tool.setuptools.dynamic]
+version = { attr = "pyaqvify.const.VERSION" }
+
+[tool.setuptools.packages.find]
+include = ["pyaqvify*"]
+
+[tool.mypy]
+python_version = "3.14"
+strict = true
+
+[tool.ruff]
+lint.select = [
+    "A",     # builtins shadowing
+    "ANN",   # annotations
+    "ASYNC", # async
+    "B",     # bugbear
+    "C4",    # comprehensions
+    "D",     # pydocstyle
+    "E",     # pycodestyle
+    "F",     # pyflakes
+    "FLY",   # flynt
+    "FURB",  # refurb
+    "G",     # logging
+    "I",     # isort
+    "LOG",   # logging
+    "PTH",   # pathlib
+    "RUF",   # ruff specific
+    "SLF",   # private member access
+    "SIM",   # simplify
+    "T20",   # print
+    "UP",    # pyupgrade
+    "W",     # pydocstyle warning
+]
+lint.ignore = [
+    "ANN401", # any-type
+    "D202",   # blank-line-after-function
+    "D203",   # incorrect-blank-line-before-class
+    "D212",   # multi-line-summary-first-line
+    "E501",   # line too long
+    "SIM102", # collapsible-if
+    "SIM105", # suppressible-exception
+]
+
+[tool.ruff.lint.isort]
+force-sort-within-sections = true
+combine-as-imports = true

pyaqvify-0.0.1/setup.cfg

@@ -0,0 +1,7 @@
+[bumpversion]
+current_version = 0.0.1
+
+[egg_info]
+tag_build = 
+tag_date = 0
+