uapi-sdk-python 0.1.13__tar.gz → 0.1.15__tar.gz

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uapi-sdk-python
-Version: 0.1.13
+Version: 0.1.15
 Summary: Idiomatic UAPI SDK for Python
 Author-email: UAPI <dev@uapis.cn>
 Requires-Python: >=3.9
@@ -32,7 +32,7 @@ pip install uapi-sdk-python
 ```python
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1")
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
 result = client.social.get_social_qq_userinfo(qq="10001")
 print(result)
 ```
@@ -62,7 +62,7 @@ print(result)
 from functools import lru_cache
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1", token="<TOKEN>")
+client = UapiClient("https://uapis.cn", token="YOUR_API_KEY")
 
 @lru_cache(maxsize=128)
 def cached_lookup(qq: str):
@@ -73,34 +73,19 @@ user = cached_lookup("10001")
 
 也可以在 FastAPI / Django 项目里配合 Redis，将 SDK 的响应序列化后写入缓存，命中即直接返回。
 
-### 注入自定义 httpx.Client
+### 调整超时与环境
 
 ```python
-import httpx
-from httpx import Auth
 from uapi import UapiClient
 
-class StaticToken(Auth):
-    def __init__(self, token: str):
-        self.token = token
-    def auth_flow(self, request):
-        request.headers["Authorization"] = f"Bearer {self.token}"
-        yield request
-
-http_client = httpx.Client(
-    timeout=5,
-    transport=httpx.HTTPTransport(retries=3),
-    event_hooks={"request": [lambda request: print("->", request.url)]},
-)
-
 client = UapiClient(
-    "https://uapis.cn/api/v1",
-    client=http_client,
-    auth=StaticToken("<TOKEN>"),
+    "https://uapis.cn",
+    token="YOUR_API_KEY",
+    timeout=5.0,
 )
 ```
 
-通过自定义 `client` / `transport` / `auth`，可以无缝植入代理、重试策略或 APM 埋点。
+如果你需要切换到别的环境，直接改 `base_url` 就可以；如果你只想缩短等待时间，传 `timeout` 就够了。
 
 ## 错误模型概览
 

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.15}/README.md

@@ -18,7 +18,7 @@ pip install uapi-sdk-python
 ```python
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1")
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
 result = client.social.get_social_qq_userinfo(qq="10001")
 print(result)
 ```
@@ -48,7 +48,7 @@ print(result)
 from functools import lru_cache
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1", token="<TOKEN>")
+client = UapiClient("https://uapis.cn", token="YOUR_API_KEY")
 
 @lru_cache(maxsize=128)
 def cached_lookup(qq: str):
@@ -59,34 +59,19 @@ user = cached_lookup("10001")
 
 也可以在 FastAPI / Django 项目里配合 Redis，将 SDK 的响应序列化后写入缓存，命中即直接返回。
 
-### 注入自定义 httpx.Client
+### 调整超时与环境
 
 ```python
-import httpx
-from httpx import Auth
 from uapi import UapiClient
 
-class StaticToken(Auth):
-    def __init__(self, token: str):
-        self.token = token
-    def auth_flow(self, request):
-        request.headers["Authorization"] = f"Bearer {self.token}"
-        yield request
-
-http_client = httpx.Client(
-    timeout=5,
-    transport=httpx.HTTPTransport(retries=3),
-    event_hooks={"request": [lambda request: print("->", request.url)]},
-)
-
 client = UapiClient(
-    "https://uapis.cn/api/v1",
-    client=http_client,
-    auth=StaticToken("<TOKEN>"),
+    "https://uapis.cn",
+    token="YOUR_API_KEY",
+    timeout=5.0,
 )
 ```
 
-通过自定义 `client` / `transport` / `auth`，可以无缝植入代理、重试策略或 APM 埋点。
+如果你需要切换到别的环境，直接改 `base_url` 就可以；如果你只想缩短等待时间，传 `timeout` 就够了。
 
 ## 错误模型概览
 

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "uapi-sdk-python"
-version = "0.1.13"
+version = "0.1.15"
 description = "Idiomatic UAPI SDK for Python"
 readme = "README.md"
 requires-python = ">=3.9"