Enable ruff TC rules and move type-only imports to TYPE_CHECKING blocks

Move imports only used for type annotations into TYPE_CHECKING blocks.
Ignore TC006 (quoting cast types) as it hurts IDE autocomplete with no
measurable import-time benefit.

Author: iMicknl

pyoverkiz/_case.py

@@ -4,8 +4,10 @@
 
 import functools
 import re
-from collections.abc import Callable
-from typing import Any
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
 
 _CAMEL_RE = re.compile(r"([A-Z]+)([A-Z][a-z])|([a-z\d])([A-Z])")
 

pyoverkiz/action_queue.py

@@ -4,13 +4,14 @@
 
 import asyncio
 import contextlib
-from collections.abc import Callable, Coroutine, Generator
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any
 
 from pyoverkiz.models import Action
 
 if TYPE_CHECKING:
+    from collections.abc import Callable, Coroutine, Generator
+
     from pyoverkiz.enums import ExecutionMode
 
 

pyoverkiz/auth/base.py

@@ -3,9 +3,11 @@
 from __future__ import annotations
 
 import datetime
-from collections.abc import Mapping
 from dataclasses import dataclass
-from typing import Any, Protocol
+from typing import TYPE_CHECKING, Any, Protocol
+
+if TYPE_CHECKING:
+    from collections.abc import Mapping
 
 
 @dataclass(slots=True)

pyoverkiz/auth/factory.py

@@ -2,9 +2,7 @@
 
 from __future__ import annotations
 
-import ssl
-
-from aiohttp import ClientSession
+from typing import TYPE_CHECKING
 
 from pyoverkiz.auth.credentials import (
     Credentials,
@@ -24,7 +22,13 @@
     SomfyAuthStrategy,
 )
 from pyoverkiz.enums import APIType, Server
-from pyoverkiz.models import ServerConfig
+
+if TYPE_CHECKING:
+    import ssl
+
+    from aiohttp import ClientSession
+
+    from pyoverkiz.models import ServerConfig
 
 
 def build_auth_strategy(

pyoverkiz/auth/strategies.py

@@ -6,22 +6,25 @@
 import base64
 import binascii
 import json
-import ssl
-from collections.abc import Mapping
 from typing import TYPE_CHECKING, Any, cast
 
 if TYPE_CHECKING:
+    import ssl
+    from collections.abc import Mapping
+
     from botocore.client import BaseClient
 
+    from pyoverkiz.auth.credentials import (
+        LocalTokenCredentials,
+        RexelOAuthCodeCredentials,
+        TokenCredentials,
+        UsernamePasswordCredentials,
+    )
+    from pyoverkiz.models import ServerConfig
+
 from aiohttp import ClientSession, FormData
 
 from pyoverkiz.auth.base import AuthContext, AuthStrategy
-from pyoverkiz.auth.credentials import (
-    LocalTokenCredentials,
-    RexelOAuthCodeCredentials,
-    TokenCredentials,
-    UsernamePasswordCredentials,
-)
 from pyoverkiz.const import (
     COZYTOUCH_ATLANTIC_API,
     COZYTOUCH_CLIENT_ID,
@@ -47,7 +50,6 @@
     SomfyBadCredentialsError,
     SomfyServiceError,
 )
-from pyoverkiz.models import ServerConfig
 
 
 class BaseAuthStrategy(AuthStrategy):

pyoverkiz/client.py

@@ -6,8 +6,7 @@
 import ssl
 import urllib.parse
 from pathlib import Path
-from types import TracebackType
-from typing import Any, cast
+from typing import TYPE_CHECKING, Any, cast
 
 import backoff
 from aiohttp import (
@@ -16,7 +15,6 @@
     ClientSession,
     ServerDisconnectedError,
 )
-from backoff.types import Details
 
 from pyoverkiz._case import decamelize
 from pyoverkiz.action_queue import ActionQueue, ActionQueueSettings
@@ -52,7 +50,13 @@
 from pyoverkiz.obfuscate import obfuscate_sensitive_data
 from pyoverkiz.response_handler import check_response
 from pyoverkiz.serializers import prepare_payload
-from pyoverkiz.types import JSON
+
+if TYPE_CHECKING:
+    from types import TracebackType
+
+    from backoff.types import Details
+
+    from pyoverkiz.types import JSON
 
 _LOGGER = logging.getLogger(__name__)
 

pyoverkiz/models.py

@@ -5,8 +5,7 @@
 import json
 import logging
 import re
-from collections.abc import Iterator
-from typing import Any, cast
+from typing import TYPE_CHECKING, Any, cast
 
 from attr import define, field
 
@@ -24,12 +23,16 @@
     UIWidget,
     UpdateBoxStatus,
 )
-from pyoverkiz.enums.command import OverkizCommand, OverkizCommandParam
 from pyoverkiz.enums.protocol import Protocol
 from pyoverkiz.enums.server import APIType, Server
 from pyoverkiz.obfuscate import obfuscate_email, obfuscate_id, obfuscate_string
 from pyoverkiz.types import DATA_TYPE_TO_PYTHON, StateType
 
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
+    from pyoverkiz.enums.command import OverkizCommand, OverkizCommandParam
+
 # pylint: disable=unused-argument, too-many-instance-attributes, too-many-locals
 
 # <protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>]

pyoverkiz/obfuscate.py

@@ -3,9 +3,10 @@
 from __future__ import annotations
 
 import re
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from pyoverkiz.types import JSON
+if TYPE_CHECKING:
+    from pyoverkiz.types import JSON
 
 
 def obfuscate_id(id: str | None) -> str:

pyoverkiz/response_handler.py

@@ -3,8 +3,7 @@
 from __future__ import annotations
 
 from json import JSONDecodeError
-
-from aiohttp import ClientResponse
+from typing import TYPE_CHECKING
 
 from pyoverkiz.exceptions import (
     AccessDeniedToGatewayError,
@@ -36,6 +35,9 @@
     UnknownUserError,
 )
 
+if TYPE_CHECKING:
+    from aiohttp import ClientResponse
+
 # Primary dispatch: (errorCode, message_substring) -> error class.
 # Checked in order; first match wins. Use errorCode as the primary key to
 # reduce brittleness across cloud vs. local API variants.

pyoverkiz/types.py

@@ -3,11 +3,13 @@
 from __future__ import annotations
 
 import json
-from collections.abc import Callable
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 from pyoverkiz.enums import DataType
 
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 StateType = str | int | float | bool | dict[str, Any] | list[Any] | None