dataops-sdk 0.4.3__tar.gz → 0.4.4__tar.gz

{dataops_sdk-0.4.3 → dataops_sdk-0.4.4}/PKG-INFO

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

{dataops_sdk-0.4.3 → dataops_sdk-0.4.4}/src/dataops_sdk/__init__.py

@@ -95,6 +95,7 @@ from .services import (  # noqa: F401
     service_ref_forward,
     service_set_application,
     service_skill_call_by_code,
+    service_skill_download,
     service_skill_update,
     service_skill_upload,
     service_skill_upload_sub_file,
@@ -108,4 +109,4 @@ from .services import (  # noqa: F401
 )
 from .session import dataops_base_url_context, request_context
 
-__version__ = "0.4.3"
+__version__ = "0.4.4"

{dataops_sdk-0.4.3 → dataops_sdk-0.4.4}/src/dataops_sdk/services/__init__.py

@@ -106,6 +106,7 @@ from .skill import (
     service_skill_call_by_code,
     service_skill_call_by_name,
     service_skill_delete_sub_file,
+    service_skill_download,
     service_skill_get_subfile_by_code,
     service_skill_get_subfile_by_name,
     service_skill_update,

{dataops_sdk-0.4.3 → dataops_sdk-0.4.4}/src/dataops_sdk/services/skill.py

@@ -4,7 +4,7 @@
 
 - 列表与详情: ``service_list_skills`` / ``service_get_skill_by_code`` / ``service_get_skill_by_name`` / ``service_list_skill_files``.
 - 导入 / 更新 / 删除: ``service_skill_upload`` / ``service_skill_update`` / ``service_delete_skill`` / ``service_skill_upload_sub_file`` / ``service_skill_delete_sub_file``.
-- 打包 ZIP: ``service_pack_skill_zip``（按允许列表校验源文件夹结构后本地打包为 ZIP）.
+- 打包 / 下载 ZIP: ``service_pack_skill_zip`` / ``service_skill_download``.
 - 同步调用: ``service_skill_call_by_code``.
 
 所有函数均为纯 Python 接口，不依赖 typer/Rich.
@@ -44,6 +44,7 @@ __all__ = [
     "service_skill_delete_sub_file",
     "service_get_skill_by_code",
     "service_get_skill_by_name",
+    "service_skill_download",
     "service_skill_upload",
     "service_skill_update",
     "service_list_skill_files",
@@ -365,6 +366,65 @@ def service_skill_update(
         return body.get("data") or {}
 
 
+def service_skill_download(
+    name: str,
+    output_path: str | Path | None = None,
+) -> Path:
+    """从平台导出技能 ZIP 并保存到本地.
+
+    按业务名解析 ``code`` 后调用 ``POST /data/skill/export/{code}``，
+    将返回的 ``application/zip`` 二进制写入本地文件。
+
+    Args:
+        name: 技能业务名.
+        output_path: 可选输出路径。省略时写到当前目录 ``{name}.zip``；
+            路径以 ``/`` 或 ``\\`` 结尾时视为目录，在其下生成 ``{name}.zip``；
+            否则视为精确文件路径。
+
+    Returns:
+        实际写入的 ZIP 文件 :class:`Path` 对象。
+
+    Raises:
+        NotFoundError: 找不到对应技能时
+        DataOpsError: API 返回错误时
+        AuthenticationError: 未认证或认证失败时
+        OSError: 写入本地文件失败时
+    """
+    meta = service_get_skill_by_name(name)
+    try:
+        with get_session() as session:
+            resp = session.post(f"/data/skill/export/{meta.code}")
+            if resp.status_code == 401:
+                raise AuthenticationError("认证失败，请先登录")
+            if resp.status_code != 200:
+                msg = f"HTTP {resp.status_code}"
+                try:
+                    body = resp.json()
+                    msg = body.get("msg", msg) if isinstance(body, dict) else msg
+                except Exception:
+                    pass
+                raise DataOpsError(msg, resp.status_code)
+            content = resp.content
+    except SystemExit as e:
+        raise AuthenticationError("认证失败，请先登录") from e
+
+    # 默认/目录场景统一用业务名，便于与 upload 对称识别
+    zip_filename = f"{name}.zip"
+
+    if output_path is None:
+        out = Path(zip_filename)
+    else:
+        raw = os.fspath(output_path)
+        treat_as_dir = isinstance(raw, str) and raw.endswith(("/", "\\"))
+        out = Path(raw)
+        if treat_as_dir or out.is_dir():
+            out = out / zip_filename
+
+    out.parent.mkdir(parents=True, exist_ok=True)
+    out.write_bytes(content)
+    return out
+
+
 def service_delete_skill(name: str) -> dict:
     """按业务名删除技能（级联删除所有 skill_file）.
 

{dataops_sdk-0.4.3 → dataops_sdk-0.4.4}/src/dataops_sdk.egg-info/PKG-INFO

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