makea-cli 0.1.1__py3-none-any.whl

makea_cli/config.py

@@ -0,0 +1,74 @@
+import json
+import os
+from pathlib import Path
+from typing import Any
+
+from platformdirs import user_config_dir
+
+CONFIG_DIR = Path(user_config_dir("makea-cli", appauthor=False))
+CREDENTIALS_PATH = CONFIG_DIR / "credentials.json"
+
+# Production Makea API endpoints — built in so everyday users need no config.
+# Optional MAKEA_* environment variables override these (e.g. staging); see README.
+DEFAULT_API_BASE_URL = "https://api.makea.co"
+DEFAULT_COGNITO_DOMAIN = "eu-west-1r9ghlpgky.auth.eu-west-1.amazoncognito.com"
+DEFAULT_COGNITO_CLIENT_ID = "3nfj8g3et4o85kd6essas16vh0"
+DEFAULT_REDIRECT_URI = "http://127.0.0.1:8250/callback"
+
+
+def _env(name: str, default: str | None = None) -> str | None:
+    v = os.environ.get(name)
+    if v is not None and v.strip() != "":
+        return v.strip()
+    return default
+
+
+def api_base_url() -> str:
+    base = _env("MAKEA_API_BASE_URL", DEFAULT_API_BASE_URL) or DEFAULT_API_BASE_URL
+    return base.rstrip("/")
+
+
+def cognito_domain_host() -> str:
+    """
+    Host only, e.g. my-pool.auth.us-east-1.amazoncognito.com
+    (no https://).
+    """
+    d = _env("MAKEA_COGNITO_DOMAIN", DEFAULT_COGNITO_DOMAIN) or DEFAULT_COGNITO_DOMAIN
+    d = d.removeprefix("https://").removeprefix("http://").split("/")[0]
+    return d
+
+
+def cognito_client_id() -> str:
+    return (
+        _env("MAKEA_COGNITO_CLIENT_ID", DEFAULT_COGNITO_CLIENT_ID)
+        or DEFAULT_COGNITO_CLIENT_ID
+    )
+
+
+def redirect_uri() -> str:
+    return _env("MAKEA_REDIRECT_URI", DEFAULT_REDIRECT_URI) or DEFAULT_REDIRECT_URI
+
+
+def load_credentials() -> dict[str, Any] | None:
+    if not CREDENTIALS_PATH.is_file():
+        return None
+    try:
+        return json.loads(CREDENTIALS_PATH.read_text(encoding="utf-8"))
+    except (json.JSONDecodeError, OSError):
+        return None
+
+
+def save_credentials(data: dict[str, Any]) -> None:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CREDENTIALS_PATH.write_text(json.dumps(data, indent=2), encoding="utf-8")
+    try:
+        CREDENTIALS_PATH.chmod(0o600)
+    except OSError:
+        pass
+
+
+def clear_credentials() -> None:
+    try:
+        CREDENTIALS_PATH.unlink(missing_ok=True)
+    except OSError:
+        pass

makea_cli/main.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+from makea_cli import __version__
+from makea_cli.commands import register_all
+
+console = Console()
+app = typer.Typer(
+    name="makea-cli",
+    help=(
+        "Makea admin CLI: sign in once in the browser, then run commands. "
+        "No URL or API keys to configure. Most commands require an admin Makea account."
+    ),
+    no_args_is_help=True,
+)
+
+register_all(app)
+
+
+@app.command("version", help="Print this CLI package version string.")
+def version_cmd() -> None:
+    """Print CLI version."""
+    console.print(__version__)
+
+
+if __name__ == "__main__":
+    app()

makea_cli-0.1.1.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: makea-cli
+Version: 0.1.1
+Summary: Makea admin CLI (browser login + Makea admin HTTP API)
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# makea-cli
+
+给 **Makea** 内部同事用的命令行小工具：连的是线上正式环境，**装好就能用，不用配环境变量、不用改配置文件**。
+
+第一次用时在浏览器里登录一次公司账号，之后在本机保存登录状态，即可查询用户、供应商等（具体能执行哪些命令取决于你的账号权限）。
+
+---
+
+## 怎么用（三步）
+
+1. **安装**（本机需要已安装 [Python 3.10 或以上](https://www.python.org/downloads/)）
+  - **从本仓库安装（开发 / 内网 clone）：** 在 `makea-cli/` 目录执行  
+   `python3 -m pip install -e .`  
+   若提示找不到 `python3`，可改用 `python`。
+  - **不经过 GitHub：** 把本包的 **Python** 发行版发布到公司私有 PyPI / Artifact Registry 等，同事执行  
+  `python3 -m pip install makea-cli`（或 `pipx install makea-cli`）即可；无需 clone 仓库。
+  - **可选 — 用 npm 只占一个全局命令名：** 仓库里 `npm/makea-cli/` 是一个 **薄封装**，`npm install -g` 后会把 `makea-cli` 指到 `python3 -m makea_cli`；**仍需**在同一台机器上先用 `pip` 装好同名 Python 包（npm 不会替你安装 Python 依赖）。适合已经用 npm 管理全局工具的团队。
+2. **登录（只需做一次，或过期后再做）**
+  ```bash
+   makea-cli auth
+  ```
+   会自动打开浏览器，按公司流程登录即可。完成后可以关掉浏览器标签页。
+3. **执行功能**（示例）
+  ```bash
+   makea-cli list-users
+   makea-cli list-suppliers
+   makea-cli list-product-orders
+   makea-cli list-sampling-orders-by-product <product_reference_id>
+   makea-cli list-production-orders-by-product <product_reference_id>
+  ```
+   **从「产品订单」JSON 下载附件：** `list-product-orders` 返回的每条 `result` 里已有 `user_id` 和 `available_documents`（含 `document_id`、`admin_user_id` 等），一般 **不必再调单独的 document metadata API**。可直接：
+   若只有 `product_reference_id`，可用（建议加上设计师 `user_id` 避免扫全库）：
+   更多子命令与参数：
+
+退出登录（清除本机保存的令牌）：
+
+```bash
+makea-cli auth --logout
+```
+
+---
+
+## 登录信息保存在哪
+
+保存在本机当前用户下的应用数据目录里（例如 macOS 常见为 `~/Library/Application Support/makea-cli/`，Linux 常见为 `~/.config/makea-cli/`），文件名类似 `credentials.json`。一般不用手动打开。
+
+---
+
+## 给技术同事：可选环境变量
+
+日常同事 **不需要** 看本节。只有要连 **非线上** 或 **自建环境** 时，才用环境变量覆盖内置地址（默认值在 `makea_cli/config.py` 里）：
+
+
+| 变量                        | 说明                                             |
+| ------------------------- | ---------------------------------------------- |
+| `MAKEA_API_BASE_URL`      | API 根地址（无末尾 `/`）                               |
+| `MAKEA_COGNITO_DOMAIN`    | Cognito Hosted UI 的**主机名**（不要写 `https://`）     |
+| `MAKEA_COGNITO_CLIENT_ID` | Cognito 应用客户端 ID                               |
+| `MAKEA_REDIRECT_URI`      | OAuth 回调地址，默认 `http://127.0.0.1:8250/callback` |
+
+
+---
+
+## 命令一览
+
+- `makea-cli auth` — 浏览器登录并保存令牌  
+- `makea-cli auth --logout` — 清除本机令牌  
+- `makea-cli list-users` — 列出用户（需管理员权限）  
+- `makea-cli list-suppliers` — 列出供应商（需管理员权限）  
+- `makea-cli get-quote-requests-by-supplier-id <supplier_id> [--status <status>] [-n <limit>]` — 直连后端按 supplier_id 查询 quote requests  
+- `makea-cli get-supplier-links-by-supplier-id <supplier_id> [--link-type SAMPLING|PRODUCTION]` — 直连后端按 supplier_id 查询 supplier links  
+- `makea-cli list-product-orders` — 列出所有设计师产品订单（GET `/admin/designer/get_all_product_orders`）  
+- `makea-cli list-sampling-orders-by-product <id>` — 按产品 reference id 列打样单  
+- `makea-cli list-production-orders-by-product <id>` — 按产品 reference id 列大货单  
+- `makea-cli download-document <document_id> -u <user_id>` — 下载单个文件（GET `/admin/document/download`）  
+- `makea-cli download-product-document <product_reference_id> <document_id> -d <designer_user_id>` — 按产品行 + 文档 id 下载（内部用订单列表 JSON，不额外查 metadata）  
+- `makea-cli backfill-supplier-id --user-id <cognito_sub> --old-supplier-id <wrong_uuid>` — 供应商 `supplier_id` 迁到 Cognito `sub`（默认 dry-run，加 `--apply` 才写入；详见 `makea-cli backfill-supplier-id --help`）  
+- `makea-cli version` — 打印版本号
+
+---
+
+## Claude / Cursor skills（可选）
+
+仓库内 `.claude/skills/` 下放有面向 agent 的操作说明，例如：
+
+- `supplier-user-id-migration` — 供应商 ID 与 Cognito sub 对齐、与 `backfill-supplier-id` 配套
+

makea_cli-0.1.1.dist-info/RECORD

@@ -0,0 +1,28 @@
+makea_cli/__init__.py,sha256=rnObPjuBcEStqSO0S6gsdS_ot8ITOQjVj_-P1LUUYpg,22
+makea_cli/__main__.py,sha256=7BdV0s4m5cc7C-JcxJKPM2amGV37EIVIXu1pDSUpp7E,142
+makea_cli/api_client.py,sha256=1wABEVsg-b6T0vPMpAFSO3cP3YKAwXEWCn3xJFLQaCQ,12059
+makea_cli/auth_pkce.py,sha256=6Uf1K0ic4sw2pAl6LP2tCobKblsC1L3xhIxACEBOGYY,7479
+makea_cli/config.py,sha256=YvxLyWsUxVYRsuS2vFHTO6ZWJBep1EjyepCVVm-DB4s,2171
+makea_cli/main.py,sha256=JIOy07OedCKVV_PEZFFJfc3DQbzxzKXYVrVUVZca3E4,652
+makea_cli/commands/__init__.py,sha256=bKkeZucsvdm1QEDei0dYcbgi-alpZHNl8B0Eo2rnRUw,874
+makea_cli/commands/_util.py,sha256=FAGGKMpizb267j8Dpwj8Q_IyFxVQUdh-n3n7PzBSmq8,390
+makea_cli/commands/auth/__init__.py,sha256=NXoKGfkY2X_hb8GnAyzhoI_qDXfpwKZPqt4HnOrXW3Y,73
+makea_cli/commands/auth/cmd.py,sha256=G9ZeiaJwzUUTptIyynr0V-82wI7eV0qVX0pD6rdPSXg,1321
+makea_cli/commands/directory/__init__.py,sha256=rQHBc0JOFXynlzrBm_YfqoRuNsS-JOl-OOvPjgDbnIA,78
+makea_cli/commands/directory/cmd.py,sha256=kK3u4m3mEJiC7B62f7ibeveQ4Tvfx3mblpmrqZdVsis,1117
+makea_cli/commands/document/__init__.py,sha256=7u8jLBGeryD7ocqX17DCf0eCkyjcrpzXcwc2wEEOXw8,77
+makea_cli/commands/document/cmd.py,sha256=HeWs3hN06NmFzM6wHnQwkBg8RbmW4ZH21tJ56pSUp34,6019
+makea_cli/commands/email/__init__.py,sha256=EWMqMTgZK1GQDW7-9RGVSGU-CvaHTARjXZL18Hdj80I,74
+makea_cli/commands/email/cmd.py,sha256=Ct1oi94gdsydV9foRx_kyvQG0XOaZ0PjNUGMeIx61JM,3942
+makea_cli/commands/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+makea_cli/commands/metrics/cmd.py,sha256=PvNMcGRLUWoXq7_io4JahK_BuQeK5BTVjx5R9SFijTY,3536
+makea_cli/commands/orders/__init__.py,sha256=6WKPqX02e0RRPmItPIBJ0TA4_yDI2PVvBDkAiMQu9rU,75
+makea_cli/commands/orders/cmd.py,sha256=y9SbyAevrCO_iwntNArRHpemrTNeaerAcHMqjf3eNy8,6924
+makea_cli/commands/product/__init__.py,sha256=mfdonFmpbddDSlJq6JWNWgNpM6aOpKtZr-3FJ6scrwg,76
+makea_cli/commands/product/cmd.py,sha256=mrtLsyYsQpKLJ5bg0sjkLOXg_BUC6zZDiG7OjJEUeaY,5683
+makea_cli/commands/supplier/__init__.py,sha256=qfQDeQdQ-B7I_uwFVfcp1vXFUTL4fAcNLu3ipsZ7dfs,77
+makea_cli/commands/supplier/cmd.py,sha256=z2RKcgSr9mFgO6kK3zulM5n6lmgSF4fSv6K0s1st2Fg,12399
+makea_cli-0.1.1.dist-info/METADATA,sha256=9iIPTmNFmhyFDlvKg02lHN1fPPbNdfnRg-BiEUBcLZ8,5232
+makea_cli-0.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+makea_cli-0.1.1.dist-info/entry_points.txt,sha256=roop5-ZvEsGz60WfivSkuhTobja8wVlls9RBylHO6QY,49
+makea_cli-0.1.1.dist-info/RECORD,,

makea_cli-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

makea_cli-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+makea-cli = makea_cli.main:app