amap-cli 0.1.3__tar.gz → 0.1.4__tar.gz

amap_cli-0.1.3/README.md → amap_cli-0.1.4/PKG-INFO

@@ -1,3 +1,10 @@
+Metadata-Version: 2.5
+Name: amap-cli
+Version: 0.1.4
+Summary: Pure command-line CLI for Amap APIs.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
 # amap-cli
 
 `amap-cli` 是一个基于高德开放平台 Web API 的纯命令行工具，面向终端环境和 AI Agent 使用。
@@ -29,6 +36,13 @@ uvx amap-cli --help
 uvx amap-cli config set --api-key <YOUR_AMAP_KEY>
 ```
 
+高德免费账号默认限流较严，工具默认会在每次 API 调用结束后 sleep `0.34` 秒；如需调整或关闭，可配置：
+
+```bash
+uvx amap-cli config set --request-sleep-seconds 0.34
+uvx amap-cli config set --request-sleep-seconds 0
+```
+
 地理编码示例：
 
 ```bash
@@ -123,6 +137,18 @@ amap-cli install-skill --dir ~/.agents/skills --force
 amap-cli config set --api-key <YOUR_AMAP_KEY>
 ```
 
+设置每次高德 API 调用结束后的 sleep 时间：
+
+```bash
+amap-cli config set --request-sleep-seconds 0.34
+```
+
+关闭该 sleep：
+
+```bash
+amap-cli config set --request-sleep-seconds 0
+```
+
 查看当前配置：
 
 ```bash
@@ -135,6 +161,12 @@ amap-cli config show
 ~/Library/Application Support/amap-cli/config.json
 ```
 
+说明：
+
+- `request_sleep_seconds` 默认为 `0.34`
+- 该配置会在每次真实的高德 API 调用结束后执行一次 sleep
+- 设置为 `0` 表示关闭节流等待
+
 ### 安装 Skill
 
 基础格式：

amap_cli-0.1.3/PKG-INFO → amap_cli-0.1.4/README.md

@@ -1,10 +1,3 @@
-Metadata-Version: 2.5
-Name: amap-cli
-Version: 0.1.3
-Summary: Pure command-line CLI for Amap APIs.
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-
 # amap-cli
 
 `amap-cli` 是一个基于高德开放平台 Web API 的纯命令行工具，面向终端环境和 AI Agent 使用。
@@ -36,6 +29,13 @@ uvx amap-cli --help
 uvx amap-cli config set --api-key <YOUR_AMAP_KEY>
 ```
 
+高德免费账号默认限流较严，工具默认会在每次 API 调用结束后 sleep `0.34` 秒；如需调整或关闭，可配置：
+
+```bash
+uvx amap-cli config set --request-sleep-seconds 0.34
+uvx amap-cli config set --request-sleep-seconds 0
+```
+
 地理编码示例：
 
 ```bash
@@ -130,6 +130,18 @@ amap-cli install-skill --dir ~/.agents/skills --force
 amap-cli config set --api-key <YOUR_AMAP_KEY>
 ```
 
+设置每次高德 API 调用结束后的 sleep 时间：
+
+```bash
+amap-cli config set --request-sleep-seconds 0.34
+```
+
+关闭该 sleep：
+
+```bash
+amap-cli config set --request-sleep-seconds 0
+```
+
 查看当前配置：
 
 ```bash
@@ -142,6 +154,12 @@ amap-cli config show
 ~/Library/Application Support/amap-cli/config.json
 ```
 
+说明：
+
+- `request_sleep_seconds` 默认为 `0.34`
+- 该配置会在每次真实的高德 API 调用结束后执行一次 sleep
+- 设置为 `0` 表示关闭节流等待
+
 ### 安装 Skill
 
 基础格式：

{amap_cli-0.1.3 → amap_cli-0.1.4}/docs/manual-verification.md

@@ -74,6 +74,7 @@ uv run amap-cli distance --from 116.397,39.909 --to 116.407,39.904
 ```bash
 TMP_HOME=$(mktemp -d)
 HOME="$TMP_HOME" uv run amap-cli config set --api-key test-demo-key --timeout-seconds 12
+HOME="$TMP_HOME" uv run amap-cli config set --request-sleep-seconds 0
 HOME="$TMP_HOME" uv run amap-cli config show
 ```
 
@@ -83,6 +84,7 @@ HOME="$TMP_HOME" uv run amap-cli config show
 - macOS 下配置落在 `~/Library/Application Support/amap-cli/config.json`
 - 再次执行 `config show` 时可自动读取刚写入的配置
 - `api_key` 输出已脱敏
+- `request_sleep_seconds` 可写入为 `0`，用于关闭默认的请求后 sleep
 
 ### 5. `route` 典型输入通过 CLI 主入口走通到 handler
 

{amap_cli-0.1.3 → amap_cli-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "amap-cli"
-version = "0.1.3"
+version = "0.1.4"
 description = "Pure command-line CLI for Amap APIs."
 readme = "README.md"
 requires-python = ">=3.11"

{amap_cli-0.1.3 → amap_cli-0.1.4}/src/amap_cli/api.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import json
+import time
 from typing import Any
 from urllib.error import HTTPError, URLError
 from urllib.parse import urlencode
@@ -39,32 +40,36 @@ class AmapApiClient:
         )
 
         try:
-            with urlopen(request, timeout=self.config.timeout_seconds) as response:
-                body = response.read().decode("utf-8")
-        except HTTPError as exc:
-            response_body = exc.read().decode("utf-8", errors="ignore")
-            raise ApiRequestError(
-                f"高德 API HTTP 请求失败：{exc.code}",
-                details={"status": exc.code, "body": response_body},
-            ) from exc
-        except URLError as exc:
-            raise ApiRequestError(
-                "无法连接高德 API。",
-                details={"reason": str(exc.reason)},
-            ) from exc
-        except TimeoutError as exc:
-            raise ApiRequestError("请求高德 API 超时。") from exc
+            try:
+                with urlopen(request, timeout=self.config.timeout_seconds) as response:
+                    body = response.read().decode("utf-8")
+            except HTTPError as exc:
+                response_body = exc.read().decode("utf-8", errors="ignore")
+                raise ApiRequestError(
+                    f"高德 API HTTP 请求失败：{exc.code}",
+                    details={"status": exc.code, "body": response_body},
+                ) from exc
+            except URLError as exc:
+                raise ApiRequestError(
+                    "无法连接高德 API。",
+                    details={"reason": str(exc.reason)},
+                ) from exc
+            except TimeoutError as exc:
+                raise ApiRequestError("请求高德 API 超时。") from exc
 
-        try:
-            payload = json.loads(body)
-        except json.JSONDecodeError as exc:
-            raise ApiRequestError(
-                "高德 API 返回了非 JSON 响应。",
-                details={"body": body[:500]},
-            ) from exc
+            try:
+                payload = json.loads(body)
+            except json.JSONDecodeError as exc:
+                raise ApiRequestError(
+                    "高德 API 返回了非 JSON 响应。",
+                    details={"body": body[:500]},
+                ) from exc
 
-        self._raise_for_amap_error(payload)
-        return payload
+            self._raise_for_amap_error(payload)
+            return payload
+        finally:
+            if self.config.request_sleep_seconds > 0:
+                time.sleep(self.config.request_sleep_seconds)
 
     def _build_url(self, path: str, params: dict[str, Any]) -> str:
         """Build a full request URL from config and query params."""

{amap_cli-0.1.3 → amap_cli-0.1.4}/src/amap_cli/cli.py

@@ -56,6 +56,11 @@ def _register_config_command(
         type=float,
         help="请求超时时间（秒）",
     )
+    set_parser.add_argument(
+        "--request-sleep-seconds",
+        type=float,
+        help="每次高德 API 调用结束后的 sleep 时间（秒，0 表示关闭）",
+    )
     set_parser.set_defaults(handler=_handle_config_set)
 
     show_parser = config_subparsers.add_parser("show", help="查看当前配置（敏感信息脱敏）")
@@ -73,15 +78,17 @@ def _handle_config_set(args: argparse.Namespace) -> dict[str, Any]:
         args.api_key is None
         and args.base_url is None
         and args.timeout_seconds is None
+        and args.request_sleep_seconds is None
     ):
         raise ValidationError(
-            "请至少提供一个配置项，例如 `--api-key`、`--base-url` 或 `--timeout-seconds`。"
+            "请至少提供一个配置项，例如 `--api-key`、`--base-url`、`--timeout-seconds` 或 `--request-sleep-seconds`。"
         )
 
     config = save_config(
         api_key=args.api_key,
         base_url=args.base_url,
         timeout_seconds=args.timeout_seconds,
+        request_sleep_seconds=args.request_sleep_seconds,
     )
     return {
         "message": "配置已保存。",

{amap_cli-0.1.3 → amap_cli-0.1.4}/src/amap_cli/config.py

@@ -15,6 +15,7 @@ APP_NAME = "amap-cli"
 CONFIG_FILE_NAME = "config.json"
 DEFAULT_BASE_URL = "https://restapi.amap.com"
 DEFAULT_TIMEOUT_SECONDS = 10.0
+DEFAULT_REQUEST_SLEEP_SECONDS = 0.34
 
 
 @dataclass(slots=True)
@@ -24,6 +25,7 @@ class AmapConfig:
     api_key: str | None = None
     base_url: str = DEFAULT_BASE_URL
     timeout_seconds: float = DEFAULT_TIMEOUT_SECONDS
+    request_sleep_seconds: float = DEFAULT_REQUEST_SLEEP_SECONDS
 
     @classmethod
     def from_dict(cls, raw: dict[str, Any]) -> "AmapConfig":
@@ -31,6 +33,10 @@ class AmapConfig:
         api_key = raw.get("api_key")
         base_url = raw.get("base_url", DEFAULT_BASE_URL)
         timeout_seconds = raw.get("timeout_seconds", DEFAULT_TIMEOUT_SECONDS)
+        request_sleep_seconds = raw.get(
+            "request_sleep_seconds",
+            DEFAULT_REQUEST_SLEEP_SECONDS,
+        )
 
         if api_key is not None and not isinstance(api_key, str):
             raise ConfigError("配置文件中的 api_key 格式无效。")
@@ -38,6 +44,11 @@ class AmapConfig:
             raise ConfigError("配置文件中的 base_url 格式无效。")
         if not isinstance(timeout_seconds, (int, float)) or timeout_seconds <= 0:
             raise ConfigError("配置文件中的 timeout_seconds 格式无效。")
+        if (
+            not isinstance(request_sleep_seconds, (int, float))
+            or request_sleep_seconds < 0
+        ):
+            raise ConfigError("配置文件中的 request_sleep_seconds 格式无效。")
 
         normalized_api_key = None
         if api_key is not None:
@@ -47,6 +58,7 @@ class AmapConfig:
             api_key=normalized_api_key,
             base_url=base_url.strip(),
             timeout_seconds=float(timeout_seconds),
+            request_sleep_seconds=float(request_sleep_seconds),
         )
 
     def to_dict(self, *, mask_secrets: bool = False) -> dict[str, Any]:
@@ -149,6 +161,7 @@ def save_config(
     api_key: str | None = None,
     base_url: str | None = None,
     timeout_seconds: float | None = None,
+    request_sleep_seconds: float | None = None,
 ) -> AmapConfig:
     """Persist config updates to the OS-specific config path."""
     config = load_config(required=False) or AmapConfig()
@@ -170,6 +183,11 @@ def save_config(
             raise ValidationError("`--timeout-seconds` 必须大于 0。")
         config.timeout_seconds = float(timeout_seconds)
 
+    if request_sleep_seconds is not None:
+        if request_sleep_seconds < 0:
+            raise ValidationError("`--request-sleep-seconds` 不能小于 0。")
+        config.request_sleep_seconds = float(request_sleep_seconds)
+
     path = get_config_path()
     try:
         path.parent.mkdir(parents=True, exist_ok=True)

{amap_cli-0.1.3 → amap_cli-0.1.4}/uv.lock

@@ -4,5 +4,5 @@ requires-python = ">=3.11"
 
 [[package]]
 name = "amap-cli"
-version = "0.1.3"
+version = "0.1.4"
 source = { editable = "." }