googlewifiapi 0.1.0__py3-none-any.whl

googlewifiapi/__init__.py

@@ -0,0 +1,5 @@
+from .api import GoogleWifiAPI
+from .const import LOGGER
+from .status import GoogleWifiStatus
+
+__all__ = ["GoogleWifiAPI", "GoogleWifiStatus", "LOGGER"]

googlewifiapi/api.py

@@ -0,0 +1,57 @@
+"""Google Wifi API wrapper."""
+
+from typing import Any
+
+import aiohttp
+from yarl import URL
+
+from .const import DEFAULT_HOST, ENDPOINT
+from .exception import (
+    GoogleWifiClientError,
+    GoogleWifiDataValidationError,
+    GoogleWifiException,
+)
+from .status import GoogleWifiStatus
+
+
+class GoogleWifiAPI:
+    """Get the latest data and update the states."""
+
+    raw_data: dict[str, Any] | None = None
+    available: bool = True
+    _resource: URL
+    data: GoogleWifiStatus | None = None
+    sess: aiohttp.ClientSession
+
+    def __init__(
+        self, host: str = DEFAULT_HOST, sess: aiohttp.ClientSession | None = None
+    ) -> None:
+        """Initialize the API wrapper."""
+        self._resource = URL(f"http://{host}{ENDPOINT}")
+        self.sess = sess or aiohttp.ClientSession()
+
+    async def async_update(self) -> GoogleWifiStatus:
+        """Get the latest data from the router."""
+        try:
+            resp = await self.sess.get(self._resource)
+            raw_data = await resp.json()
+        except (aiohttp.ClientError, ValueError) as err:
+            raise GoogleWifiClientError() from err
+
+        if not isinstance(raw_data, dict):
+            raise GoogleWifiDataValidationError(
+                f"The router provided data that could not be validated. "
+                f"Raw data: {raw_data}"
+            )
+
+        self.raw_data = raw_data
+        try:
+            self.data = GoogleWifiStatus.from_dict(raw_data)
+            return self.data
+        except (LookupError, TypeError, ValueError) as err:
+            raise GoogleWifiDataValidationError(
+                f"The router provided data that could not be validated. "
+                f"Raw data: {raw_data}"
+            ) from err
+        except Exception as err:
+            raise GoogleWifiException() from err

googlewifiapi/const.py

@@ -0,0 +1,7 @@
+"""Constants for the Google Wifi API wrapper."""
+
+import logging
+
+DEFAULT_HOST = "192.168.86.1"
+ENDPOINT = "/api/v1/status"
+LOGGER = logging.getLogger(__package__)

googlewifiapi/exception.py

@@ -0,0 +1,13 @@
+"""Exceptions for the Google Wifi API Wrapper."""
+
+
+class GoogleWifiException(Exception):
+    """Raised when there is a generic exception while wrapping the API."""
+
+
+class GoogleWifiDataValidationError(GoogleWifiException):
+    """Raised when the data cannot be validated."""
+
+
+class GoogleWifiClientError(GoogleWifiException):
+    """Raised when the connection fails in some way."""

googlewifiapi/status.py

@@ -0,0 +1,93 @@
+"""Google Wifi Status using mashumaro dataclasses."""
+
+import ipaddress
+from dataclasses import dataclass, field
+from datetime import datetime, timedelta
+from typing import Literal, Union
+
+from mashumaro import DataClassDictMixin
+from mashumaro.config import BaseConfig
+
+
+IPAddress = Union[ipaddress.IPv4Address, ipaddress.IPv6Address]
+
+
+@dataclass(frozen=True)
+class GoogleWifiStatus(DataClassDictMixin):
+    """Google Wifi status."""
+
+    dns: "GoogleWifiStatus.DNS"
+    software: "GoogleWifiStatus.Software"
+    system: "GoogleWifiStatus.System"
+    wan: "GoogleWifiStatus.WAN"
+
+    class Config(BaseConfig):
+        serialize_by_alias = True
+        deserialize_by_alias = True
+
+    @dataclass(frozen=True)
+    class DNS(DataClassDictMixin):
+        mode: Literal["automatic", "custom"]
+        servers: list[IPAddress]
+
+    @dataclass(frozen=True)
+    class Software(DataClassDictMixin):
+        software_version: str
+        update_status: str
+        update_required: bool
+        update_progress: float
+
+        class Config(BaseConfig):
+            serialize_by_alias = True
+            deserialize_by_alias = True
+            aliases = {
+                "software_version": "softwareVersion",
+                "update_status": "updateStatus",
+                "update_required": "updateRequired",
+                "update_progress": "updateProgress",
+            }
+
+    @dataclass(frozen=True)
+    class System(DataClassDictMixin):
+        country_code: str
+        model_id: str
+        uptime: int
+        last_restart: datetime = field(init=False)
+
+        class Config(BaseConfig):
+            serialize_by_alias = True
+            deserialize_by_alias = True
+            aliases = {
+                "country_code": "countryCode",
+                "model_id": "modelId",
+            }
+
+        def __post_init__(self):
+            """Compute last_restart from uptime."""
+            object.__setattr__(
+                self,
+                "last_restart",
+                datetime.now() - timedelta(seconds=self.uptime),
+            )
+
+    @dataclass(frozen=True)
+    class WAN(DataClassDictMixin):
+        online: bool
+        ethernet_link: bool
+        gateway_ip_address: IPAddress
+        local_ip_address: IPAddress
+        ip_method: str
+        ip_prefix_length: int
+        name_servers: list[IPAddress]
+
+        class Config(BaseConfig):
+            serialize_by_alias = True
+            deserialize_by_alias = True
+            aliases = {
+                "ethernet_link": "ethernetLink",
+                "gateway_ip_address": "gatewayIpAddress",
+                "local_ip_address": "localIpAddress",
+                "ip_method": "ipMethod",
+                "ip_prefix_length": "ipPrefixLength",
+                "name_servers": "nameServers",
+            }

googlewifiapi-0.1.0.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: googlewifiapi
+Version: 0.1.0
+Summary: Asynchronous Python wrapper for the local Google Wifi JSON API
+Author-email: Eddie Reasoner <eddie.reasoner@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/EReaso/GoogleWifiApi
+Project-URL: Bug Tracker, https://github.com/EReaso/GoogleWifiApi/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: aiohttp<3.14.0,>=3.11.0
+Requires-Dist: mashumaro>=3.22
+Requires-Dist: yarl>=1.24.5
+Dynamic: license-file
+
+# googlewifiapi
+
+An asynchronous Python client for reading status from the local JSON API exposed
+by Google Wifi routers.
+The package is designed for integrations such as Home Assistant, but can be used by any Python application that needs router status data.
+
+## About this README
+
+This README was generated by AI with human review.
+All code is either written by a human or is thoroughly reviewed.
+I'll try to keep the README updated, but sometimes I might forget.
+
+## Requirements
+
+- Python 3.13 or newer
+- A Google Wifi router reachable on the local network
+
+## Installation
+
+```bash
+pip install googlewifiapi
+```
+
+## Usage
+
+Pass an `aiohttp.ClientSession` to the client so your application controls the
+session lifecycle:
+
+```python
+import asyncio
+
+import aiohttp
+
+from googlewifiapi import GoogleWifiAPI
+
+
+async def main() -> None:
+    async with aiohttp.ClientSession() as session:
+        router = GoogleWifiAPI(host="192.168.86.1", sess=session)
+        await router.async_update()
+
+        if router.data is not None:
+            print(router.data.wan.online)
+            print(router.data.software.software_version)
+            print(router.data.system.last_restart)
+
+
+asyncio.run(main())
+```
+
+The host defaults to `192.168.86.1`. After a successful update:
+
+- `router.raw_data` contains the raw JSON response.
+- `router.data` contains a validated, typed `GoogleWifiStatus`.
+- IP address fields are parsed as `IPv4Address` or `IPv6Address` objects.
+- `system.last_restart` is calculated from the router's uptime.
+
+The status object exposes `dns`, `software`, `system`, and `wan` sections. Their
+fields use Python names such as `software_version`, `gateway_ip_address`, and
+`ip_prefix_length`, while the client handles the router API's camelCase keys.
+
+## Errors
+
+All library errors inherit from `GoogleWifiException`:
+
+- `GoogleWifiClientError` indicates a request, connection, timeout, or JSON
+  decoding failure.
+- `GoogleWifiDataValidationError` indicates that the response does not match
+  the expected status schema.
+
+## Development
+
+Install the test dependencies and run the test suite with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv sync --group test
+uv run pytest
+```
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE.txt](LICENSE.txt).
+
+## Disclaimer
+
+This is an independent, community-developed project and is not affiliated with
+or endorsed by Google LLC. It relies on a local API that Google may change or
+remove without notice.

googlewifiapi-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+googlewifiapi/__init__.py,sha256=vFHdWJlq6-StukcpM6lp1fv7SFC0IznlJiI6-s9TqCI,153
+googlewifiapi/api.py,sha256=G9iVBrh5UTn0OaIbjE9xIHLv8hQFFUSbDtRfB7onXN4,1801
+googlewifiapi/const.py,sha256=iqyR3lS01vQXVKuHg4vf1QOuGxcPb4lJ3tcPjjtaT7A,164
+googlewifiapi/exception.py,sha256=Np7EofKO8CyMYwPpWeW0yPeFV9UbX4pBPhhDnI_4ROY,385
+googlewifiapi/status.py,sha256=5ZVbujcgqkHF4hZv3UoXx4qE9ps64gsu-0ZAvT_ojak,2778
+googlewifiapi-0.1.0.dist-info/licenses/LICENSE.txt,sha256=l2iRY7G89sXwOXio9L2752hqHxP9bOmaX49p6jCLUiE,1071
+googlewifiapi-0.1.0.dist-info/METADATA,sha256=sVrW_lZB0XhR62qFxuZupHcw6I1SVajaA7smbKLepT0,3129
+googlewifiapi-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+googlewifiapi-0.1.0.dist-info/top_level.txt,sha256=rxzXa5_G4xRQvIYMBB2cafHTT2QqJhNbEoWLwmhQ_1Q,14
+googlewifiapi-0.1.0.dist-info/RECORD,,

googlewifiapi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

googlewifiapi-0.1.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 Eddie Reasoner
+
+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.

googlewifiapi-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+googlewifiapi