carconnectivity-connector-skoda 0.2a5__tar.gz → 0.4a1__tar.gz

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 ## [Unreleased]
 - No unreleased changes so far
 
+## [0.3] - 2025-02-19
+### Added
+- Added support for images
+- Added tags to attributes
+- Added support for webui via carconnectivity-plugin-webui
+
 ## [0.2] - 2025-02-02
 ### Added
 - Wake Sleep command
@@ -13,6 +19,7 @@ All notable changes to this project will be documented in this file.
 Initial release, let's go and give this to the public to try out...
 The API is not yet implemented completely but most functions already work
 
-[unreleased]: https://github.com/tillsteinbach/CarConnectivity-connector-skoda/compare/v0.2...HEAD
+[unreleased]: https://github.com/tillsteinbach/CarConnectivity-connector-skoda/compare/v0.3...HEAD
+[0.3]: https://github.com/tillsteinbach/CarConnectivity-connector-skoda/releases/tag/v0.3
 [0.2]: https://github.com/tillsteinbach/CarConnectivity-connector-skoda/releases/tag/v0.2
 [0.1]: https://github.com/tillsteinbach/CarConnectivity-connector-skoda/releases/tag/v0.1

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: carconnectivity-connector-skoda
-Version: 0.2a5
+Version: 0.4a1
 Summary: CarConnectivity connector for Skoda services
 Author: Till Steinbach
 License: MIT License
@@ -37,7 +37,7 @@ Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: carconnectivity>=0.3a2
+Requires-Dist: carconnectivity>=0.4a3
 Requires-Dist: oauthlib~=3.2.2
 Requires-Dist: requests~=2.32.3
 Requires-Dist: jwt~=1.3.1

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/pyproject.toml

@@ -14,7 +14,7 @@ authors = [
     { name = "Till Steinbach" }
 ]
 dependencies = [
-    "carconnectivity>=0.3a2",
+    "carconnectivity>=0.4a3",
     "oauthlib~=3.2.2",
     "requests~=2.32.3",
     "jwt~=1.3.1",

carconnectivity_connector_skoda-0.4a1/setup_requirements.txt

@@ -0,0 +1,6 @@
+flake8~=7.1.2
+pylint~=3.3.4
+bandit~=1.8.3
+
+# For UI only
+Flask~=3.1.0

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/src/carconnectivity_connector_skoda.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: carconnectivity-connector-skoda
-Version: 0.2a5
+Version: 0.4a1
 Summary: CarConnectivity connector for Skoda services
 Author: Till Steinbach
 License: MIT License
@@ -37,7 +37,7 @@ Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: carconnectivity>=0.3a2
+Requires-Dist: carconnectivity>=0.4a3
 Requires-Dist: oauthlib~=3.2.2
 Requires-Dist: requests~=2.32.3
 Requires-Dist: jwt~=1.3.1

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/src/carconnectivity_connector_skoda.egg-info/SOURCES.txt

@@ -35,4 +35,5 @@ src/carconnectivity_connectors/skoda/auth/openid_session.py
 src/carconnectivity_connectors/skoda/auth/session_manager.py
 src/carconnectivity_connectors/skoda/auth/skoda_web_session.py
 src/carconnectivity_connectors/skoda/auth/helpers/blacklist_retry.py
+src/carconnectivity_connectors/skoda/ui/connector_ui.py
 test/integration_test/carConnectivity.json

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/src/carconnectivity_connector_skoda.egg-info/requires.txt

@@ -1,4 +1,4 @@
-carconnectivity>=0.3a2
+carconnectivity>=0.4a3
 oauthlib~=3.2.2
 requests~=2.32.3
 jwt~=1.3.1

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/src/carconnectivity_connectors/skoda/_version.py

@@ -1,8 +1,13 @@
-# file generated by setuptools_scm
+# file generated by setuptools-scm
 # don't change, don't track in version control
+
+__all__ = ["__version__", "__version_tuple__", "version", "version_tuple"]
+
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from typing import Tuple, Union
+    from typing import Tuple
+    from typing import Union
+
     VERSION_TUPLE = Tuple[Union[int, str], ...]
 else:
     VERSION_TUPLE = object
@@ -12,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.2a5'
-__version_tuple__ = version_tuple = (0, 2)
+__version__ = version = '0.4a1'
+__version_tuple__ = version_tuple = (0, 4)

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/src/carconnectivity_connectors/skoda/climatization.py

@@ -1,12 +1,12 @@
 """
-Module for charging for skoda vehicles.
+Module for climatization for skoda vehicles.
 """
 from __future__ import annotations
 from typing import TYPE_CHECKING
 
 from carconnectivity.climatization import Climatization
 from carconnectivity.objects import GenericObject
-from carconnectivity.vehicle import ElectricVehicle
+from carconnectivity.vehicle import GenericVehicle
 
 from carconnectivity_connectors.skoda.error import Error
 
@@ -21,13 +21,15 @@ class SkodaClimatization(Climatization):  # pylint: disable=too-many-instance-at
     This class extends the Climatization class and includes an enumeration of various
     charging states specific to Skoda vehicles.
     """
-    def __init__(self, vehicle: ElectricVehicle | None = None, origin: Optional[Climatization] = None) -> None:
+    def __init__(self, vehicle: GenericVehicle | None = None, origin: Optional[Climatization] = None) -> None:
         if origin is not None:
             super().__init__(origin=origin)
-            self.settings: Climatization.Settings = SkodaClimatization.Settings(origin=origin.settings)
+            if not isinstance(self.settings, SkodaClimatization.Settings):
+                self.settings: Climatization.Settings = SkodaClimatization.Settings(parent=self, origin=origin.settings)
+            self.settings.parent = self
         else:
             super().__init__(vehicle=vehicle)
-            self.settings: Climatization.Settings = SkodaClimatization.Settings(origin=self.settings)
+            self.settings: Climatization.Settings = SkodaClimatization.Settings(parent=self)
         self.errors: Dict[str, Error] = {}
 
     class Settings(Climatization.Settings):
@@ -36,6 +38,6 @@ class SkodaClimatization(Climatization):  # pylint: disable=too-many-instance-at
         """
         def __init__(self, parent: Optional[GenericObject] = None, origin: Optional[Climatization.Settings] = None) -> None:
             if origin is not None:
-                super().__init__(origin=origin)
+                super().__init__(parent=parent, origin=origin)
             else:
                 super().__init__(parent=parent)

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/src/carconnectivity_connectors/skoda/connector.py

@@ -15,7 +15,7 @@ import requests
 from carconnectivity.garage import Garage
 from carconnectivity.vehicle import GenericVehicle
 from carconnectivity.errors import AuthenticationError, TooManyRequestsError, RetrievalError, APIError, APICompatibilityError, \
-    TemporaryAuthenticationError, ConfigurationError, SetterError, CommandError
+    TemporaryAuthenticationError, SetterError, CommandError
 from carconnectivity.util import robust_time_parse, log_extra_keys, config_remove_credentials
 from carconnectivity.units import Length, Speed, Power, Temperature
 from carconnectivity.doors import Doors
@@ -71,7 +71,7 @@ class Connector(BaseConnector):
         max_age (Optional[int]): Maximum age for cached data in seconds.
     """
     def __init__(self, connector_id: str, car_connectivity: CarConnectivity, config: Dict) -> None:
-        BaseConnector.__init__(self, connector_id=connector_id, car_connectivity=car_connectivity, config=config)
+        BaseConnector.__init__(self, connector_id=connector_id, car_connectivity=car_connectivity, config=config, log=LOG, api_log=LOG_API)
 
         self._mqtt_client: SkodaMQTTClient = SkodaMQTTClient(skoda_connector=self)
 
@@ -85,77 +85,62 @@ class Connector(BaseConnector):
 
         self.user_id: Optional[str] = None
 
-        # Configure logging
-        if 'log_level' in config and config['log_level'] is not None:
-            config['log_level'] = config['log_level'].upper()
-            if config['log_level'] in logging._nameToLevel:
-                LOG.setLevel(config['log_level'])
-                self.log_level._set_value(config['log_level'])  # pylint: disable=protected-access
-                logging.getLogger('requests').setLevel(config['log_level'])
-                logging.getLogger('urllib3').setLevel(config['log_level'])
-                logging.getLogger('oauthlib').setLevel(config['log_level'])
-            else:
-                raise ConfigurationError(f'Invalid log level: "{config["log_level"]}" not in {list(logging._nameToLevel.keys())}')
-        if 'api_log_level' in config and config['api_log_level'] is not None:
-            config['api_log_level'] = config['api_log_level'].upper()
-            if config['api_log_level'] in logging._nameToLevel:
-                LOG_API.setLevel(config['api_log_level'])
-            else:
-                raise ConfigurationError(f'Invalid log level: "{config["log_level"]}" not in {list(logging._nameToLevel.keys())}')
-        LOG.info("Loading skoda connector with config %s", config_remove_credentials(self.config))
+        LOG.info("Loading skoda connector with config %s", config_remove_credentials(config))
 
         if 'spin' in config and config['spin'] is not None:
-            self._spin: Optional[str] = config['spin']
+            self.active_config['spin'] = config['spin']
         else:
-            self._spin = None
+            self.active_config['spin'] = None
 
-        username: Optional[str] = None
-        password: Optional[str] = None
-        if 'username' in self.config and 'password' in self.config:
-            username = self.config['username']
-            password = self.config['password']
+        self.active_config['username'] = None
+        self.active_config['password'] = None
+        if 'username' in config and 'password' in config:
+            self.active_config['username'] = config['username']
+            self.active_config['password'] = config['password']
         else:
-            if 'netrc' in self.config:
-                netrc_filename: str = self.config['netrc']
+            if 'netrc' in config:
+                self.active_config['netrc'] = config['netrc']
             else:
-                netrc_filename = os.path.join(os.path.expanduser("~"), ".netrc")
+                self.active_config['netrc'] = os.path.join(os.path.expanduser("~"), ".netrc")
             try:
-                secrets = netrc.netrc(file=netrc_filename)
+                secrets = netrc.netrc(file=self.active_config['netrc'])
                 secret: tuple[str, str, str] | None = secrets.authenticators("skoda")
                 if secret is None:
-                    raise AuthenticationError(f'Authentication using {netrc_filename} failed: skoda not found in netrc')
-                username, account, password = secret
+                    raise AuthenticationError(f'Authentication using {self.active_config["netrc"]} failed: skoda not found in netrc')
+                self.active_config['username'], account, self.active_config['password'] = secret
 
-                if self._spin is None and account is not None:
+                if self.active_config['spin'] is None and account is not None:
                     try:
-                        self._spin = account
+                        self.active_config['spin'] = account
                     except ValueError as err:
                         LOG.error('Could not parse spin from netrc: %s', err)
             except netrc.NetrcParseError as err:
-                LOG.error('Authentification using %s failed: %s', netrc_filename, err)
-                raise AuthenticationError(f'Authentication using {netrc_filename} failed: {err}') from err
+                LOG.error('Authentification using %s failed: %s', self.active_config['netrc'], err)
+                raise AuthenticationError(f'Authentication using {self.active_config["netrc"]} failed: {err}') from err
             except TypeError as err:
-                if 'username' not in self.config:
-                    raise AuthenticationError(f'"skoda" entry was not found in {netrc_filename} netrc-file.'
+                if 'username' not in config:
+                    raise AuthenticationError(f'"skoda" entry was not found in {self.active_config["netrc"]} netrc-file.'
                                               ' Create it or provide username and password in config') from err
             except FileNotFoundError as err:
-                raise AuthenticationError(f'{netrc_filename} netrc-file was not found. Create it or provide username and password in config') from err
-
-        interval: int = 300
-        if 'interval' in self.config:
-            interval = self.config['interval']
-            if interval < 300:
-                raise ValueError('Intervall must be at least 300 seconds')
-        self.max_age: int = interval - 1
-        if 'max_age' in self.config:
-            self.max_age = self.config['max_age']
-        self.interval._set_value(timedelta(seconds=interval))  # pylint: disable=protected-access
-
-        if username is None or password is None:
+                raise AuthenticationError(f'{self.active_config["netrc"]} netrc-file was not found. Create it or provide username and password in config') \
+                                          from err
+
+        self.active_config['interval'] = 300
+        if 'interval' in config:
+            self.active_config['interval'] = config['interval']
+            if self.active_config['interval'] < 180:
+                raise ValueError('Intervall must be at least 180 seconds')
+        self.active_config['max_age'] = self.active_config['interval'] - 1
+        if 'max_age' in config:
+            self.active_config['max_age'] = config['max_age']
+        self.interval._set_value(timedelta(seconds=self.active_config['interval']))  # pylint: disable=protected-access
+
+        if self.active_config['username'] is None or self.active_config['password'] is None:
             raise AuthenticationError('Username or password not provided')
 
         self._manager: SessionManager = SessionManager(tokenstore=car_connectivity.get_tokenstore(), cache=car_connectivity.get_cache())
-        session: requests.Session = self._manager.get_session(Service.MY_SKODA, SessionUser(username=username, password=password))
+        session: requests.Session = self._manager.get_session(Service.MY_SKODA, SessionUser(username=self.active_config['username'],
+                                                                                            password=self.active_config['password']))
         if not isinstance(session, MySkodaSession):
             raise AuthenticationError('Could not create session')
         self.session: MySkodaSession = session
@@ -948,7 +933,7 @@ class Connector(BaseConnector):
             data = self._fetch_data(url, session=self.session, allow_http_error=True)
             if data is not None and 'compositeRenders' in data:  # pylint: disable=too-many-nested-blocks
                 for image in data['compositeRenders']:
-                    if not 'layers' in image or image['layers'] is None or len(image['layers']) == 0:
+                    if 'layers' not in image or image['layers'] is None or len(image['layers']) == 0:
                         continue
                     image_url: Optional[str] = None
                     for layer in image['layers']:
@@ -959,13 +944,13 @@ class Connector(BaseConnector):
                         continue
                     img = None
                     cache_date = None
-                    if self.max_age is not None and self.session.cache is not None and image_url in self.session.cache:
+                    if self.active_config['max_age'] is not None and self.session.cache is not None and image_url in self.session.cache:
                         img, cache_date_string = self.session.cache[image_url]
                         img = base64.b64decode(img)  # pyright: ignore[reportPossiblyUnboundVariable]
                         img = Image.open(io.BytesIO(img))  # pyright: ignore[reportPossiblyUnboundVariable]
                         cache_date = datetime.fromisoformat(cache_date_string)
-                    if img is None or self.max_age is None \
-                            or (cache_date is not None and cache_date < (datetime.utcnow() - timedelta(seconds=self.max_age))):
+                    if img is None or self.active_config['max_age'] is None \
+                            or (cache_date is not None and cache_date < (datetime.utcnow() - timedelta(seconds=self.active_config['max_age']))):
                         try:
                             image_download_response = requests.get(image_url, stream=True)
                             if image_download_response.status_code == requests.codes['ok']:
@@ -1000,8 +985,8 @@ class Connector(BaseConnector):
                             if 'car_picture' in vehicle.images.images:
                                 vehicle.images.images['car_picture']._set_value(img)  # pylint: disable=protected-access
                             else:
-                                vehicle.images.images['car_picture']: ImageAttribute = ImageAttribute(name="car_picture", parent=vehicle.images,
-                                                                                                        value=img, tags={'carconnectivity'})
+                                vehicle.images.images['car_picture'] = ImageAttribute(name="car_picture", parent=vehicle.images,
+                                                                                      value=img, tags={'carconnectivity'})
         return vehicle
 
     def fetch_driving_range(self, vehicle: SkodaVehicle, no_cache: bool = False) -> SkodaVehicle:
@@ -1224,11 +1209,11 @@ class Connector(BaseConnector):
                     allowed_errors=None) -> Optional[Dict[str, Any]]:  # noqa: C901
         data: Optional[Dict[str, Any]] = None
         cache_date: Optional[datetime] = None
-        if not no_cache and (self.max_age is not None and session.cache is not None and url in session.cache):
+        if not no_cache and (self.active_config['max_age'] is not None and session.cache is not None and url in session.cache):
             data, cache_date_string = session.cache[url]
             cache_date = datetime.fromisoformat(cache_date_string)
-        if data is None or self.max_age is None \
-                or (cache_date is not None and cache_date < (datetime.utcnow() - timedelta(seconds=self.max_age))):
+        if data is None or self.active_config['max_age'] is None \
+                or (cache_date is not None and cache_date < (datetime.utcnow() - timedelta(seconds=self.active_config['max_age']))):
             try:
                 status_response: requests.Response = session.get(url, allow_redirects=False)
                 self._record_elapsed(status_response.elapsed)
@@ -1488,9 +1473,9 @@ class Connector(BaseConnector):
         if 'spin' in command_arguments:
             command_dict['currentSpin'] = command_arguments['spin']
         else:
-            if self._spin is None:
+            if self.active_config['spin'] is None:
                 raise CommandError('S-PIN is missing, please add S-PIN to your configuration or .netrc file')
-            command_dict['currentSpin'] = self._spin
+            command_dict['currentSpin'] = self.active_config['spin']
         if command_arguments['command'] == LockUnlockCommand.Command.LOCK:
             url = f'https://mysmob.api.connect.skoda-auto.cz/api/v1/vehicle-access/{vin}/lock'
         elif command_arguments['command'] == LockUnlockCommand.Command.UNLOCK:
@@ -1537,14 +1522,14 @@ class Connector(BaseConnector):
         if 'command' not in command_arguments:
             raise CommandError('Command argument missing')
         command_dict = {}
-        if self._spin is None:
+        if self.active_config['spin'] is None:
             raise CommandError('S-PIN is missing, please add S-PIN to your configuration or .netrc file')
         if 'spin' in command_arguments:
             command_dict['currentSpin'] = command_arguments['spin']
         else:
-            if self._spin is None or self._spin == '':
+            if self.active_config['spin'] is None or self.active_config['spin'] == '':
                 raise CommandError('S-PIN is missing, please add S-PIN to your configuration or .netrc file')
-            command_dict['currentSpin'] = self._spin
+            command_dict['currentSpin'] = self.active_config['spin']
         if command_arguments['command'] == SpinCommand.Command.VERIFY:
             url = 'https://mysmob.api.connect.skoda-auto.cz/api/v1/spin/verify'
         else:

carconnectivity_connector_skoda-0.4a1/src/carconnectivity_connectors/skoda/ui/connector_ui.py

@@ -0,0 +1,39 @@
+""" User interface for the Skoda connector in the Car Connectivity application. """
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+import os
+
+import flask
+
+from carconnectivity_connectors.base.ui.connector_ui import BaseConnectorUI
+
+if TYPE_CHECKING:
+    from typing import Optional, List, Dict, Union, Literal
+
+    from carconnectivity_connectors.base.connector import BaseConnector
+
+
+class ConnectorUI(BaseConnectorUI):
+    """
+    A user interface class for the Skoda connector in the Car Connectivity application.
+    """
+    def __init__(self, connector: BaseConnector):
+        blueprint: Optional[flask.Blueprint] = flask.Blueprint(name='skoda', import_name='carconnectivity-connector-skoda', url_prefix='/skoda',
+                                                                    template_folder=os.path.dirname(__file__) + '/templates')
+        super().__init__(connector, blueprint=blueprint)
+
+    def get_nav_items(self) -> List[Dict[Literal['text', 'url', 'sublinks', 'divider'], Union[str, List]]]:
+        """
+        Generates a list of navigation items for the Skoda connector UI.
+        """
+        return super().get_nav_items()
+
+    def get_title(self) -> str:
+        """
+        Returns the title of the connector.
+
+        Returns:
+            str: The title of the connector, which is "Skoda".
+        """
+        return "Skoda"

{carconnectivity_connector_skoda-0.2a5 → carconnectivity_connector_skoda-0.4a1}/src/carconnectivity_connectors/skoda/vehicle.py

@@ -7,6 +7,7 @@ from carconnectivity.charging import Charging
 
 from carconnectivity_connectors.skoda.capability import Capabilities
 from carconnectivity_connectors.skoda.charging import SkodaCharging
+from carconnectivity_connectors.skoda.climatization import SkodaClimatization
 
 SUPPORT_IMAGES = False
 try:
@@ -36,6 +37,7 @@ class SkodaVehicle(GenericVehicle):  # pylint: disable=too-many-instance-attribu
 
         else:
             super().__init__(vin=vin, garage=garage, managing_connector=managing_connector)
+            self.climatization = SkodaClimatization(vehicle=self, origin=self.climatization)
             self.capabilities = Capabilities(vehicle=self)
             if SUPPORT_IMAGES:
                 self._car_images: Dict[str, Image.Image] = {}

carconnectivity_connector_skoda-0.2a5/setup_requirements.txt

@@ -1,3 +0,0 @@
-flake8~=7.1.1
-pylint~=3.3.4
-bandit~=1.8.2