chore(release): 0.0.7

Squash-merge lib-standardisation: adopt repo standards across packaging,
tooling, docs, and CI.

- standardize pyproject.toml (canonical packaging, lint config, extras, GSDFC pydoclint)
- add py.typed marker, modernize type hints and Google-style docstrings
- nest generated docs under docs/lib and docs/mcp; add hand-written wiki
- adopt standard Type A PyPI CI pipeline (tag==version guard + quality gate)
- promote generated CHANGELOG.md; bump version to 0.0.7

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
@@ -49,6 +50,20 @@ class OpenAPIClient:
     """
     OpenAPI-first HTTP client (`httpx`-based).
 
+    Args:
+        spec (dict[str, Any]):
+            Parsed OpenAPI 3.x specification.
+        base_url (str | None):
+            Base URL of the target service. If omitted, the first entry in the
+            OpenAPI `servers` list is used.
+        client (httpx.Client | None):
+            Optional preconfigured httpx client instance.
+
+    Raises:
+        OpenAPIClientError:
+            If no servers are defined, spec has no paths, operationIds are
+            missing/duplicate, or required parameters are missing.
+
     Notes:
         **Responsibilities:**
 
@@ -88,29 +103,14 @@ 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.
-
-        Args:
-            spec (dict[str, Any]):
-                Parsed OpenAPI 3.x specification.
-            base_url (str, optional):
-                Base URL of the target service. If omitted, the first entry in the OpenAPI `servers` list is used.
-            client (httpx.Client, optional):
-                Optional preconfigured httpx client instance.
-
-        Raises:
-            OpenAPIClientError:
-                If no servers are defined, spec has no paths, operationIds are missing/duplicate, or required parameters are missing.
-        """
         self.spec = spec
         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 +123,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 +149,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 +187,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 +234,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("/"))