data-ops-cli 0.3.6__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.6 → 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.6",
+    "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.6 → 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.6 → data_ops_cli-0.4.0}/src/data_ops_cli.egg-info/requires.txt

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

{data_ops_cli-0.3.6 → 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.6"
+__version__ = "0.4.0"

{data_ops_cli-0.3.6 → 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
 
@@ -107,7 +106,12 @@ def get_datatable_detail(
         raise typer.Exit(code=1) from None
 
     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(
+        meta.data.model.datasource,
+        meta.data.model.ref_type,
+        meta.data.model.ref_code,
+        meta.data.model.table_name,
+    )
     print()
 
     print_list(
@@ -237,34 +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 <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 `table detail <code>` or `table detail <datasource> <name>`")
+        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 = (
@@ -273,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)

{data_ops_cli-0.3.6 → data_ops_cli-0.4.0}/src/dataops_cli/cli/dataset.py

@@ -7,7 +7,7 @@ from typing import Annotated
 
 import typer
 from dataops_sdk.exceptions import DataOpsError
-from dataops_sdk.schemas import PageParam, SqlQueryParam
+from dataops_sdk.schemas import PageParam, SqlFilter, SqlQueryParam
 from dataops_sdk.services import (
     service_count_dataset_by_code,
     service_get_dataset_data_by_code,
@@ -15,11 +15,8 @@ from dataops_sdk.services import (
     service_list_datasets,
 )
 from dataops_sdk.utils import filter_nodes_by_pattern
-from pydantic import ValidationError
-from rich.console import Console
-from rich.table import Table
 
-from dataops_cli.cli.utils import print_list
+from dataops_cli.cli.utils import print_list, print_table_column_detail
 
 dataset_typer = typer.Typer(name="dataset", help="Manage dataset.", no_args_is_help=True)
 
@@ -27,6 +24,7 @@ dataset_typer = typer.Typer(name="dataset", help="Manage dataset.", no_args_is_h
 @dataset_typer.command("list")
 def list_dataset(
     query: Annotated[str | None, typer.Option("-q", "--query", help="名称关键字")] = None,
+    head: Annotated[int | None, typer.Option("-h", "--head", min=1, help="显示前N条记录")] = None,
 ) -> None:
     """列出所有数据集。
 
@@ -51,9 +49,12 @@ def list_dataset(
     if query:
         group_nodes = filter_nodes_by_pattern(group_nodes, query, include_digest=True)
 
+    if head is not None and head > 0:
+        group_nodes = group_nodes[:head]
+
     print_list(
-        ["code", "name", "alias", "remark"],
-        [[column.code, column.name, column.title, column.remark] for column in group_nodes],
+        ["code", "title", "remark"],
+        [[column.code, column.title, column.remark] for column in group_nodes],
     )
 
 
@@ -84,52 +85,49 @@ def get_dataset_detail_by_code(
         typer.echo(f"错误: {e.message}")
         raise typer.Exit(code=1) from None
 
-    console = Console(no_color=True)
-    if full:
-        table = Table("column", "alias", "dbType", "relation")
-        for column in meta.data.columns:
-            relation = None
-            if column.typeExt is not None:
-                relation = column.typeExt.ref__dict or column.typeExt.ref__valueField
-            if relation is not None:
-                relation = relation.model_dump_json()
-            table.add_row(column.name, column.title, column.dbType, relation)
-        console.print(table)
-        for column in filter(lambda c: c.typeExt is not None, meta.data.columns):
-            relation = column.typeExt.ref__dict or column.typeExt.ref__valueField
-            if relation is not None:
-                console.print(f"{column.name} -> {relation.model_dump_json()}")
-    else:
-        table = Table("column", "alias", "dbType")
-        for column in meta.data.columns:
-            table.add_row(column.name, column.title, column.dbType)
-        console.print(table)
+    assert meta.data, "元数据不存在"
+
+    print_table_column_detail(meta.data.columns, full)
 
 
 @dataset_typer.command("count", no_args_is_help=True)
 def count_dataset_by_code(
     code: Annotated[str, typer.Argument(help="数据集编码")],
-    query_param: Annotated[
-        str | None, typer.Option("--query", "-q", help="查询参数(SqlQueryParam JSON)")
+    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: 数据集编码。
-        query_param: 可选 SqlQueryParam JSON 字符串。
+        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 dataset count my_dataset_code
-    """
-    try:
-        query = SqlQueryParam.model_validate_json(query_param) if query_param else None
-    except ValidationError as error:
-        typer.echo(f"错误: --query 参数格式无效: {error}")
-        raise typer.Exit(code=2) from None
 
+        带查询条件统计数量（status 等于 1）
+        >>> data-ops-cli dataset count my_dataset_code -c '{"name": "status", "value": 1}'
+
+        多个条件 AND 组合（status 等于 1 且 amount 大于 1000）
+        >>> data-ops-cli dataset count my_dataset_code -c '{"name": "status", "value": 1}' -c '{"name": "amount", "value": 1000, "expression": "gt"}'
+    """
+    qp = SqlQueryParam()
+    if filters:
+        qp.add(*(filter_item.to_condition() for filter_item in filters))
     try:
-        count = service_count_dataset_by_code(code, query)
+        count = service_count_dataset_by_code(code, qp)
     except DataOpsError as error:
         typer.echo(f"错误: {error.message}")
         raise typer.Exit(code=1) from None
@@ -142,33 +140,49 @@ def get_dataset_data(
     code: Annotated[str, typer.Argument(help="数据集编码")],
     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 JSON)")
+    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: 数据集编码。
-        page_num: 页码。
-        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 dataset data my_dataset_code --page-num 0 --page-size 20
-    """
-    try:
-        query = SqlQueryParam.model_validate_json(query_param) if query_param else None
-    except ValidationError as error:
-        typer.echo(f"错误: --query 参数格式无效: {error}")
-        raise typer.Exit(code=2) from None
+        读取数据集默认前 20 条数据
+        >>> data-ops-cli dataset data my_dataset_code
 
+        分页读取
+        >>> data-ops-cli dataset data my_dataset_code --page-num 1 --page-size 50
+
+        带查询条件过滤（status 等于 1）
+        >>> data-ops-cli dataset data my_dataset_code -c '{"name": "status", "value": 1}'
+
+        多个条件 AND 组合（status 等于 1 且 amount 大于 1000）
+        >>> data-ops-cli dataset data my_dataset_code -c '{"name": "status", "value": 1}' -c '{"name": "amount", "value": 1000, "expression": "gt"}'
+    """
+    qp = SqlQueryParam()
+    if filters:
+        qp.add(*(filter_item.to_condition() for filter_item in filters))
     try:
-        # CLI 只负责把终端参数转换成查询模型，再把查询交给 SDK。
         data = service_get_dataset_data_by_code(
             code,
             PageParam(start=page_num * page_size, limit=page_size),
-            query,
+            qp,
         )
     except DataOpsError as error:
         typer.echo(f"错误: {error.message}")

{data_ops_cli-0.3.6 → data_ops_cli-0.4.0}/src/dataops_cli/cli/hazard.py

@@ -176,7 +176,7 @@ def get_hazard_task_logs(
 
     Examples:
         >>> data-ops-cli hazard task logs task_hazard_001
-        >>> data-ops-cli hazard task logs task_hazard_001 --page 0 --size 50
+        >>> data-ops-cli hazard task logs task_hazard_001 --page-num 0 --page-size 50
         >>> data-ops-cli hazard task logs task_hazard_001 --count
     """
     try: