dataops-sdk 0.4.0__tar.gz → 0.4.1__tar.gz

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataops-sdk
-Version: 0.4.0
+Version: 0.4.1
 Summary: Python SDK for the DataOps platform.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/__init__.py

@@ -107,4 +107,4 @@ from .services import (  # noqa: F401
 )
 from .session import dataops_base_url_context, request_context
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/schemas/__init__.py

@@ -19,14 +19,16 @@ from .data_table import DataTableData, MetaDataTable
 from .datasource import DataDataSource
 from .dict_ import DataDict, DictItem
 from .enums import (
+    GroupNodeRefType,
     InnerMetaType,
+    MetaReportSubType,
     MetaSkillFileSubType,
     MetaSkillSubType,
     MetaTemplateSubType,
     MetaType,
     MetaWidgetSubType,
 )
-from .group import GroupNode
+from .group import GroupNode, GroupTree
 from .hazard import HazardRecordDTO, HazardTaskDTO
 from .meta import (
     DEFAULT_META_DATA_TYPE,

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/schemas/common.py

@@ -2,7 +2,7 @@ from typing import Annotated, Generic, TypeVar
 
 from pydantic import BaseModel, Field, JsonValue, NonNegativeInt
 
-DataVar = TypeVar("DataVar", default=JsonValue | None)
+DataVar = TypeVar("DataVar")
 
 
 class DataOpsResponse(BaseModel, Generic[DataVar]):

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/schemas/enums.py

@@ -7,6 +7,14 @@
 from enum import StrEnum
 
 
+class GroupNodeRefType(StrEnum):
+    """分组节点引用类型枚举."""
+
+    INNER = "inner"
+    BEFORE = "before"
+    AFTER = "after"
+
+
 class InnerMetaType(StrEnum):
     """SDK 内部使用的 Meta 类型枚举.
 
@@ -16,8 +24,11 @@ class InnerMetaType(StrEnum):
         DATASOURCE: 数据源类型 meta。
     """
 
+    GROUP = "group"
+    """分组"""
+
     DATASOURCE = "datasource"
-    """数据源类型 meta。"""
+    """数据源类型"""
 
     def __repr__(self):
         return self.value
@@ -248,3 +259,16 @@ class MetaSkillFileSubType(StrEnum):
     DOC = "doc"
     CODE = "code"
     IMAGE = "image"
+
+
+class MetaReportSubType(StrEnum):
+    """文档子类型枚举."""
+
+    # 文档
+    DOC = "doc"
+    # 本体
+    ONTOLOGY = "ontology"
+    # 看板
+    DASHBOARD = "dashboard"
+    # # 废弃
+    # SKILL = "skill"

dataops_sdk-0.4.1/src/dataops_sdk/schemas/group.py

@@ -0,0 +1,66 @@
+"""分组节点 (GroupNode) Schema 定义.
+
+用于表示数据源目录树中的分组节点，包含节点的基本信息
+和层级关系。
+"""
+
+from typing import Annotated
+
+from pydantic import AliasChoices, BaseModel, Field, JsonValue
+
+
+class GroupTree(BaseModel):
+    prodCode: Annotated[
+        str,
+        Field(
+            description="产品编码",
+            validation_alias=AliasChoices("prodCode", "prod_code", "PROD_CODE"),
+        ),
+    ]
+    release: Annotated[
+        str | None, Field(description="版本", validation_alias=AliasChoices("release", "RELEASE"))
+    ] = None
+
+    name: Annotated[str, Field(description="名称", validation_alias=AliasChoices("name", "NAME"))]
+    title: Annotated[
+        str, Field(description="中文名称", validation_alias=AliasChoices("title", "TITLE"))
+    ]
+
+    data: list["GroupNode"] = Field(default_factory=list, description="数据")
+    nodeMap: dict[str, dict[str, JsonValue]] = Field(default_factory=dict, description="节点映射")
+
+
+class GroupNode(BaseModel):
+    id: Annotated[
+        str, Field(description="元数据ID", validation_alias=AliasChoices("id", "cuid", "CUID"))
+    ]
+    pid: Annotated[str | None, Field(description="父ID")]
+    parentId: Annotated[
+        str | None,
+        Field(
+            description="父ID", validation_alias=AliasChoices("parentId", "parent_id", "PARENT_ID")
+        ),
+    ]
+
+    type: Annotated[str, Field(description="类型", validation_alias=AliasChoices("type", "TYPE"))]
+    subType: Annotated[
+        str | None,
+        Field(
+            description="子类型", validation_alias=AliasChoices("subType", "sub_type", "SUB_TYPE")
+        ),
+    ]
+
+    name: Annotated[str, Field(description="名称", validation_alias=AliasChoices("name", "NAME"))]
+    title: Annotated[
+        str, Field(description="中文名称", validation_alias=AliasChoices("label", "title", "TITLE"))
+    ]
+    digest: Annotated[
+        str | None, Field(description="摘要", validation_alias=AliasChoices("digest", "DIGEST"))
+    ]
+    remark: Annotated[
+        str | None, Field(description="备注", validation_alias=AliasChoices("remark", "REMARK"))
+    ]
+
+    attrs: Annotated[dict[str, JsonValue] | None, Field(description="扩展属性")] = None
+    params: Annotated[dict[str, JsonValue] | None, Field(description="参数")] = None
+    children: Annotated[list["GroupNode"] | None, Field(description="子节点")] = None

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/schemas/report.py

@@ -6,9 +6,8 @@
 from collections.abc import Mapping
 from typing import Annotated
 
-from pydantic import BaseModel, Field, JsonValue
-
 from dataops_sdk.tiptap import TipTapBuilder
+from pydantic import BaseModel, Field, JsonValue
 
 from .meta import Meta
 
@@ -20,7 +19,16 @@ class ReportMetaData(BaseModel):
         editor: tiptap 原始文档结构。
     """
 
-    editor: Annotated[Mapping[str, JsonValue], Field(description="tiptap 原始文档")]
+    editor: Annotated[dict[str, JsonValue], Field(description="tiptap 原始文档")]
+
+    @property
+    def content(self) -> str:
+        """由 ``data.editor`` 通过 ``TipTapBuilder`` 序列化为纯文本.
+
+        Returns:
+            str: 序列化结果。
+        """
+        return TipTapBuilder().build().serialize(self.editor).strip()
 
 
 class ReportMeta(Meta[ReportMetaData]):
@@ -31,12 +39,3 @@ class ReportMeta(Meta[ReportMetaData]):
     Attributes:
         content: 由 ``data.editor`` 序列化得到的纯文本。
     """
-
-    @property
-    def content(self) -> str:
-        """由 ``data.editor`` 通过 ``TipTapBuilder`` 序列化为纯文本.
-
-        Returns:
-            str: 序列化结果。
-        """
-        return TipTapBuilder().build().serialize(self.data.editor).strip()

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/schemas/user.py

@@ -41,8 +41,8 @@ class Application(BaseModel):
     REMARK: Annotated[str | None, Field(description="备注")]
     CREATE_TIME: Annotated[str, Field(description="创建时间")]
     CREATE_USER: Annotated[str, Field(description="创建人")]
-    LAST_MODIFY_TIME: Annotated[str, Field(description="最后修改时间")]
-    LAST_MODIFY_USER: Annotated[str, Field(description="最后修改人")]
+    LAST_MODIFY_TIME: Annotated[str | None, Field(description="最后修改时间")]
+    LAST_MODIFY_USER: Annotated[str | None, Field(description="最后修改人")]
     PROD_ADMIN: Annotated[str | None, Field(description="产品管理员")]
     GIT_ID: Annotated[str | None, Field(description="Git ID")]
     EXTS: Annotated[str | None, Field(description="扩展字段")]

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/schemas/workflow.py

@@ -6,17 +6,13 @@
 from collections.abc import Mapping
 from typing import Annotated, Generic, TypeVar
 
+from dataops_sdk.schemas.meta import Meta
 from pydantic import (
     BaseModel,
     Field,
     JsonValue,
 )
 
-from dataops_sdk.schemas.meta import Meta
-
-# 注意：用传统 TypeVar + Generic[T] 写法以兼容 Python 3.11+。
-# PEP 695 ``class Foo[T](Bar)`` 语法需要 Python 3.12+，且其 default 参数需 3.13+，
-# 故此处不使用 PEP 695 语法。
 T = TypeVar("T")
 
 

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/services/__init__.py

@@ -60,6 +60,11 @@ from .dict_ import (
     service_get_dict_detail_by_name,
     service_list_dicts,
 )
+from .group import (
+    create_group_node,
+    get_group_by_name,
+    get_group_by_sapce,
+)
 from .hazard import (
     service_clear_hazard_history_records,
     service_dispatch_hazard_callback,
@@ -82,9 +87,13 @@ from .meta import (
     release_ref_list,
     release_ref_list_by_ref,
 )
-from .metrics import service_get_metrics, service_list_metrics
+from .metrics import (
+    service_get_metrics,
+    service_get_metrics_data_by_code,
+    service_list_metrics,
+)
 from .ref import service_ref_backward, service_ref_forward
-from .report import service_get_report, service_list_reports
+from .report import service_get_report, service_list_reports, servive_tree_report
 from .skill import (
     SkillPackValidationError,
     service_delete_skill,
@@ -125,6 +134,7 @@ from .widget import (
     service_get_widget_detail_by_code,
     service_list_widgets,
     service_update_widget,
+    servive_tree_widget,
 )
 from .workflow import (
     service_get_workflow_by_code,

dataops_sdk-0.4.1/src/dataops_sdk/services/group.py

@@ -0,0 +1,69 @@
+from collections.abc import Mapping, Sequence
+from typing import Literal, cast
+
+from dataops_sdk.exceptions import AuthenticationError
+from dataops_sdk.schemas import (
+    GroupNode,
+    GroupNodeRefType,
+    GroupTree,
+    InnerMetaType,
+    MetaType,
+)
+from dataops_sdk.session import get_session, vaild_respone
+from dataops_sdk.utils import encrypt_body
+from pydantic import JsonValue
+from pydantic_core import to_json
+
+
+def get_group_by_sapce(
+    space_name: str,
+    group_name: MetaType | InnerMetaType | str,
+    *,
+    auto_create: bool = False,
+):
+    type_str = group_name.value if isinstance(group_name, (MetaType, InnerMetaType)) else group_name
+    url = f"/meta/group/getSpaceGroupTree/{space_name}/{type_str}"
+
+    try:
+        with get_session() as session:
+            resp = session.get(url, params=dict(autoCreate=auto_create))
+            resp_body = vaild_respone(resp, True, _class=GroupTree)
+        return resp_body.data or []
+    except SystemExit as e:
+        raise AuthenticationError("认证失败，请先登录") from e
+
+
+def get_group_by_name(
+    group_name: MetaType | InnerMetaType | str,
+    *,
+    auto_create: bool = True,
+) -> GroupTree:
+    type_str = group_name.value if isinstance(group_name, (MetaType, InnerMetaType)) else group_name
+    url = f"/meta/group/getGroupTree/{type_str}"
+
+    try:
+        with get_session() as session:
+            resp = session.get(url, params=dict(autoCreate=auto_create))
+            resp_body = vaild_respone(resp, True, _class=GroupTree)
+        return resp_body.data or []
+    except SystemExit as e:
+        raise AuthenticationError("认证失败，请先登录") from e
+
+
+def create_group_node(
+    group_name: str,
+    node: GroupNode,
+    ref_node_id: str | None = None,
+    ref_type: GroupNodeRefType | None = None,
+):
+    url = f"/meta/group/addGroupNode/{group_name}"
+
+    body = dict(addNode=node, refNodeId=ref_node_id, refType=ref_type)
+
+    try:
+        with get_session() as session:
+            resp = session.post(url, content=to_json(encrypt_body(body)))
+            resp_body = vaild_respone(resp, True, _class=GroupTree)
+        return resp_body.data or []
+    except SystemExit as e:
+        raise AuthenticationError("认证失败，请先登录") from e

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/services/meta.py

@@ -11,9 +11,7 @@ from typing import cast
 from dataops_sdk.exceptions import (
     AuthenticationError,
     DataOpsError,
-    FailedToCreateError,
     FailedToUpdateError,
-    NotFoundError,
 )
 from dataops_sdk.schemas import (
     DEFAULT_META_DATA_TYPE,

dataops_sdk-0.4.1/src/dataops_sdk/services/metrics.py

@@ -0,0 +1,87 @@
+"""指标服务."""
+
+from collections.abc import Mapping, Sequence
+
+from dataops_sdk.schemas import Meta, MetaBase, MetaType
+from dataops_sdk.schemas.query import PageParam, SqlQueryParam
+from dataops_sdk.services.meta import release_list_get_by_code, release_list_list
+from dataops_sdk.session import get_session, vaild_respone
+from dataops_sdk.utils import filter_nodes_by_pattern
+from dataops_sdk.utils.utils import encrypt_body
+from pydantic import JsonValue
+from pydantic_core import to_json
+
+__all__ = ["service_list_metrics", "service_get_metrics"]
+
+
+def service_list_metrics(query: str | None = None) -> list[MetaBase]:
+    """列出指标（可选正则过滤）.
+
+    Args:
+        query: 正则表达式，匹配 NAME / TITLE / REMARK / DIGEST
+
+    Returns:
+        MetaBase 对象列表
+
+    Raises:
+        DataOpsError: API 请求失败时
+        AuthenticationError: 未认证时
+    """
+    nodes = release_list_list(MetaType.METRICS)
+    if query:
+        nodes = filter_nodes_by_pattern(nodes, query, include_digest=True)
+    return nodes
+
+
+def service_get_metrics(code: str) -> Meta[Mapping[str, JsonValue]]:
+    """获取指标详情.
+
+    Args:
+        code: 指标编码
+
+    Returns:
+        指标元数据。`meta.data` 结构详见后端指标定义。
+
+    Raises:
+        NotFoundError: 找不到对应指标时.
+        DataOpsError: API 返回错误时.
+        AuthenticationError: 未认证或认证失败时.
+    """
+    return release_list_get_by_code(MetaType.METRICS, code)
+
+
+def service_get_metrics_data_by_code(
+    code: str,
+    page_param: PageParam | None = None,
+    query_param: SqlQueryParam | None = None,
+    dimensions: Sequence[str] | None = None,
+) -> list[dict[str, JsonValue]]:
+    """获取指标实际数据.
+
+    Args:
+        code: 指标编码
+        page_param: 分页参数
+        query_param: 查询参数
+        dimensions: 维度字段名列表
+
+    Examples:
+        查询 2026-04-18 的光缆数量
+        >>> data-ops-cli metrics data 1777544300561_98429 -c '{"name":"d_cycle_time","value":"2026-04-18"}'
+        按照统计日期维度查看光缆数量
+        >>> data-ops-cli metrics data 1777544300561_98429 -d d_cycle_time
+    """
+    dimensions_body = None
+    if dimensions:
+        dimensions_body = [{"name": dimension} for dimension in dimensions]
+    body = {
+        "type": MetaType.METRICS,
+        "code": code,
+        "queryParam": query_param,
+        "pageParam": page_param,
+        "count": False,
+        "dimensions": dimensions_body,
+    }
+    with get_session() as session:
+        resp = session.post("/data/metrics/view/findData", content=to_json(encrypt_body(body)))
+        resp_body = vaild_respone(resp, check_data=True, _class=list[dict[str, JsonValue]])
+    return resp_body.data

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/services/report.py

@@ -7,12 +7,29 @@
 """
 
 from dataops_sdk.schemas import MetaBase, MetaType, ReportMetaData
-from dataops_sdk.services import release_list_get_by_code, release_list_list
+from dataops_sdk.services import (
+    get_group_by_sapce,
+    release_list_get_by_code,
+    release_list_list,
+)
 from dataops_sdk.utils import filter_nodes_by_pattern
 
 __all__ = ["service_get_report", "service_list_reports"]
 
 
+def servive_tree_report(space_code: str = "report"):
+    """获取卡片树结构.
+
+    Returns:
+        卡片树结构
+
+    Raises:
+        DataOpsError: API 请求失败时
+        AuthenticationError: 未认证时
+    """
+    return get_group_by_sapce(space_code, MetaType.REPORT)
+
+
 def service_list_reports(query: str | None = None) -> list[MetaBase]:
     """列出文档（可选正则过滤）.
 
@@ -32,7 +49,7 @@ def service_list_reports(query: str | None = None) -> list[MetaBase]:
     return nodes
 
 
-def service_get_report(code: str) -> ReportMetaData:
+def service_get_report(code: str):
     """读取文档内容并渲染为 Markdown.
 
     Args:

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/services/skill.py

@@ -278,6 +278,7 @@ def service_skill_upload(
     file_path: str | Path,
     sub_type: MetaSkillSubType,
     title: str | None = None,
+    group_name: str | None = None,
     ref_node_id: str | None = None,
     ref_type: str | None = None,
 ) -> dict:
@@ -310,6 +311,8 @@ def service_skill_upload(
         form_data["refNodeId"] = ref_node_id
     if ref_type:
         form_data["refType"] = ref_type
+    if group_name:
+        form_data["groupName"] = group_name
 
     with (
         open(path, "rb") as f,

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/services/widget.py

@@ -16,6 +16,7 @@ from dataops_sdk.schemas import (
     SqlQueryParam,
     WidgetMetaData,
 )
+from dataops_sdk.services.group import get_group_by_name
 from dataops_sdk.services.meta import (
     release_list_get_by_code,
     release_list_list,
@@ -26,6 +27,19 @@ from dataops_sdk.utils import encrypt_body
 from pydantic_core import to_json
 
 
+def servive_tree_widget():
+    """获取卡片树结构.
+
+    Returns:
+        卡片树结构
+
+    Raises:
+        DataOpsError: API 请求失败时
+        AuthenticationError: 未认证时
+    """
+    return get_group_by_name(MetaType.WIDGET)
+
+
 def service_list_widgets(sub_types: list[str] | None = None) -> list[MetaBase]:
     """搜索卡片列表.
 

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/session.py

@@ -5,14 +5,13 @@ from contextvars import ContextVar
 from typing import IO, Any, BinaryIO, Literal, overload
 
 import httpx2
-from pydantic import JsonValue, TypeAdapter, ValidationError
-from pydantic_core import from_json, to_json
-
 from dataops_sdk.constants import APPLICATION_FILE, USER_INFO_FILE
 from dataops_sdk.exceptions import AuthenticationError, DataOpsError
 from dataops_sdk.schemas import Application, DataOpsResponse, UserInfo
 from dataops_sdk.schemas.common import DataVar
 from dataops_sdk.utils import get_work_dir
+from pydantic import JsonValue, TypeAdapter, ValidationError
+from pydantic_core import from_json, to_json
 
 __all__ = [
     "set_request_auth",
@@ -223,7 +222,7 @@ def get_headers(strict: bool = True) -> dict[str, str]:
 
     # 降级：原有的 CLI/环境变量/file 认证逻辑
     fmind_auth_headers = os.getenv("FMIND_AUTH_HEADERS", None)
-    if fmind_auth_headers is not None:
+    if fmind_auth_headers:
         headers = from_json(fmind_auth_headers)
         assert isinstance(headers, dict), "FMIND_AUTH_HEADERS must be a JSON object string"
         return headers
@@ -437,7 +436,7 @@ def post_multipart(
 @overload
 def vaild_respone(
     respone: httpx2.Response, check_data: Literal[False] = False, *, _class: None = None
-) -> DataOpsResponse: ...
+) -> DataOpsResponse[JsonValue | None]: ...
 
 
 @overload
@@ -478,7 +477,7 @@ def vaild_respone(
         if check_data and response_body_json.get("data") is None:
             raise DataOpsError(f"返回数据为空, 错误消息: {response_body_json.get('msg')}")
         response_body = (
-            DataOpsResponse.model_validate(response_body_json)
+            DataOpsResponse[JsonValue | None].model_validate(response_body_json)
             if _class is None
             else DataOpsResponse[_class].model_validate(response_body_json)
         )

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk/utils/utils.py

@@ -6,7 +6,7 @@
 
 import re
 from base64 import b64decode, b64encode
-from collections.abc import Iterator, Mapping
+from collections.abc import Mapping, Sequence
 from copy import deepcopy
 from os import PathLike
 from pathlib import Path
@@ -14,11 +14,11 @@ from typing import Any, Literal, Protocol, TypeVar, cast
 
 from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
 from cryptography.hazmat.primitives.padding import PKCS7
+from dataops_sdk.constants import DEFAULT_SECRET_KEY
+from dataops_sdk.schemas.meta import MetaBase
 from pydantic import BaseModel, JsonValue
 from pydantic_core import from_json, to_json
 
-from dataops_sdk.constants import DEFAULT_SECRET_KEY
-
 __all__ = [
     "filter_nodes_by_pattern",
     "get_work_dir",
@@ -28,24 +28,12 @@ __all__ = [
 ]
 
 
-class SearchableNode(Protocol):
-    """Protocol for nodes that support regex search on name/title/remark/digest."""
-
-    name: str
-    title: str
-    remark: str | None
-    digest: str | None
-
-
-T = TypeVar("T", bound=SearchableNode)
-
-
 def filter_nodes_by_pattern(
-    nodes: Iterator[T],
+    nodes: Sequence[MetaBase],
     query: str,
     *,
     include_digest: bool = False,
-) -> list[T]:
+) -> list[MetaBase]:
     """按正则表达式过滤节点，匹配 NAME、TITLE、REMARK 以及可选的 DIGEST 字段。
 
     Args:

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataops-sdk
-Version: 0.4.0
+Version: 0.4.1
 Summary: Python SDK for the DataOps platform.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{dataops_sdk-0.4.0 → dataops_sdk-0.4.1}/src/dataops_sdk.egg-info/SOURCES.txt

@@ -59,6 +59,7 @@ src/dataops_sdk/services/data_table.py
 src/dataops_sdk/services/dataset.py
 src/dataops_sdk/services/datasource.py
 src/dataops_sdk/services/dict_.py
+src/dataops_sdk/services/group.py
 src/dataops_sdk/services/hazard.py
 src/dataops_sdk/services/meta.py
 src/dataops_sdk/services/metrics.py

dataops_sdk-0.4.0/src/dataops_sdk/schemas/group.py

@@ -1,46 +0,0 @@
-"""分组节点 (GroupNode) Schema 定义.
-
-用于表示数据源目录树中的分组节点，包含节点的基本信息
-和层级关系。
-"""
-
-from typing import Annotated
-
-from pydantic import AliasChoices, BaseModel, Field
-
-
-class GroupNode(BaseModel):
-    """分组节点模型.
-
-    用于表示数据源目录树中的分组节点，包含节点的基本信息
-    和层级关系。
-
-    Attributes:
-        code: 节点编码/ID（来自后端 ``id``）。
-        type: 节点类型。
-        subType: 子类型。
-        name: 节点名称。
-        label: 中文名称。
-        remark: 备注信息。
-        params: 扩展参数映射。
-        children: 子节点列表。
-    """
-
-    code: Annotated[str, Field(description="节点", validation_alias=AliasChoices("id"))]
-    type: Annotated[str, Field(description="类型")]
-    subType: Annotated[
-        str | None,
-        Field(
-            description="子类型",
-            validation_alias=AliasChoices("subType", "sub_type"),
-            exclude=True,
-        ),
-    ]
-    name: Annotated[str, Field(description="名称")]
-    label: Annotated[str, Field(description="中文名称")]
-    remark: Annotated[str | None, Field(description="备注")]
-    params: Annotated[
-        dict[str, str | int | float | bool | None] | None,
-        Field(description="参数", exclude=True),
-    ]
-    children: Annotated[list["GroupNode"] | None, Field(description="子节点")]

dataops_sdk-0.4.0/src/dataops_sdk/services/metrics.py

@@ -1,53 +0,0 @@
-"""指标服务.
-
-提供指标 (METRICS) 实体的列表与详情查询:
-
-- :func:`service_list_metrics` 调用 ``release_list_list`` 全量拉取，再按正则过滤.
-- :func:`service_get_metrics` 调用 ``release_list_get_by_code`` 获取单个指标的 Meta.
-"""
-
-from collections.abc import Mapping
-
-from pydantic import JsonValue
-
-from dataops_sdk.schemas import Meta, MetaBase, MetaType
-from dataops_sdk.services.meta import release_list_get_by_code, release_list_list
-from dataops_sdk.utils import filter_nodes_by_pattern
-
-__all__ = ["service_list_metrics", "service_get_metrics"]
-
-
-def service_list_metrics(query: str | None = None) -> list[MetaBase]:
-    """列出指标（可选正则过滤）.
-
-    Args:
-        query: 正则表达式，匹配 NAME / TITLE / REMARK / DIGEST
-
-    Returns:
-        MetaBase 对象列表
-
-    Raises:
-        DataOpsError: API 请求失败时
-        AuthenticationError: 未认证时
-    """
-    nodes = release_list_list(MetaType.METRICS)
-    if query:
-        nodes = filter_nodes_by_pattern(nodes, query, include_digest=True)
-    return nodes
-
-
-def service_get_metrics(code: str) -> Meta[Mapping[str, JsonValue]]:
-    """获取指标详情.
-
-    Args:
-        code: 指标编码
-
-    Returns:
-        指标元数据。`meta.data` 结构详见后端指标定义。
-
-    Raises:
-        NotFoundError: 找不到对应指标时.
-        DataOpsError: API 返回错误时.
-        AuthenticationError: 未认证或认证失败时.
-    """
-    return release_list_get_by_code(MetaType.METRICS, code)