data-ops-cli 0.3.6__tar.gz → 0.4.1__tar.gz

data_ops_cli-0.4.1/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: data-ops-cli
+Version: 0.4.1
+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.1
+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.1/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.1}/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.1",
     "typer",
     "rich",
 ]

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

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: data-ops-cli
+Version: 0.4.1
+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.1
+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.1}/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
@@ -30,4 +31,5 @@ src/dataops_cli/cli/skill.py
 src/dataops_cli/cli/table.py
 src/dataops_cli/cli/utils.py
 src/dataops_cli/cli/widget.py
-src/dataops_cli/cli/workflow.py
+src/dataops_cli/cli/workflow.py
+tests/test_table_relation.py

{data_ops_cli-0.3.6 → data_ops_cli-0.4.1}/src/data_ops_cli.egg-info/requires.txt

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

{data_ops_cli-0.3.6 → data_ops_cli-0.4.1}/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.1"

{data_ops_cli-0.3.6 → data_ops_cli-0.4.1}/src/dataops_cli/cli/auth.py

@@ -9,14 +9,13 @@
 from typing import Annotated
 
 import typer
-from dataops_sdk.constants import USER_INFO_FILE
+from dataops_sdk.constants import APPLICATION_FILE, USER_INFO_FILE
 from dataops_sdk.exceptions import AuthenticationError
 from dataops_sdk.schemas import UserInfo
 from dataops_sdk.services.auth import (
     service_get_current_application,
     service_list_applications,
     service_login,
-    service_logout,
     service_set_application,
 )
 from dataops_sdk.services.datasource import (
@@ -33,6 +32,15 @@ application_typer = typer.Typer(name="application", help="应用相关命令", n
 auth_typer.add_typer(application_typer)
 
 
+def _require_login() -> None:
+    """未登录时引导登录并退出。"""
+    if not get_work_dir(USER_INFO_FILE).exists():
+        typer.echo("未登录，请先执行登录：")
+        typer.echo("  data-ops-cli auth login <用户名> <密码>")
+        typer.echo("登录后执行 data-ops-cli auth application set <应用code> 设置应用")
+        raise typer.Exit(code=401)
+
+
 @auth_typer.command("status")
 def auth_status() -> None:
     """显示当前认证状态。
@@ -43,13 +51,9 @@ def auth_status() -> None:
     如果已登录但未设置应用，提示用户设置应用；
     否则同时输出应用关联的主/隐患数据源信息。
     """
-    target_path = get_work_dir(USER_INFO_FILE)
-    if not target_path.exists():
-        print("未登录")
-    else:
-        user_info = UserInfo.model_validate_json(target_path.read_bytes())
+    _require_login()
+    user_info = UserInfo.model_validate_json(get_work_dir(USER_INFO_FILE).read_bytes())
     try:
-        # application
         application = service_get_current_application()
         datasource_config = service_get_main_datasource_config_by_application()
     except AuthenticationError:
@@ -120,11 +124,11 @@ def logout() -> None:
     Examples:
         >>> data-ops-cli auth logout
     """
-    ret = service_logout()
-    if ret:
-        print("登出成功")
-    else:
-        print("登出失败: 未登录")
+    for filename in (USER_INFO_FILE, APPLICATION_FILE):
+        path = get_work_dir(filename)
+        if path.exists() and path.is_file():
+            path.unlink()
+    print("登出成功，已清除本地登录信息")
 
 
 @application_typer.command("list")
@@ -146,6 +150,7 @@ def application_list(
         通过关键字过滤应用
         >>> data-ops-cli auth application list -q myapp
     """
+    _require_login()
     try:
         applications = service_list_applications(query)
     except Exception as e:
@@ -175,11 +180,12 @@ def application_set(code: Annotated[str, typer.Argument(help="应用编码")]) -
         设置当前应用
         >>> data-ops-cli auth application set myapp_code
     """
+    _require_login()
     try:
         application = service_set_application(code)
-    except ValueError as e:
-        typer.echo(f"错误: {e}")
-        raise typer.Exit(code=1) from None
+    except ValueError:
+        typer.echo("输入的code值错误，请重新输入！")
+        raise typer.Exit(code=1)
 
     table = Table("field", "value", title="应用信息", show_header=False)
     table.add_row("code", application.CODE)
@@ -197,6 +203,7 @@ def application_info() -> None:
     查看当前已设置应用的详细信息，包括编码、标题和备注。
     如果尚未设置应用，提示用户使用 ``auth application set`` 命令进行设置。
     """
+    _require_login()
     application = service_get_current_application()
     if application is None:
         print("未设置应用, 执行 `data-ops-cli auth application set <code>` 进行设置应用.")

{data_ops_cli-0.3.6 → data_ops_cli-0.4.1}/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)