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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: myvsb-developer-api
-Version: 0.2.0
+Version: 1.0.1
 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-0.2.0 → myvsb_developer_api-1.0.1}/pyproject.toml

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

{myvsb_developer_api-0.2.0 → myvsb_developer_api-1.0.1}/src/myskoda_openapi/api_layer/const.py

@@ -1,3 +1,4 @@
 SANDBOX_BASE_URL = "https://developer.sandbox.connect.skoda-auto.cz"
 PRODUCTION_BASE_URL = "https://developer.connect.skoda-auto.cz"
-TEST_BASE_URL = "https://public.test-api.connect.skoda-auto.cz"
+TEST_BASE_URL = "https://public.test-api.connect.skoda-auto.cz"
+BETA_URL = "https://public.api.connect.skoda-auto.cz"

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

@@ -11,6 +11,7 @@ from ..models.auxiliary_heating import AuxiliaryHeating
 from ..models.charging import Charging
 from ..models.driving_range import FuelStatus
 from ..models.charging_profiles import ChargingProfiles
+from ..models.configurations import StartAirConditioningConfiguration, StartAuxiliaryHeatingConfiguration, ConfigurationTargetTemperature
 
 class OpenAPIClient:
     """Client for interacting with rest API and used in HomeAssistant."""
@@ -70,10 +71,16 @@ class OpenAPIClient:
     
 
     
-    async def start_air_conditioning(self, vin: str, temperature: float) -> None:
+    async def start_air_conditioning(self, vin: str, temperature: float, unit: str = "CELSIUS", without_external_power: bool = True) -> None:
         """Starts the air conditioning for the vehicle with the given VIN."""
-        payload = {"targetTemperature": temperature}
-        await self.rest_api.start_air_conditioning(vin, payload=payload)
+        config = StartAirConditioningConfiguration(
+            target_temperature=ConfigurationTargetTemperature(
+                temperature_value=temperature,
+                unit_in_car=unit,
+            ),
+            air_conditioning_without_external_power=without_external_power,
+        )
+        await self.rest_api.start_air_conditioning(vin, config)
     
     async def stop_air_conditioning(self, vin: str) -> None:
         """Stops the air_conditioning of the vehicle and return None if it was succesfull else catch an exception in HomeAssistant"""
@@ -81,19 +88,20 @@ class OpenAPIClient:
 
     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:
         """Starts the auxiliary heating for the vehicle with the given VIN."""
-        payload = {
-            "spin": spin,
-            "durationInSeconds": duration_in_seconds,
-            "startMode": start_mode
-        }
-        # If there is target temperature, add it into the payload
+        temp_obj = None
         if target_temperature is not None:
-            payload["targetTemperature"] = {
-                "value": target_temperature,
-                "unit": unit
-            }
-            
-        await self.rest_api.start_auxiliary_heating(vin, payload=payload)
+            temp_obj = ConfigurationTargetTemperature(
+                temperature_value=target_temperature,
+                unit_in_car=unit,
+            )
+
+        config = StartAuxiliaryHeatingConfiguration(
+            spin=spin,
+            duration_in_seconds=duration_in_seconds,
+            start_mode=start_mode,
+            target_temperature=temp_obj,
+        )
+        await self.rest_api.start_auxiliary_heating(vin, config)
 
     async def stop_auxiliary_heating(self, vin: str) -> None:
         """Stops the auxiliary_heating of the vehicle and return None if it was succesfull else catch an exception in HomeAssistant"""

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

@@ -3,7 +3,7 @@ import logging
 from typing import Generic, Optional, TypeVar, Any, List
 from dataclasses import dataclass
 from aiohttp import ClientResponseError, ClientSession
-from .const import SANDBOX_BASE_URL, PRODUCTION_BASE_URL, TEST_BASE_URL
+from .const import SANDBOX_BASE_URL, PRODUCTION_BASE_URL, TEST_BASE_URL, BETA_URL
 from ..models.vehicle import VehicleResponse
 from ..models.vehicle_status import VehicleStatus
 from ..models.vehicle import Odometer
@@ -14,6 +14,7 @@ from ..models.charging import Charging
 from ..models.active_ventilation import ActiveVentilation
 from ..models.charging_profiles import ChargingProfiles
 from ..models.driving_range import FuelStatus
+from ..models.configurations import StartAirConditioningConfiguration, StartAuxiliaryHeatingConfiguration
 from .exceptions import (
     OpenApiError,
     OpenApiAuthenticationError,
@@ -46,7 +47,7 @@ class SkodaRestAPI:
     def __init__(self, api_key: str, session: ClientSession) -> None:
         self._api_key = api_key
         self._session = session
-        self._base_url = TEST_BASE_URL  # Default to TEST_BASE_URL; can be changed to SANDBOX_BASE_URL or PRODUCTION_BASE_URL as needed.
+        self._base_url = BETA_URL  # Default to BETA_URL; can be changed to SANDBOX_BASE_URL or PRODUCTION_BASE_URL as needed.
         #TODO will be exteded with methods for authorization, token management, and other endpoints as needed.
 
     async def _make_post_request(self, url: str, json_data: Optional[dict] = None) -> int:
@@ -224,10 +225,11 @@ class SkodaRestAPI:
     # =========================================================================
     # ENDPOINT METHODS - POST
     # =========================================================================
-    async def start_air_conditioning(self, vin: str, payload: dict) -> PostEndpointResult:
+    async def start_air_conditioning(self, vin: str, config: StartAirConditioningConfiguration) -> PostEndpointResult:
         """Starts the air conditioning for the vehicle with the given VIN. The payload should contain any necessary parameters for starting the air conditioning."""
         url = f"/api/v1/vehicles/{vin}/air-conditioning/start"
         
+        payload = config.model_dump(by_alias=True, exclude_none=True)
         status = await self._make_post_request(url, json_data=payload)
         return PostEndpointResult(url=url, status=status, headers={})
     
@@ -238,10 +240,11 @@ class SkodaRestAPI:
         status = await self._make_post_request(url)
         return PostEndpointResult(url=url, status=status, headers={})
     
-    async def start_auxiliary_heating(self, vin: str, payload: dict) -> PostEndpointResult:
+    async def start_auxiliary_heating(self, vin: str, config: StartAuxiliaryHeatingConfiguration) -> PostEndpointResult:
         """Starts the auxiliary heating for the vehicle with the given VIN. The payload should contain any necessary parameters for starting the auxiliary heating."""
         url = f"/api/v1/vehicles/{vin}/auxiliary-heating/start"
         
+        payload = config.model_dump(by_alias=True, exclude_none=True)
         status = await self._make_post_request(url, json_data=payload)
         return PostEndpointResult(url=url, status=status, headers={})
     

{myvsb_developer_api-0.2.0 → myvsb_developer_api-1.0.1}/src/myskoda_openapi/models/air_conditioning.py

@@ -11,7 +11,6 @@ class WindowHeating(BaseModel):
     front: Optional[OnOffState] = None
     rear: Optional[OnOffState] = None
 
-
 class AirConditioning(BaseModel):
     """Information about the vehicle's air conditioning."""
     state: AirConditioningState

{myvsb_developer_api-0.2.0 → myvsb_developer_api-1.0.1}/src/myskoda_openapi/models/auxiliary_heating.py

@@ -6,6 +6,7 @@ from .enums import (
     AuxiliaryHeatingStartMode,
 )
 
+
 class AuxiliaryHeating(BaseModel):
     """Auxiliary heating status."""
     state: AuxiliaryHeatingState

myvsb_developer_api-1.0.1/src/myskoda_openapi/models/configurations.py

@@ -0,0 +1,34 @@
+from typing import Optional
+from pydantic import Field
+from .base_model import BaseModel
+
+class ConfigurationTargetTemperature(BaseModel):
+    temperature_value: float = Field(..., alias="temperatureValue")
+    unit_in_car: str = Field("CELSIUS", alias="unitInCar")
+
+    class Config:
+        populate_by_name = True
+
+
+class StartAirConditioningConfiguration(BaseModel):
+    """Configuration for starting air conditioning."""
+    target_temperature: Optional[ConfigurationTargetTemperature] = Field(None, alias="targetTemperature")
+    spin: Optional[str] = Field(None, alias="spin")
+    heater_source: Optional[str] = Field(None, alias="heaterSource")
+    air_conditioning_without_external_power: Optional[bool] = Field(
+        True, alias="airConditioningWithoutExternalPower"
+    )
+
+    class Config:
+        populate_by_name = True
+
+
+class StartAuxiliaryHeatingConfiguration(BaseModel):
+    """Configuration for starting auxiliary heating."""
+    spin: str = Field(..., alias="spin")
+    duration_in_seconds: Optional[int] = Field(120, alias="durationInSeconds")
+    start_mode: Optional[str] = Field("HEATING", alias="startMode")
+    target_temperature: Optional[ConfigurationTargetTemperature] = Field(None, alias="targetTemperature")
+
+    class Config:
+        populate_by_name = True

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: myvsb-developer-api
-Version: 0.2.0
+Version: 1.0.1
 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-0.2.0 → myvsb_developer_api-1.0.1}/src/myvsb_developer_api.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ src/myskoda_openapi/models/base_model.py
 src/myskoda_openapi/models/charging.py
 src/myskoda_openapi/models/charging_profiles.py
 src/myskoda_openapi/models/common.py
+src/myskoda_openapi/models/configurations.py
 src/myskoda_openapi/models/driving_range.py
 src/myskoda_openapi/models/enums.py
 src/myskoda_openapi/models/parking_position.py