shopping-cli 3.2.3__tar.gz → 3.2.4__tar.gz

{shopping_cli-3.2.3/shopping_cli.egg-info → shopping_cli-3.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shopping-cli
-Version: 3.2.3
+Version: 3.2.4
 Summary: Standalone local-commerce AI consultation marketplace runtime
 License:                                  Apache License
                                    Version 2.0, January 2004

{shopping_cli-3.2.3 → shopping_cli-3.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "shopping-cli"
-version = "3.2.3"
+version = "3.2.4"
 description = "Standalone local-commerce AI consultation marketplace runtime"
 readme = "README.md"
 requires-python = ">=3.11"

{shopping_cli-3.2.3 → shopping_cli-3.2.4}/shopping_cli/__init__.py

@@ -1,3 +1,3 @@
 """Standalone shopping-cli consultation runtime."""
 
-VERSION = "3.2.3"
+VERSION = "3.2.4"

{shopping_cli-3.2.3 → shopping_cli-3.2.4}/shopping_cli/cli.py

@@ -866,7 +866,8 @@ def build_parser() -> argparse.ArgumentParser:
     import_csv = subparsers.add_parser(
         "import-csv-excel", help="Import product facts from CSV / Excel (.xlsx) into the local store"
     )
-    import_csv.add_argument("--file", required=True, help="Path to .csv / .tsv / .xlsx file")
+    import_csv.add_argument("--file", default="", help="Path to .csv / .tsv / .xlsx file (required unless --template)")
+    import_csv.add_argument("--template", default="", dest="template", help="写一份 CSV 模板到该路径后退出（不导入）")
     import_csv.add_argument("--merchant", default="", dest="merchant", help="Owning merchant id (or SHOPPING_MERCHANT_ID / KIWI_MERCHANT_ID)")
     import_csv.add_argument("--default-merchant", default="", dest="default_merchant", help=argparse.SUPPRESS)
     import_csv.add_argument("--allowed-merchant", default="", dest="allowed_merchant", help="Tenant boundary: only rows of this merchant are written")

{shopping_cli-3.2.3 → shopping_cli-3.2.4}/shopping_cli/cli_adapter_commands.py

@@ -18,6 +18,14 @@ from shopping_cli.data_sources.adapter import (
 )
 from shopping_cli.db.session import db_session
 
+# CSV/Excel 导入模板（与 examples/products-template.csv 一致）。必填列 sku/title/
+# price/stock；可选 currency（缺省 CNY）/ category / description / merchant_id。
+PRODUCTS_TEMPLATE_CSV = (
+    "sku,title,price,stock,currency,category,description\n"
+    "VQ-001,智能保温杯 500ml,129.00,50,CNY,kitchenware,316 不锈钢内胆真空保温\n"
+    "VQ-002,桌面无线充电器 15W,89.00,120,CNY,electronics,兼容 QC3.0\n"
+)
+
 
 def cmd_adapters_list(args: argparse.Namespace) -> None:
     """列出已注册适配器（Adapter SDK 注册表）。"""
@@ -28,7 +36,19 @@ def cmd_adapters_list(args: argparse.Namespace) -> None:
 
 
 def cmd_import_csv_excel(args: argparse.Namespace) -> None:
-    """运行 CSV/Excel 适配器导入本地 products 表。"""
+    """运行 CSV/Excel 适配器导入本地 products 表；--template 只生成模板不导入。"""
+    template_path = str(getattr(args, "template", "") or "").strip()
+    if template_path:
+        with open(template_path, "w", encoding="utf-8", newline="") as fh:
+            fh.write(PRODUCTS_TEMPLATE_CSV)
+        emit(
+            {"ok": True, "message": f"CSV 模板已写入 {template_path}（填好 sku/title/price/stock 后再导入）"},
+            getattr(args, "format", "text"),
+        )
+        return
+    file_path = str(args.file or "").strip()
+    if not file_path:
+        raise SystemExit("--file <path> 必填（或先用 --template <path> 生成模板）")
     db_path = db_path_from_args(args)
     merchant_id = (
         str(args.merchant or "").strip()

{shopping_cli-3.2.3 → shopping_cli-3.2.4/shopping_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shopping-cli
-Version: 3.2.3
+Version: 3.2.4
 Summary: Standalone local-commerce AI consultation marketplace runtime
 License:                                  Apache License
                                    Version 2.0, January 2004