fix(lint): exclude framework files from ty/pyrefly and fix pyrefly invocation

Author: Athroniaeth

Makefile

@@ -4,5 +4,5 @@ lint:
 	uv run ruff format .
 	uv run ruff check --fix .
 	uv run ty check .
-	uv run pyrefly check .
+	uv run pyrefly check
 	uv run bandit -c pyproject.toml -r src examples -q

pyproject.toml

@@ -171,11 +171,32 @@ doctest_optionflags = [
 ]
 testpaths = ["src", "tests"]
 
+[tool.ty.src]
+exclude = [
+    # Django ORM descriptors / manager not understood by ty
+    "src/fastapi_api_key/django/",
+    # Litestar DI / State / Request not understood by ty
+    "src/fastapi_api_key/litestar_api.py",
+    # Quart abort() is NoReturn but not recognised; TestClient __aexit__
+    "src/fastapi_api_key/quart_api.py",
+    "tests/unit/test_quart_api.py",
+]
+
 [tool.pyrefly]
 project-includes = [
     "**/*.py*",
     "**/*.ipynb",
 ]
+project_excludes = [
+    # Django ORM descriptors / manager not understood by pyrefly
+    "src/fastapi_api_key/django/*.py",
+    # Litestar DI / State / Request not understood by pyrefly
+    "src/fastapi_api_key/litestar_api.py",
+    # Quart abort() is NoReturn but not recognised; TestClient __aexit__
+    "src/fastapi_api_key/quart_api.py",
+    "tests/unit/test_quart_api.py",
+    "tests/unit/test_litestar_api.py",
+]
 
 
 [tool.coverage.run]

src/fastapi_api_key/django/apps.py

@@ -8,10 +8,7 @@
 try:
     from django.apps import AppConfig
 except ModuleNotFoundError as e:  # pragma: no cover
-    raise ImportError(
-        "Django integration requires 'django'. "
-        "Install it with: uv add fastapi_api_key[django]"
-    ) from e
+    raise ImportError("Django integration requires 'django'. Install it with: uv add fastapi_api_key[django]") from e
 
 
 class FastApiApiKeyDjangoConfig(AppConfig):

src/fastapi_api_key/django/decorators.py

@@ -16,10 +16,7 @@ async def my_view(request):
 try:
     from django.http import HttpRequest, JsonResponse
 except ModuleNotFoundError as e:  # pragma: no cover
-    raise ImportError(
-        "Django integration requires 'django'. "
-        "Install it with: uv add fastapi_api_key[django]"
-    ) from e
+    raise ImportError("Django integration requires 'django'. Install it with: uv add fastapi_api_key[django]") from e
 
 from fastapi_api_key.domain.errors import (
     InvalidKey,

src/fastapi_api_key/django/models.py

@@ -17,10 +17,7 @@
     import django  # noqa: F401
     from django.db import models
 except ModuleNotFoundError as e:  # pragma: no cover
-    raise ImportError(
-        "Django integration requires 'django'. "
-        "Install it with: uv add fastapi_api_key[django]"
-    ) from e
+    raise ImportError("Django integration requires 'django'. Install it with: uv add fastapi_api_key[django]") from e
 
 
 class ApiKeyModel(models.Model):

src/fastapi_api_key/django/repository.py

@@ -10,18 +10,13 @@
 """
 
 import sys
-from datetime import datetime
 from typing import List, Optional
 
 try:
     from django.db import models as _dj  # noqa: F401
 except ModuleNotFoundError as e:  # pragma: no cover
-    raise ImportError(
-        "Django integration requires 'django'. "
-        "Install it with: uv add fastapi_api_key[django]"
-    ) from e
+    raise ImportError("Django integration requires 'django'. Install it with: uv add fastapi_api_key[django]") from e
 
-from django.db.models import Q
 
 from fastapi_api_key.domain.entities import ApiKey
 from fastapi_api_key.repositories.base import AbstractApiKeyRepository, ApiKeyFilter

src/fastapi_api_key/django/urls.py

@@ -15,10 +15,7 @@
 try:
     from django.urls import path
 except ModuleNotFoundError as e:  # pragma: no cover
-    raise ImportError(
-        "Django integration requires 'django'. "
-        "Install it with: uv add fastapi_api_key[django]"
-    ) from e
+    raise ImportError("Django integration requires 'django'. Install it with: uv add fastapi_api_key[django]") from e
 
 from fastapi_api_key.services.base import AbstractApiKeyService
 from fastapi_api_key.django.views import (

src/fastapi_api_key/django/views.py

@@ -26,16 +26,13 @@
 """
 
 import json
-from typing import Any, Awaitable, Callable, List, Optional
+from typing import Any, Awaitable, Callable
 
 try:
     from django.http import HttpRequest, JsonResponse
     from django.views import View
 except ModuleNotFoundError as e:  # pragma: no cover
-    raise ImportError(
-        "Django integration requires 'django'. "
-        "Install it with: uv add fastapi_api_key[django]"
-    ) from e
+    raise ImportError("Django integration requires 'django'. Install it with: uv add fastapi_api_key[django]") from e
 
 from pydantic import ValidationError
 
@@ -45,7 +42,6 @@
     ApiKeyCountOut,
     ApiKeyCreateIn,
     ApiKeyCreatedOut,
-    ApiKeyOut,
     ApiKeySearchIn,
     ApiKeySearchOut,
     ApiKeyUpdateIn,
@@ -109,7 +105,7 @@ async def dispatch(self, request: HttpRequest, *args: Any, **kwargs: Any) -> Any
             return await super().dispatch(request, *args, **kwargs)
         except _HttpError as exc:
             return _error(exc.status, exc.detail)
-        except KeyNotFound as exc:
+        except KeyNotFound:
             return _error(404, "API key not found")
 
     http_method_names = ["get", "post", "patch", "delete", "head", "options"]
@@ -301,7 +297,7 @@ async def post(self, request: HttpRequest) -> JsonResponse:
                 api_key=payload.api_key,
                 required_scopes=payload.required_scopes,
             )
-        except (InvalidKey, KeyNotFound) as exc:
+        except (InvalidKey, KeyNotFound):
             return _error(401, "API key invalid")
         except KeyNotProvided:
             return _error(401, "API key missing")

src/fastapi_api_key/litestar_api.py

@@ -28,8 +28,7 @@ async def provide_svc() -> ApiKeyService:
     import litestar  # noqa: F401
 except ModuleNotFoundError as e:  # pragma: no cover
     raise ImportError(
-        "Litestar integration requires 'litestar'. "
-        "Install it with: uv add fastapi_api_key[litestar]"
+        "Litestar integration requires 'litestar'. Install it with: uv add fastapi_api_key[litestar]"
     ) from e
 
 from typing import Awaitable, Callable, List, Optional
@@ -38,7 +37,6 @@ async def provide_svc() -> ApiKeyService:
 from litestar.connection import ASGIConnection
 from litestar.di import Provide
 from litestar.exceptions import (
-    HTTPException,
     NotAuthorizedException,
     NotFoundException,
     PermissionDeniedException,
@@ -228,9 +226,7 @@ async def get_api_key(self, api_key_id: str, svc: AbstractApiKeyService) -> ApiK
             return _to_out(entity)
 
         @patch("/{api_key_id:str}", status_code=HTTP_200_OK, summary="Update an API key")
-        async def update_api_key(
-            self, api_key_id: str, data: ApiKeyUpdateIn, svc: AbstractApiKeyService
-        ) -> ApiKeyOut:
+        async def update_api_key(self, api_key_id: str, data: ApiKeyUpdateIn, svc: AbstractApiKeyService) -> ApiKeyOut:
             """Partially update an API key.
 
             Args:

src/fastapi_api_key/quart_api.py

@@ -37,12 +37,8 @@ async def protected():
 try:
     import quart  # noqa: F401
 except ModuleNotFoundError as e:  # pragma: no cover
-    raise ImportError(
-        "Quart integration requires 'quart'. "
-        "Install it with: uv add fastapi_api_key[quart]"
-    ) from e
+    raise ImportError("Quart integration requires 'quart'. Install it with: uv add fastapi_api_key[quart]") from e
 
-import json
 from functools import wraps
 from typing import Any, Awaitable, Callable, List, Optional
 
@@ -62,7 +58,6 @@ async def protected():
     ApiKeyCountOut,
     ApiKeyCreateIn,
     ApiKeyCreatedOut,
-    ApiKeyOut,
     ApiKeySearchIn,
     ApiKeySearchOut,
     ApiKeyUpdateIn,