wop-python-sdk 0.1.0__py3-none-any.whl

wop_sdk/transports/__init__.py

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+"""可插拔 HTTP 适配层（Q1 定稿）：协议核心零网络 IO，传输以独立模块交付。
+
+- ``Transport``：协议接口，商户自带栈时可直接实现或消费 RequestDraft；
+- ``send_draft``：RequestDraft → Transport（URL 拼接归此，适配器只面对完整请求）；
+- stdlib urllib 适配器随主包；httpx / requests 适配器为 peer 依赖（extras）。
+"""
+from dataclasses import dataclass
+from typing import Dict, Optional, Protocol, runtime_checkable
+
+from ..client import RequestDraft
+
+__all__ = ["HttpResponse", "Transport", "UrllibTransport", "send_draft"]
+
+
+@dataclass
+class HttpResponse:
+    """传输层归一响应：headers 键统一小写。"""
+
+    status: int
+    headers: Dict[str, str]
+    body: bytes
+
+
+@runtime_checkable
+class Transport(Protocol):
+    def send(
+        self, method: str, url: str, headers: Dict[str, str], body: Optional[bytes]
+    ) -> HttpResponse:
+        ...  # pragma: no cover —— Protocol 声明
+
+
+def send_draft(transport: Transport, base_url: str, draft: RequestDraft) -> HttpResponse:
+    """把 RequestDraft 交给 Transport：URL = base_url + path。"""
+    url = base_url.rstrip("/") + draft.path
+    return transport.send(draft.method, url, draft.headers, draft.wire_body)
+
+
+from .urllib_transport import UrllibTransport  # noqa: E402  （置于 __all__ 定义后避免循环）

wop_sdk/transports/httpx_transport.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+"""httpx peer 适配器（extras：``pip install 'wop-sdk[httpx]'``）。"""
+from typing import Dict, Optional
+
+from . import HttpResponse
+
+
+class HttpxTransport:
+    """httpx.Client 适配器；惰性导入，未安装时给出安装指引。"""
+
+    def __init__(self, client=None):
+        try:
+            import httpx
+        except ImportError as exc:  # pragma: no cover —— 视环境而定
+            raise ImportError(
+                "httpx 未安装；peer 适配器请执行 pip install 'wop-sdk[httpx]'"
+            ) from exc
+        self._client = client if client is not None else httpx.Client()
+
+    def send(
+        self, method: str, url: str, headers: Dict[str, str], body: Optional[bytes]
+    ) -> HttpResponse:
+        resp = self._client.request(method, url, headers=headers, content=body)
+        return HttpResponse(
+            resp.status_code,
+            {k.lower(): v for k, v in resp.headers.items()},
+            resp.content,
+        )
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "HttpxTransport":
+        return self
+
+    def __exit__(self, *exc_info) -> None:
+        self.close()

wop_sdk/transports/requests_transport.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+"""requests peer 适配器（extras：``pip install 'wop-sdk[requests]'``）。"""
+from typing import Dict, Optional
+
+from . import HttpResponse
+
+
+class RequestsTransport:
+    """requests 适配器；惰性导入，未安装时给出安装指引。"""
+
+    def __init__(self, session=None):
+        try:
+            import requests
+        except ImportError as exc:  # pragma: no cover —— 视环境而定
+            raise ImportError(
+                "requests 未安装；peer 适配器请执行 pip install 'wop-sdk[requests]'"
+            ) from exc
+        self._session = session if session is not None else requests.Session()
+
+    def send(
+        self, method: str, url: str, headers: Dict[str, str], body: Optional[bytes]
+    ) -> HttpResponse:
+        resp = self._session.request(method, url, headers=headers, data=body)
+        return HttpResponse(
+            resp.status_code,
+            {k.lower(): v for k, v in resp.headers.items()},
+            resp.content,
+        )
+
+    def close(self) -> None:
+        self._session.close()
+
+    def __enter__(self) -> "RequestsTransport":
+        return self
+
+    def __exit__(self, *exc_info) -> None:
+        self.close()

wop_sdk/transports/urllib_transport.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+"""stdlib urllib 适配器（零依赖，随主包交付）。"""
+import urllib.error
+import urllib.request
+from typing import Dict, Optional
+
+from . import HttpResponse
+
+
+class UrllibTransport:
+    """urllib.request 适配器；4xx/5xx 返回响应体而非抛异常（协议错误也在 body 里）。"""
+
+    def send(
+        self, method: str, url: str, headers: Dict[str, str], body: Optional[bytes]
+    ) -> HttpResponse:
+        req = urllib.request.Request(url, data=body, method=method)
+        for name, value in headers.items():
+            req.add_header(name, value)
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return HttpResponse(
+                    resp.status,
+                    {k.lower(): v for k, v in resp.headers.items()},
+                    resp.read(),
+                )
+        except urllib.error.HTTPError as exc:
+            return HttpResponse(
+                exc.code, {k.lower(): v for k, v in exc.headers.items()}, exc.read()
+            )