leapmotor-api 0.1.0__py3-none-any.whl

leapmotor_api/__init__.py

@@ -0,0 +1,93 @@
+"""Leapmotor API — Unofficial Python client for the Leapmotor vehicle cloud API."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+from .client import LeapmotorApiClient, normalize_vehicle
+from .const import (
+    DEFAULT_BASE_URL,
+    DEFAULT_LANGUAGE,
+    REMOTE_ACTION_SPECS,
+    REMOTE_CTL_AC_SWITCH,
+    REMOTE_CTL_BATTERY_PREHEAT,
+    REMOTE_CTL_FIND_CAR,
+    REMOTE_CTL_LOCK,
+    REMOTE_CTL_QUICK_COOL,
+    REMOTE_CTL_QUICK_HEAT,
+    REMOTE_CTL_SUNSHADE,
+    REMOTE_CTL_SUNSHADE_CLOSE,
+    REMOTE_CTL_SUNSHADE_OPEN,
+    REMOTE_CTL_TRUNK,
+    REMOTE_CTL_TRUNK_CLOSE,
+    REMOTE_CTL_TRUNK_OPEN,
+    REMOTE_CTL_UNLOCK,
+    REMOTE_CTL_WINDSHIELD_DEFROST,
+    REMOTE_CTL_WINDOWS,
+    REMOTE_CTL_WINDOWS_CLOSE,
+    REMOTE_CTL_WINDOWS_OPEN,
+)
+from .exceptions import (
+    LeapmotorAccountCertError,
+    LeapmotorApiError,
+    LeapmotorAuthError,
+    LeapmotorMissingAppCertError,
+)
+from .models import (
+    BatteryStatus,
+    ClimateStatus,
+    ConnectivityStatus,
+    DoorStatus,
+    DrivingStatus,
+    IgnitionStatus,
+    LocationStatus,
+    RemoteActionResult,
+    RemoteActionSpec,
+    TirePressure,
+    Vehicle,
+    VehicleStatus,
+    WindowStatus,
+)
+
+__all__ = [
+    "__version__",
+    "BatteryStatus",
+    "ClimateStatus",
+    "ConnectivityStatus",
+    "DEFAULT_BASE_URL",
+    "DEFAULT_LANGUAGE",
+    "DoorStatus",
+    "DrivingStatus",
+    "IgnitionStatus",
+    "LeapmotorAccountCertError",
+    "LeapmotorApiClient",
+    "LeapmotorApiError",
+    "LeapmotorAuthError",
+    "LeapmotorMissingAppCertError",
+    "LocationStatus",
+    "REMOTE_ACTION_SPECS",
+    "REMOTE_CTL_AC_SWITCH",
+    "REMOTE_CTL_BATTERY_PREHEAT",
+    "REMOTE_CTL_FIND_CAR",
+    "REMOTE_CTL_LOCK",
+    "REMOTE_CTL_QUICK_COOL",
+    "REMOTE_CTL_QUICK_HEAT",
+    "REMOTE_CTL_SUNSHADE",
+    "REMOTE_CTL_SUNSHADE_CLOSE",
+    "REMOTE_CTL_SUNSHADE_OPEN",
+    "REMOTE_CTL_TRUNK",
+    "REMOTE_CTL_TRUNK_CLOSE",
+    "REMOTE_CTL_TRUNK_OPEN",
+    "REMOTE_CTL_UNLOCK",
+    "REMOTE_CTL_WINDSHIELD_DEFROST",
+    "REMOTE_CTL_WINDOWS",
+    "REMOTE_CTL_WINDOWS_CLOSE",
+    "REMOTE_CTL_WINDOWS_OPEN",
+    "RemoteActionResult",
+    "RemoteActionSpec",
+    "TirePressure",
+    "Vehicle",
+    "VehicleStatus",
+    "WindowStatus",
+    "normalize_vehicle",
+]

leapmotor_api/async_client.py

@@ -0,0 +1,125 @@
+"""Async wrapper for the Leapmotor API client.
+
+Wraps the synchronous ``LeapmotorApiClient`` using ``asyncio.to_thread()``
+to provide a non-blocking interface for async frameworks (Home Assistant,
+FastAPI, etc.).
+"""
+
+from __future__ import annotations
+
+import asyncio
+from typing import Any
+
+from .client import LeapmotorApiClient
+from .models import Vehicle, VehicleStatus
+
+
+class AsyncLeapmotorApiClient:
+    """Async wrapper around :class:`LeapmotorApiClient`.
+
+    All methods delegate to the sync client via ``asyncio.to_thread()``.
+    """
+
+    def __init__(self, client: LeapmotorApiClient) -> None:
+        self._client = client
+
+    @property
+    def client(self) -> LeapmotorApiClient:
+        """Access the underlying synchronous client."""
+        return self._client
+
+    async def close(self) -> None:
+        await asyncio.to_thread(self._client.close)
+
+    async def login(self) -> None:
+        await asyncio.to_thread(self._client.login)
+
+    async def fetch_data(self) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.fetch_data)
+
+    async def get_vehicle_list(self) -> list[Vehicle]:
+        return await asyncio.to_thread(self._client.get_vehicle_list)
+
+    async def get_vehicle_status(self, vehicle: Vehicle) -> VehicleStatus:
+        return await asyncio.to_thread(self._client.get_vehicle_status, vehicle)
+
+    async def get_vehicle_raw_status(self, vehicle: Vehicle) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.get_vehicle_raw_status, vehicle)
+
+    async def get_mileage_energy_detail(self, vehicle: Vehicle) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.get_mileage_energy_detail, vehicle)
+
+    async def get_car_picture(self, vehicle: Vehicle) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.get_car_picture, vehicle)
+
+    async def lock_vehicle(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.lock_vehicle, vin)
+
+    async def unlock_vehicle(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.unlock_vehicle, vin)
+
+    async def open_trunk(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.open_trunk, vin)
+
+    async def close_trunk(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.close_trunk, vin)
+
+    async def find_vehicle(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.find_vehicle, vin)
+
+    async def control_sunshade(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.control_sunshade, vin)
+
+    async def open_sunshade(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.open_sunshade, vin)
+
+    async def close_sunshade(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.close_sunshade, vin)
+
+    async def battery_preheat(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.battery_preheat, vin)
+
+    async def windows(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.windows, vin)
+
+    async def open_windows(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.open_windows, vin)
+
+    async def close_windows(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.close_windows, vin)
+
+    async def ac_switch(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.ac_switch, vin)
+
+    async def quick_cool(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.quick_cool, vin)
+
+    async def quick_heat(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.quick_heat, vin)
+
+    async def windshield_defrost(self, vin: str) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.windshield_defrost, vin)
+
+    async def set_charge_limit(self, vin: str, charge_limit_percent: int) -> dict[str, Any]:
+        return await asyncio.to_thread(self._client.set_charge_limit, vin, charge_limit_percent)
+
+    async def send_destination(
+        self,
+        vin: str,
+        *,
+        address: str,
+        address_name: str,
+        latitude: float,
+        longitude: float,
+    ) -> dict[str, Any]:
+        return await asyncio.to_thread(
+            self._client.send_destination,
+            vin,
+            address=address,
+            address_name=address_name,
+            latitude=latitude,
+            longitude=longitude,
+        )
+
+    async def download_car_picture_package(self, *, picture_key: str) -> bytes:
+        return await asyncio.to_thread(self._client.download_car_picture_package, picture_key=picture_key)