data-ops-cli 0.3.5__tar.gz → 0.4.0__tar.gz

data_ops_cli-0.4.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: data-ops-cli
+Version: 0.4.0
+Summary: Command-line wrapper around dataops_sdk for the DataOps platform.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: dataops-sdk[runner]>=0.4.0
+Requires-Dist: typer
+Requires-Dist: rich
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# data-ops-cli
+
+DataOps platform command-line tool, powered by `dataops_sdk`.
+
+## 安装
+
+```bash
+# 在线安装
+pip install data-ops-cli
+
+# 本地开发
+uv sync --all-extras
+pip install -e packages/dataops_cli
+```
+
+## 认证配置
+
+```bash
+# 环境变量方式
+export DATA_OPS_BASE_URL="https://your-platform.com"
+export DATA_OPS_API_KEY="your-api-key"
+
+# 或首次使用时 CLI 会引导输入
+data-ops-cli auth login
+```
+
+## 命令
+
+完整命令树见 [skills/data-ops-cli-usage/SKILL.md](../skills/data-ops-cli-usage/SKILL.md)。
+
+### 认证
+
+```bash
+data-ops-cli auth login
+data-ops-cli auth status
+```
+
+### 数据源
+
+```bash
+data-ops-cli datasource list
+data-ops-cli datasource detail <id>
+```
+
+### 数据集
+
+```bash
+data-ops-cli dataset list
+data-ops-cli dataset detail <id>
+```
+
+### 数据表
+
+```bash
+data-ops-cli data_table list
+data-ops-cli data_table detail <id>
+```
+
+### 指标
+
+```bash
+data-ops-cli metrics list
+data-ops-cli metrics detail <id>
+```
+
+### 报表
+
+```bash
+data-ops-cli report list
+data-ops-cli report detail <id>
+```
+
+### 工作流
+
+```bash
+data-ops-cli workflow list
+data-ops-cli workflow detail <id>
+```
+
+### AMIS 组件
+
+```bash
+data-ops-cli widget list
+data-ops-cli widget detail <id>
+data-ops-cli widget print <id>
+```
+
+## 依赖
+
+- Python >= 3.11
+- data-ops-cli 内部依赖 `dataops_sdk[runner]`

data_ops_cli-0.4.0/README.md

@@ -0,0 +1,91 @@
+# data-ops-cli
+
+DataOps platform command-line tool, powered by `dataops_sdk`.
+
+## 安装
+
+```bash
+# 在线安装
+pip install data-ops-cli
+
+# 本地开发
+uv sync --all-extras
+pip install -e packages/dataops_cli
+```
+
+## 认证配置
+
+```bash
+# 环境变量方式
+export DATA_OPS_BASE_URL="https://your-platform.com"
+export DATA_OPS_API_KEY="your-api-key"
+
+# 或首次使用时 CLI 会引导输入
+data-ops-cli auth login
+```
+
+## 命令
+
+完整命令树见 [skills/data-ops-cli-usage/SKILL.md](../skills/data-ops-cli-usage/SKILL.md)。
+
+### 认证
+
+```bash
+data-ops-cli auth login
+data-ops-cli auth status
+```
+
+### 数据源
+
+```bash
+data-ops-cli datasource list
+data-ops-cli datasource detail <id>
+```
+
+### 数据集
+
+```bash
+data-ops-cli dataset list
+data-ops-cli dataset detail <id>
+```
+
+### 数据表
+
+```bash
+data-ops-cli data_table list
+data-ops-cli data_table detail <id>
+```
+
+### 指标
+
+```bash
+data-ops-cli metrics list
+data-ops-cli metrics detail <id>
+```
+
+### 报表
+
+```bash
+data-ops-cli report list
+data-ops-cli report detail <id>
+```
+
+### 工作流
+
+```bash
+data-ops-cli workflow list
+data-ops-cli workflow detail <id>
+```
+
+### AMIS 组件
+
+```bash
+data-ops-cli widget list
+data-ops-cli widget detail <id>
+data-ops-cli widget print <id>
+```
+
+## 依赖
+
+- Python >= 3.11
+- data-ops-cli 内部依赖 `dataops_sdk[runner]`

{data_ops_cli-0.3.5 → data_ops_cli-0.4.0}/pyproject.toml

@@ -7,8 +7,9 @@ name = "data-ops-cli"
 dynamic = ["version"]
 description = "Command-line wrapper around dataops_sdk for the DataOps platform."
 requires-python = ">=3.11"
+readme = "README.md"
 dependencies = [
-    "dataops-sdk[runner]>=0.3.4",
+    "dataops-sdk[runner]>=0.4.0",
     "typer",
     "rich",
 ]

data_ops_cli-0.4.0/src/data_ops_cli.egg-info/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: data-ops-cli
+Version: 0.4.0
+Summary: Command-line wrapper around dataops_sdk for the DataOps platform.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: dataops-sdk[runner]>=0.4.0
+Requires-Dist: typer
+Requires-Dist: rich
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# data-ops-cli
+
+DataOps platform command-line tool, powered by `dataops_sdk`.
+
+## 安装
+
+```bash
+# 在线安装
+pip install data-ops-cli
+
+# 本地开发
+uv sync --all-extras
+pip install -e packages/dataops_cli
+```
+
+## 认证配置
+
+```bash
+# 环境变量方式
+export DATA_OPS_BASE_URL="https://your-platform.com"
+export DATA_OPS_API_KEY="your-api-key"
+
+# 或首次使用时 CLI 会引导输入
+data-ops-cli auth login
+```
+
+## 命令
+
+完整命令树见 [skills/data-ops-cli-usage/SKILL.md](../skills/data-ops-cli-usage/SKILL.md)。
+
+### 认证
+
+```bash
+data-ops-cli auth login
+data-ops-cli auth status
+```
+
+### 数据源
+
+```bash
+data-ops-cli datasource list
+data-ops-cli datasource detail <id>
+```
+
+### 数据集
+
+```bash
+data-ops-cli dataset list
+data-ops-cli dataset detail <id>
+```
+
+### 数据表
+
+```bash
+data-ops-cli data_table list
+data-ops-cli data_table detail <id>
+```
+
+### 指标
+
+```bash
+data-ops-cli metrics list
+data-ops-cli metrics detail <id>
+```
+
+### 报表
+
+```bash
+data-ops-cli report list
+data-ops-cli report detail <id>
+```
+
+### 工作流
+
+```bash
+data-ops-cli workflow list
+data-ops-cli workflow detail <id>
+```
+
+### AMIS 组件
+
+```bash
+data-ops-cli widget list
+data-ops-cli widget detail <id>
+data-ops-cli widget print <id>
+```
+
+## 依赖
+
+- Python >= 3.11
+- data-ops-cli 内部依赖 `dataops_sdk[runner]`

{data_ops_cli-0.3.5 → data_ops_cli-0.4.0}/src/data_ops_cli.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+README.md
 pyproject.toml
 src/data_ops_cli.egg-info/PKG-INFO
 src/data_ops_cli.egg-info/SOURCES.txt

{data_ops_cli-0.3.5 → data_ops_cli-0.4.0}/src/data_ops_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-dataops-sdk[runner]>=0.3.4
+dataops-sdk[runner]>=0.4.0
 typer
 rich
 

{data_ops_cli-0.3.5 → data_ops_cli-0.4.0}/src/dataops_cli/__init__.py

@@ -14,4 +14,4 @@ groups command modules under :mod:`dataops_cli.cli` and re-exports the package
     removed in ``dataops_cli`` 1.0.
 """
 
-__version__ = "0.3.5"
+__version__ = "0.4.0"

{data_ops_cli-0.3.5 → data_ops_cli-0.4.0}/src/dataops_cli/cli/data_table.py

@@ -9,17 +9,16 @@ from typing import Annotated
 
 import typer
 from dataops_sdk.exceptions import DataOpsError
-from dataops_sdk.schemas import MetaType, PageParam, SqlQueryParam
+from dataops_sdk.schemas import MetaType, PageParam, SqlFilter, SqlQueryParam
 from dataops_sdk.services import (
     service_get_data_table_by_code,
     service_get_data_table_by_name,
     service_get_data_table_data_by_code,
     service_get_data_table_data_by_name,
+    service_get_data_table_total,
 )
 from dataops_sdk.services.meta import release_list_list
 from dataops_sdk.utils import filter_nodes_by_pattern
-from rich.console import Console
-from rich.table import Table
 
 from dataops_cli.cli.utils import print_list
 
@@ -68,8 +67,8 @@ def list_datatable(
         group_nodes = filter_nodes_by_pattern(group_nodes, query, include_digest=True)
 
     print_list(
-        ["code", "title", "remark"],
-        [[column.code, column.title, column.remark] for column in group_nodes],
+        ["code", "name", "title", "remark"],
+        [[column.code, column.name, column.title, column.remark or ""] for column in group_nodes],
     )
 
 
@@ -106,23 +105,22 @@ def get_datatable_detail(
         typer.echo("错误: 未找到多维表格")
         raise typer.Exit(code=1) from None
 
-    table = Table("field", "value", show_header=False)
-    table.add_row("datasource", meta.data.model.datasource)
-    table.add_row("引用类型", meta.data.model.ref_type)
-    table.add_row("引用编码", meta.data.model.ref_code)
-    table.add_row("引用表名", meta.data.model.table_name)
-
-    console = Console(no_color=True)
-    console.print(table)
+    print("ref-datasource ref-type ref-code ref-table-name")
+    print(
+        meta.data.model.datasource,
+        meta.data.model.ref_type,
+        meta.data.model.ref_code,
+        meta.data.model.table_name,
+    )
+    print()
 
     print_list(
-        ["column(visable)", "type", "title", "visible"],
+        ["column(visable)", "type", "title"],
         [
             [
                 field.name + f"({'√' if field.visible else 'x'})",
                 field.type,
                 field.title,
-                field.visible,
             ]
             for field in meta.data.fields
         ],
@@ -243,27 +241,47 @@ def get_datatable_data(
     name: Annotated[str | None, typer.Argument(help="表名")] = None,
     page_num: Annotated[int, typer.Option("-n", "--page-num", help="页码")] = 0,
     page_size: Annotated[int, typer.Option("-s", "--page-size", help="每页大小")] = 20,
-    query_param: Annotated[
-        str | None, typer.Option("--query", "-q", help="查询参数(SqlQueryParam)")
+    filters: Annotated[
+        list[SqlFilter] | None,
+        typer.Option(
+            "--condition",
+            "-c",
+            parser=SqlFilter.from_str,
+            help='查询条件(可多次传入)，JSON 格式 {"name":"字段名","value":值[,"expression":"eq"]}，expression 缺省 eq',
+        ),
     ] = None,
 ) -> None:
     """获取多维表格数据。
 
-    按编码或 (数据源, 表名) 组合查询多维表格数据；支持分页与 ``SqlQueryParam``
-    形式的条件过滤。
+    按编码或 (数据源, 表名) 组合查询多维表格数据；支持分页与查询条件过滤。
 
     Args:
         arg1: 多维表格编码；当同时提供 ``name`` 时为数据源名称。
         name: 可选表名。
-        page: 页码。
-        size: 每页条数。
-        query_param: 可选 SqlQueryParam JSON。
+        page_num: 页码，默认 0。
+        page_size: 每页大小，默认 20。
+        filters: 查询条件，JSON 格式 ``{"name": 字段名, "value": 值[, "expression": 表达式]}``。
+            可多次传入，多个条件按 AND 组合；``expression`` 缺省为 ``eq``，可选
+            ``eq/ne/gt/ge/lt/le/in/notin/like/notlike/between/notbetween/isnull/isnotnull``。
 
     Examples:
-        >>> data-ops-cli data_table data dt_code_001
+        通过多维表格编码查询数据
+        >>> data-ops-cli data_table data <code>
+        通过数据源和表名查询数据
+        >>> data-ops-cli data_table data <datasource> <name>
+        带查询条件过滤（status 等于 1）
+        >>> data-ops-cli data_table data <code> -c '{"name": "status", "value": 1}'
     """
+    if not name and not arg1.replace("_", "").replace("-", "").isnumeric():
+        print(
+            "输入参数错误 using `data_table data <code>` or `data_table data <datasource> <name>`"
+        )
+        raise typer.Exit(code=1) from None
+
     pp = PageParam(start=page_num * page_size, limit=page_size)
-    qp = SqlQueryParam.model_validate_json(query_param) if query_param else SqlQueryParam()
+    qp = SqlQueryParam()
+    if filters:
+        qp.add(*(filter_item.to_condition() for filter_item in filters))
 
     try:
         datas = (
@@ -272,16 +290,53 @@ def get_datatable_data(
             else service_get_data_table_data_by_code(arg1, pp, qp)
         )
     except DataOpsError as e:
-        typer.echo(f"错误: {e.message}")
+        typer.echo(f"错误: {e.message}", err=True)
         raise typer.Exit(code=1) from None
     if not datas:
         print("未查询到数据")
         return
 
     # 取第一行构建列
-    keys = map(lambda x: x.lower(), datas[0].keys())
+    keys = (x.lower() for x in datas[0])
     print_list(keys, (tuple(row.values()) for row in datas))
 
 
-if __name__ == "__main__":
-    list_datatable()
+@data_table_typer.command("count", no_args_is_help=True)
+def count_datatable(
+    code: Annotated[str, typer.Argument(help="多维表格编码")],
+    filters: Annotated[
+        list[SqlFilter] | None,
+        typer.Option(
+            "--condition",
+            "-c",
+            parser=SqlFilter.from_str,
+            help='查询条件(可多次传入)，JSON 格式 {"name":"字段名","value":值[,"expression":"eq"]}，expression 缺省 eq',
+        ),
+    ] = None,
+) -> None:
+    """统计多维表格数据总数。
+
+    支持通过 ``--condition/-c`` 参数（可多次传入）添加查询条件过滤。
+
+    Args:
+        code: 多维表格编码。
+        filters: 查询条件，JSON 格式 ``{"name": 字段名, "value": 值[, "expression": 表达式]}``。
+            可多次传入，多个条件按 AND 组合；``expression`` 缺省为 ``eq``，可选
+            ``eq/ne/gt/ge/lt/le/in/notin/like/notlike/between/notbetween/isnull/isnotnull``。
+
+    Examples:
+        统计多维表格数据总数
+        >>> data-ops-cli data_table count dt_code_001
+
+        带查询条件统计（status 等于 1）
+        >>> data-ops-cli data_table count dt_code_001 -c '{"name": "status", "value": 1}'
+    """
+    qp = SqlQueryParam()
+    if filters:
+        qp.add(*(filter_item.to_condition() for filter_item in filters))
+    try:
+        total = service_get_data_table_total(code, qp)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from e
+    print(total)