myvsb-developer-api 1.0.1__tar.gz → 1.0.3__tar.gz

{myvsb_developer_api-1.0.1/src/myvsb_developer_api.egg-info → myvsb_developer_api-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: myvsb-developer-api
-Version: 1.0.1
+Version: 1.0.3
 Summary: Asynchronous Python library for the MyVSB Developer API
 Author-email: net0045 <stepan.netolicky@vsb.cz>
 Project-URL: Homepage, https://github.com/mobility-lab-vsb/myvsb-developer-api

{myvsb_developer_api-1.0.1 → myvsb_developer_api-1.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "myvsb-developer-api"
-version = "1.0.1"
+version = "1.0.3"
 authors = [
   { name="net0045", email="stepan.netolicky@vsb.cz" },
 ]

{myvsb_developer_api-1.0.1 → myvsb_developer_api-1.0.3}/src/myskoda_openapi/api_layer/exceptions.py

@@ -25,6 +25,10 @@ class OpenApiVehicleNotFoundError(OpenApiError):
     def __init__(self, message: str = "Vehicle with this VIN does not exist.") -> None:
         super().__init__(message, status_code=404)
 
+class OpenApiUnsupportedError(OpenApiError):
+    """Error 422 - Unsupported operation."""
+    def __init__(self, message: str = "Vehicle does not support this operation") -> None:
+        super().__init__(message, status_code=422)
 
 class OpenApiRateLimitError(OpenApiError):
     """Error 429 - Rate limit exceeded or weak 12V battery."""
@@ -32,6 +36,6 @@ class OpenApiRateLimitError(OpenApiError):
         super().__init__(message, status_code=429)
 
 class OpenApiServerError(OpenApiError):
-    """Error 500 / 504 - Server error or timeout."""
+    """Error 500 - Server error or timeout."""
     def __init__(self, message: str, status_code: int = 500) -> None:
-        super().__init__(message, status_code=status_code)
+        super().__init__(message, status_code=status_code)

{myvsb_developer_api-1.0.1 → myvsb_developer_api-1.0.3}/src/myskoda_openapi/api_layer/open_api_client.py

@@ -1,7 +1,7 @@
 import logging
 from typing import Any, Optional, List
 from aiohttp import ClientSession
-from .rest_api import SkodaRestAPI
+from .rest_api import PostEndpointResult, SkodaRestAPI
 from ..models.vehicle import VehicleResponse, Odometer
 from ..models.vehicle_status import VehicleStatus
 from ..models.active_ventilation import ActiveVentilation
@@ -71,7 +71,7 @@ class OpenAPIClient:
     
 
     
-    async def start_air_conditioning(self, vin: str, temperature: float, unit: str = "CELSIUS", without_external_power: bool = True) -> None:
+    async def start_air_conditioning(self, vin: str, temperature: float, unit: str = "CELSIUS", without_external_power: bool = True) -> PostEndpointResult:
         """Starts the air conditioning for the vehicle with the given VIN."""
         config = StartAirConditioningConfiguration(
             target_temperature=ConfigurationTargetTemperature(
@@ -80,13 +80,13 @@ class OpenAPIClient:
             ),
             air_conditioning_without_external_power=without_external_power,
         )
-        await self.rest_api.start_air_conditioning(vin, config)
+        return await self.rest_api.start_air_conditioning(vin, config)
     
-    async def stop_air_conditioning(self, vin: str) -> None:
+    async def stop_air_conditioning(self, vin: str) -> PostEndpointResult:
         """Stops the air_conditioning of the vehicle and return None if it was succesfull else catch an exception in HomeAssistant"""
-        await self.rest_api.stop_air_conditioning(vin)
+        return await self.rest_api.stop_air_conditioning(vin)
 
-    async def start_auxiliary_heating(self, vin: str, spin: str, duration_in_seconds: int = 120, start_mode: str = "HEATING", target_temperature: Optional[float] = None, unit: str = "CELSIUS") -> None:
+    async def start_auxiliary_heating(self, vin: str, spin: str, duration_in_seconds: int = 120, start_mode: str = "HEATING", target_temperature: Optional[float] = None, unit: str = "CELSIUS") -> PostEndpointResult:
         """Starts the auxiliary heating for the vehicle with the given VIN."""
         temp_obj = None
         if target_temperature is not None:
@@ -101,27 +101,27 @@ class OpenAPIClient:
             start_mode=start_mode,
             target_temperature=temp_obj,
         )
-        await self.rest_api.start_auxiliary_heating(vin, config)
+        return await self.rest_api.start_auxiliary_heating(vin, config)
 
-    async def stop_auxiliary_heating(self, vin: str) -> None:
+    async def stop_auxiliary_heating(self, vin: str) -> PostEndpointResult:
         """Stops the auxiliary_heating of the vehicle and return None if it was succesfull else catch an exception in HomeAssistant"""
-        await self.rest_api.stop_auxiliary_heating(vin)
+        return await self.rest_api.stop_auxiliary_heating(vin)
     
-    async def start_active_ventilation(self, vin: str) -> None:
+    async def start_active_ventilation(self, vin: str) -> PostEndpointResult:
         """Starts the active_ventilation for the vehicle with the given VIN."""
-        await self.rest_api.start_active_ventilation(vin)
+        return await self.rest_api.start_active_ventilation(vin)
 
-    async def stop_active_ventilation(self, vin: str) -> None:
+    async def stop_active_ventilation(self, vin: str) -> PostEndpointResult:
         """Stops the active_ventilation of the vehicle and return None if it was succesfull else catch an exception in HomeAssistant"""
-        await self.rest_api.stop_active_ventilation(vin)
+        return await self.rest_api.stop_active_ventilation(vin)
 
-    async def start_charging(self, vin: str) -> None:
+    async def start_charging(self, vin: str) -> PostEndpointResult:
         """Starts the charging process for the vehicle with the given VIN."""
-        await self.rest_api.start_charging(vin)
+        return await self.rest_api.start_charging(vin)
 
-    async def stop_charging(self, vin: str) -> None:
+    async def stop_charging(self, vin: str) -> PostEndpointResult:
         """Stops the charging process for the vehicle with the given VIN."""
-        await self.rest_api.stop_charging(vin)
+        return await self.rest_api.stop_charging(vin)
 
     async def connect(self):
         """TODO: Implementation of connect mechanism."""

{myvsb_developer_api-1.0.1 → myvsb_developer_api-1.0.3}/src/myskoda_openapi/api_layer/rest_api.py

@@ -18,9 +18,11 @@ from ..models.configurations import StartAirConditioningConfiguration, StartAuxi
 from .exceptions import (
     OpenApiError,
     OpenApiAuthenticationError,
+    OpenApiUnsupportedError,
     OpenApiForbiddenError,
     OpenApiVehicleNotFoundError,
     OpenApiRateLimitError,
+    OpenApiServerError
 )
 
 T = TypeVar("T")
@@ -66,8 +68,12 @@ class SkodaRestAPI:
                         case 401: raise OpenApiAuthenticationError("Invalid or expired X-API-Key.")
                         case 403: raise OpenApiForbiddenError("Access forbidden. User not allowed to execute operation.")
                         case 404: raise OpenApiVehicleNotFoundError("Vehicle with this VIN does not exist.")
+                        case 422: raise OpenApiUnsupportedError("Vehicle does not support this operation")
                         case 429: raise OpenApiRateLimitError("Rate limit exceeded or insufficient battery level.")
                         case 400: raise OpenApiError("Bad request (e.g. validation or VIN issues).")
+                        case 500: raise OpenApiServerError("An unexpected error occurred while processing the request.", 500)
+                        case 503: raise OpenApiServerError("API key validation is temporarily unavailable. Retry after 10 seconds.", 503)
+                        case 504: raise OpenApiServerError("The vehicle did not respond in time.", 504)
                 
                 return response.status
         except Exception as err:
@@ -87,10 +93,15 @@ class SkodaRestAPI:
             async with self._session.get(full_url, headers=headers, params=params) as response:
                 if response.status not in (200, 202):
                     match response.status:
-                        case 401: raise OpenApiAuthenticationError("Invalid or expired X-API-Key.") 
-                        case 403: raise OpenApiForbiddenError("Access to the requested resource is forbidden.") 
-                        case 404: raise OpenApiVehicleNotFoundError("Vehicle with this VIN does not exist.") 
-                        case 429: raise OpenApiRateLimitError("Rate limit exceeded or weak 12V battery.") 
+                        case 401: raise OpenApiAuthenticationError("Invalid or expired X-API-Key.")
+                        case 403: raise OpenApiForbiddenError("Access forbidden. User not allowed to execute operation.")
+                        case 404: raise OpenApiVehicleNotFoundError("Vehicle with this VIN does not exist.")
+                        case 422: raise OpenApiUnsupportedError("Vehicle does not support this operation")
+                        case 429: raise OpenApiRateLimitError("Rate limit exceeded or insufficient battery level.")
+                        case 400: raise OpenApiError("Bad request (e.g. validation or VIN issues).")
+                        case 500: raise OpenApiServerError("An unexpected error occurred while processing the request.", 500)
+                        case 503: raise OpenApiServerError("API key validation is temporarily unavailable. Retry after 10 seconds.", 503)
+                        case 504: raise OpenApiServerError("The vehicle did not respond in time.", 504)
                 return await response.json()
         except Exception as err:
             raise OpenApiError(f"There has been an error when trying to make the request: {err}") from err

{myvsb_developer_api-1.0.1 → myvsb_developer_api-1.0.3/src/myvsb_developer_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: myvsb-developer-api
-Version: 1.0.1
+Version: 1.0.3
 Summary: Asynchronous Python library for the MyVSB Developer API
 Author-email: net0045 <stepan.netolicky@vsb.cz>
 Project-URL: Homepage, https://github.com/mobility-lab-vsb/myvsb-developer-api