standardize packaging, tooling, docs, CI, and licensing

openapi_first/client.py

@@ -31,7 +31,8 @@ Notes:
         - This module intentionally does NOT: Generate client code, validate request/response schemas, deserialize responses, retry requests, implement authentication helpers, or assume non-2xx responses are failures.
 """
 
-from typing import Any, Callable, Dict, Optional
+from collections.abc import Callable
+from typing import Any
 from urllib.parse import urljoin
 
 import httpx
@@ -88,8 +89,8 @@ class OpenAPIClient:
     def __init__(
         self,
         spec: dict[str, Any],
-        base_url: Optional[str] = None,
-        client: Optional[httpx.Client] = None,
+        base_url: str | None = None,
+        client: httpx.Client | None = None,
     ) -> None:
         """
         Initialize the OpenAPI client.
@@ -110,7 +111,7 @@ class OpenAPIClient:
         self.base_url = base_url or self._resolve_base_url(spec)
         self.client = client or httpx.Client(base_url=self.base_url)
 
-        self._operations: Dict[str, Callable[..., httpx.Response]] = {}
+        self._operations: dict[str, Callable[..., httpx.Response]] = {}
         self._build_operations()
 
     # ------------------------------------------------------------------ #
@@ -123,7 +124,7 @@ class OpenAPIClient:
         except KeyError:
             raise AttributeError(f"No such operationId: {name}") from None
 
-    def operations(self) -> Dict[str, Callable[..., httpx.Response]]:
+    def operations(self) -> dict[str, Callable[..., httpx.Response]]:
         return dict(self._operations)
 
     # ------------------------------------------------------------------ #
@@ -149,7 +150,13 @@ class OpenAPIClient:
         for path, path_item in paths.items():
             for method, operation in path_item.items():
                 if method.lower() not in {
-                    "get", "post", "put", "patch", "delete", "head", "options"
+                    "get",
+                    "post",
+                    "put",
+                    "patch",
+                    "delete",
+                    "head",
+                    "options",
                 }:
                     continue
 
@@ -181,11 +188,11 @@ class OpenAPIClient:
 
         def call(
             *,
-            path_params: Optional[dict[str, Any]] = None,
-            query: Optional[dict[str, Any]] = None,
-            headers: Optional[dict[str, str]] = None,
-            body: Optional[Any] = None,
-            timeout: Optional[float] = None,
+            path_params: dict[str, Any] | None = None,
+            query: dict[str, Any] | None = None,
+            headers: dict[str, str] | None = None,
+            body: Any | None = None,
+            timeout: float | None = None,
         ) -> httpx.Response:
             url = self._build_url(path, path_params or {})
 
@@ -228,9 +235,7 @@ class OpenAPIClient:
         try:
             formatted_path = path.format(**path_params)
         except KeyError as exc:
-            raise OpenAPIClientError(
-                f"Missing path parameter: {exc.args[0]}"
-            ) from exc
+            raise OpenAPIClientError(f"Missing path parameter: {exc.args[0]}") from exc
 
         return urljoin(self.base_url, formatted_path.lstrip("/"))