dagster-dingtalk 0.1.14__tar.gz → 0.1.15__tar.gz

{dagster_dingtalk-0.1.14 → dagster_dingtalk-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dagster-dingtalk
-Version: 0.1.14
+Version: 0.1.15
 Summary: A dagster plugin for the DingTalk
 Author: YiZixuan
 Author-email: sqkkyzx@qq.com
@@ -16,32 +16,37 @@ Description-Content-Type: text/markdown
 
 # 钉钉与 Dagster 集成
 
----
+该 Dagster 集成是为了更便捷的调用钉钉（DingTalk）的API，集成提供了两个 Dagster Resource。
 
-## 介绍
+## 安装
+要安装库，请在现有的Dagster环境中使用pip。
 
-该 Dagster 集成是为了更便捷的调用钉钉（DingTalk）的API，集成提供了两个 Dagster Resource。
+```bash
+pip install dagster-dingtalk
+```
+
+## 资源
 
+### DingTalkWebhookResource
 
-## DingTalkWebhookResource
+---
 
 该资源允许定义单个钉钉自定义机器人的 Webhook 端点，以便于发送文本、Markdown、Link、 ActionCard、FeedCard 消息，消息具体样式可参考
 [钉钉开放平台 | 自定义机器人发送消息的消息类型](https://open.dingtalk.com/document/orgapp/custom-bot-send-message-type)。
 
-### 配置项:
+#### 配置:
 
 - **access_token** (str):
         机器人 Webhook 地址中的 access_token 值。
 - **secret** (str, optional):
     如使用加签安全配置，则需传签名密钥。默认值为 None。
 - **alias** (str, optional):
-    如提供别名，可以在使用 `MultiDingTalkWebhookResource` 中使用别名进行 webhook 选择。默认值为 None。
+    别名，仅用作标记。默认值为 None。
 - **base_url** (str, optional):
     通用地址，一般无需更改。默认值为 “https://oapi.dingtalk.com/robot/send”。
 
-### 用例:
+#### 用例 1：使用单个资源
 
-##### 1. 使用单个资源：
 ```python
 from dagster_dingtalk import DingTalkWebhookResource
 from dagster import op, In, OpExecutionContext, job, Definitions
@@ -61,7 +66,10 @@ defs = Definitions(
 )
 ```
 
-##### 2. 启动时动态构建企业内部应用资源, 可参考 [Dagster文档 | 在启动时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time)
+#### 用例 2：启动时动态构建 Webhook 资源
+
+如果你事先不确定会用到哪个 webhook 机器人，或是需要根据代码逻辑动态选择 webhook ，dagster 提供了一种 [在运行时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time) 
+的原生支持。以下是示例：
 
 ```python
 from dagster_dingtalk import DingTalkWebhookResource
@@ -94,30 +102,13 @@ def schedule_user_info():
     ))
 ```
 
-### 注意:
-
-应该永远避免直接将密钥字符串直接配置给资源，这会导致在 dagster 前端用户界面暴露密钥。
-应当从环境变量中读取密钥。你可以在代码中注册临时的环境变量，或从系统中引入环境变量。
-
-```python
-import os
-from dagster import EnvVar
-from dagster_dingtalk import DingTalkWebhookResource
-
-# 直接在代码中注册临时的环境变量
-os.environ.update({'access_token_name': "<your-access_token>"})
-os.environ.update({'secret_name': "<your-secret>"})
-
-webhook = DingTalkWebhookResource(access_token=EnvVar("access_token_name"), secret=EnvVar("secret_name"))
-```
-
-## DingTalkAppResource
 
-该 Dagster 资源允许定义一个钉钉的 API Client，更加便捷地调用钉钉服务端企业内部应用 API
+### DingTalkAppResource
 
-[钉钉服务端 API](https://open.dingtalk.com/document/orgapp/api-overview) 企业内部应用部分的第三方封装。
+---
 
-通过此资源，可以调用部分钉钉服务端 API。具体封装的 API 可以在 IDE 中通过引入 `DingTalkAppClient` 类来查看 IDE 提示：
+该 Dagster 资源允许定义一个可以调用 [钉钉服务端 API](https://open.dingtalk.com/document/orgapp/api-overview) 的 Client，
+具有一些常用 HTTP API 的封装。你可以在 IDE 中通过引入 `DingTalkAppClient` 类来查看 IDE 提示：
 
 ```python
 from dagster_dingtalk import DingTalkAppClient
@@ -125,7 +116,18 @@ from dagster_dingtalk import DingTalkAppClient
 dingtalk: DingTalkAppClient
 ```
 
-### 配置项:
+**请注意：`DingTalkAppClient` 未使用钉钉官方 SDK 实现，并采用了 ASCII 字符来命名实例方法。** 
+
+> 这是为了与
+> [钉钉服务端 API 文档](https://open.dingtalk.com/document/orgapp/api-overview) 里的中文 API 
+> 保持完全一致命名，以便于更符合直觉地进行调用和快速查阅文档。因此，可以按 
+> [钉钉服务端 API 文档](https://open.dingtalk.com/document/orgapp/api-overview) 
+> 中的层级，通过链式调用来发起 API 请求。例如：
+> 
+> `dingtalk.智能人事.花名册.获取花名册元数据()`
+
+
+#### 配置:
 
 - **AppID** (str):
     应用应用唯一标识 AppID，作为缓存标识符使用。不传入则不缓存鉴权。
@@ -138,9 +140,7 @@ dingtalk: DingTalkAppClient
 - **ClientSecret** (str):
     应用的 Client Secret ，原 AppSecret 和 SuiteSecret
 
-### 用例
-
-##### 1. 使用单一的企业内部应用资源。
+#### 用例 1：使用确定的企业内部应用配置资源
 
 ```python
 from dagster_dingtalk import DingTalkAppResource, DingTalkAppClient
@@ -165,7 +165,9 @@ defs = Definitions(
     )})
 ```
 
-##### 2. 启动时动态构建企业内部应用资源, 可参考 [Dagster文档 | 在启动时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time)
+#### 用例 2：运行时动态构建企业内部应用资源
+
+可参考 [Dagster文档 | 在启动时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time)
 
 ```python
 from dagster_dingtalk import DingTalkAppResource, DingTalkAppClient
@@ -204,7 +206,22 @@ def schedule_user_info():
     ))
 ```
 
-### 注意:
 
-应该永远避免直接将密钥字符串直接配置给资源，这会导致在 dagster 前端用户界面暴露密钥。你可以在代码中注册临时的环境变量，或从系统中引入环境变量。
+## 提醒:
+
+应该永远避免直接将密钥字符串直接配置给资源，这会导致在 dagster 前端用户界面暴露密钥。
+应当从环境变量中读取密钥。你可以在代码中注册临时的环境变量，或从系统中引入环境变量。
+
+```python
+import os
+from dagster import EnvVar
+from dagster_dingtalk import DingTalkWebhookResource
+
+# 直接在代码中注册临时的环境变量
+os.environ.update({'access_token_name': "<your-access_token>"})
+os.environ.update({'secret_name': "<your-secret>"})
+
+webhook = DingTalkWebhookResource(access_token=EnvVar("access_token_name"), secret=EnvVar("secret_name"))
+```
+
 

{dagster_dingtalk-0.1.14 → dagster_dingtalk-0.1.15}/README.md

@@ -1,31 +1,36 @@
 # 钉钉与 Dagster 集成
 
----
+该 Dagster 集成是为了更便捷的调用钉钉（DingTalk）的API，集成提供了两个 Dagster Resource。
 
-## 介绍
+## 安装
+要安装库，请在现有的Dagster环境中使用pip。
 
-该 Dagster 集成是为了更便捷的调用钉钉（DingTalk）的API，集成提供了两个 Dagster Resource。
+```bash
+pip install dagster-dingtalk
+```
+
+## 资源
 
+### DingTalkWebhookResource
 
-## DingTalkWebhookResource
+---
 
 该资源允许定义单个钉钉自定义机器人的 Webhook 端点，以便于发送文本、Markdown、Link、 ActionCard、FeedCard 消息，消息具体样式可参考
 [钉钉开放平台 | 自定义机器人发送消息的消息类型](https://open.dingtalk.com/document/orgapp/custom-bot-send-message-type)。
 
-### 配置项:
+#### 配置:
 
 - **access_token** (str):
         机器人 Webhook 地址中的 access_token 值。
 - **secret** (str, optional):
     如使用加签安全配置，则需传签名密钥。默认值为 None。
 - **alias** (str, optional):
-    如提供别名，可以在使用 `MultiDingTalkWebhookResource` 中使用别名进行 webhook 选择。默认值为 None。
+    别名，仅用作标记。默认值为 None。
 - **base_url** (str, optional):
     通用地址，一般无需更改。默认值为 “https://oapi.dingtalk.com/robot/send”。
 
-### 用例:
+#### 用例 1：使用单个资源
 
-##### 1. 使用单个资源：
 ```python
 from dagster_dingtalk import DingTalkWebhookResource
 from dagster import op, In, OpExecutionContext, job, Definitions
@@ -45,7 +50,10 @@ defs = Definitions(
 )
 ```
 
-##### 2. 启动时动态构建企业内部应用资源, 可参考 [Dagster文档 | 在启动时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time)
+#### 用例 2：启动时动态构建 Webhook 资源
+
+如果你事先不确定会用到哪个 webhook 机器人，或是需要根据代码逻辑动态选择 webhook ，dagster 提供了一种 [在运行时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time) 
+的原生支持。以下是示例：
 
 ```python
 from dagster_dingtalk import DingTalkWebhookResource
@@ -78,30 +86,13 @@ def schedule_user_info():
     ))
 ```
 
-### 注意:
-
-应该永远避免直接将密钥字符串直接配置给资源，这会导致在 dagster 前端用户界面暴露密钥。
-应当从环境变量中读取密钥。你可以在代码中注册临时的环境变量，或从系统中引入环境变量。
-
-```python
-import os
-from dagster import EnvVar
-from dagster_dingtalk import DingTalkWebhookResource
-
-# 直接在代码中注册临时的环境变量
-os.environ.update({'access_token_name': "<your-access_token>"})
-os.environ.update({'secret_name': "<your-secret>"})
-
-webhook = DingTalkWebhookResource(access_token=EnvVar("access_token_name"), secret=EnvVar("secret_name"))
-```
-
-## DingTalkAppResource
 
-该 Dagster 资源允许定义一个钉钉的 API Client，更加便捷地调用钉钉服务端企业内部应用 API
+### DingTalkAppResource
 
-[钉钉服务端 API](https://open.dingtalk.com/document/orgapp/api-overview) 企业内部应用部分的第三方封装。
+---
 
-通过此资源，可以调用部分钉钉服务端 API。具体封装的 API 可以在 IDE 中通过引入 `DingTalkAppClient` 类来查看 IDE 提示：
+该 Dagster 资源允许定义一个可以调用 [钉钉服务端 API](https://open.dingtalk.com/document/orgapp/api-overview) 的 Client，
+具有一些常用 HTTP API 的封装。你可以在 IDE 中通过引入 `DingTalkAppClient` 类来查看 IDE 提示：
 
 ```python
 from dagster_dingtalk import DingTalkAppClient
@@ -109,7 +100,18 @@ from dagster_dingtalk import DingTalkAppClient
 dingtalk: DingTalkAppClient
 ```
 
-### 配置项:
+**请注意：`DingTalkAppClient` 未使用钉钉官方 SDK 实现，并采用了 ASCII 字符来命名实例方法。** 
+
+> 这是为了与
+> [钉钉服务端 API 文档](https://open.dingtalk.com/document/orgapp/api-overview) 里的中文 API 
+> 保持完全一致命名，以便于更符合直觉地进行调用和快速查阅文档。因此，可以按 
+> [钉钉服务端 API 文档](https://open.dingtalk.com/document/orgapp/api-overview) 
+> 中的层级，通过链式调用来发起 API 请求。例如：
+> 
+> `dingtalk.智能人事.花名册.获取花名册元数据()`
+
+
+#### 配置:
 
 - **AppID** (str):
     应用应用唯一标识 AppID，作为缓存标识符使用。不传入则不缓存鉴权。
@@ -122,9 +124,7 @@ dingtalk: DingTalkAppClient
 - **ClientSecret** (str):
     应用的 Client Secret ，原 AppSecret 和 SuiteSecret
 
-### 用例
-
-##### 1. 使用单一的企业内部应用资源。
+#### 用例 1：使用确定的企业内部应用配置资源
 
 ```python
 from dagster_dingtalk import DingTalkAppResource, DingTalkAppClient
@@ -149,7 +149,9 @@ defs = Definitions(
     )})
 ```
 
-##### 2. 启动时动态构建企业内部应用资源, 可参考 [Dagster文档 | 在启动时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time)
+#### 用例 2：运行时动态构建企业内部应用资源
+
+可参考 [Dagster文档 | 在启动时配置资源](https://docs.dagster.io/concepts/resources#configuring-resources-at-launch-time)
 
 ```python
 from dagster_dingtalk import DingTalkAppResource, DingTalkAppClient
@@ -188,6 +190,21 @@ def schedule_user_info():
     ))
 ```
 
-### 注意:
 
-应该永远避免直接将密钥字符串直接配置给资源，这会导致在 dagster 前端用户界面暴露密钥。你可以在代码中注册临时的环境变量，或从系统中引入环境变量。
+## 提醒:
+
+应该永远避免直接将密钥字符串直接配置给资源，这会导致在 dagster 前端用户界面暴露密钥。
+应当从环境变量中读取密钥。你可以在代码中注册临时的环境变量，或从系统中引入环境变量。
+
+```python
+import os
+from dagster import EnvVar
+from dagster_dingtalk import DingTalkWebhookResource
+
+# 直接在代码中注册临时的环境变量
+os.environ.update({'access_token_name': "<your-access_token>"})
+os.environ.update({'secret_name': "<your-secret>"})
+
+webhook = DingTalkWebhookResource(access_token=EnvVar("access_token_name"), secret=EnvVar("secret_name"))
+```
+

{dagster_dingtalk-0.1.14 → dagster_dingtalk-0.1.15}/dagster_dingtalk/__init__.py

@@ -1,10 +1,9 @@
 # noinspection PyProtectedMember
 from dagster._core.libraries import DagsterLibraryRegistry
+from dagster_dingtalk.version import __version__
 
-from dagster_dingtalk.resources import DingTalkAppResource
-from dagster_dingtalk.resources import DingTalkWebhookResource
+from dagster_dingtalk.resources import DingTalkAppResource, DingTalkWebhookResource
 from dagster_dingtalk.app_client import DingTalkClient as DingTalkAppClient
-# from dagster_dingtalk.operations import DingTalkWebhookOp
-from dagster_dingtalk.version import __version__
+import dagster_dingtalk.operations as DingTalkOp
 
 DagsterLibraryRegistry.register("dagster-dingtalk", __version__)

{dagster_dingtalk-0.1.14 → dagster_dingtalk-0.1.15}/dagster_dingtalk/app_client.py

@@ -5,7 +5,10 @@ from datetime import datetime
 from enum import Enum
 from pathlib import Path
 from typing import List, Literal, Dict, Tuple
+
+import httpx
 from httpx import Client
+from pydantic import BaseModel, Field
 
 
 # noinspection NonAsciiCharacters
@@ -26,6 +29,7 @@ class DingTalkClient:
         self.通讯录管理 = 通讯录管理_API(self)
         self.文档文件 = 文档文件_API(self)
         self.互动卡片 = 互动卡片_API(self)
+        self.OA审批 = OA审批_API(self)
 
     def __get_access_token(self) -> str:
         access_token_cache = Path("/tmp/.dingtalk_cache")
@@ -210,6 +214,7 @@ class 文档文件_API:
     def __init__(self, _client:DingTalkClient):
         self.__client:DingTalkClient = _client
         self.媒体文件 = 文档文件_媒体文件_API(_client)
+        self.文件传输 = 文档文件_文件传输_API(_client)
 
 # noinspection NonAsciiCharacters
 class 文档文件_媒体文件_API:
@@ -238,6 +243,84 @@ class 文档文件_媒体文件_API:
             response = self.__client.oapi.post(url=f"/media/upload?type={media_type}", files={'media': f})
         return response.json()
 
+# noinspection NonAsciiCharacters
+class 文档文件_文件传输_API:
+    def __init__(self, _client:DingTalkClient):
+        self.__client:DingTalkClient = _client
+
+    def 获取文件上传信息(self, space_id:int, union_id:str, multi_part:bool = False) -> dict:
+        """
+        调用本接口，上传图片、语音媒体资源文件以及普通文件，接口返回媒体资源标识 media_id。
+
+        https://open.dingtalk.com/document/orgapp/upload-media-files
+
+        :param space_id: 空间Id。
+        :param union_id: 操作者unionId。
+        :param multi_part: 是否需要分片上传。默认值为 False
+
+        :return:
+            {
+                "uploadKey": str,
+                "storageDriver": str,
+                "protocol": str,
+                "headerSignatureInfo": {
+                    "resourceUrls" : ["resourceUrl"],
+                    "headers" : {
+                      "key" : "header_value"
+                    },
+                }
+            }
+        """
+        response = self.__client.api.post(
+            url=f"/v1.0/storage/spaces/{space_id}/files/uploadInfos/query",
+            params={'unionId': union_id},
+            json={
+                "protocol": "HEADER_SIGNATURE",
+                "multipart": multi_part
+            }
+        )
+        return response.json()
+
+    def 提交文件(self, url:str, headers:dict, file_path:Path|str, space_id:int, union_id:str,
+                 upload_key:str, convert_to_online_doc:bool = False) -> dict:
+        """
+        调用本接口，上传图片、语音媒体资源文件以及普通文件，接口返回媒体资源标识 media_id。
+
+        https://open.dingtalk.com/document/orgapp/upload-media-files
+
+        :param url: 获取文件上传信息得到的 resourceUrl。
+        :param headers: 获取文件上传信息得到的 headers。
+        :param file_path: 文件路径
+        :param space_id: 空间Id。
+        :param union_id: 操作者unionId。
+        :param upload_key: 添加文件唯一标识。
+        :param convert_to_online_doc: 是否转换成在线文档。默认值 False
+
+        :return:
+            {
+                "uploadKey": str,
+                "storageDriver": str,
+                "protocol": str,
+                "headerSignatureInfo": dict,
+            }
+        """
+        with open(file_path, 'rb') as f:
+            httpx.put(
+                url=url,
+                files={"file":f},
+                headers=headers
+            )
+
+        response = self.__client.api.post(
+            url = f"/v2.0/storage/spaces/files/{space_id}/commit?unionId={union_id}",
+            json = {
+                "uploadKey": upload_key,
+                "name": file_path.split("/")[-1],
+                "convertToOnlineDoc": convert_to_online_doc
+            }
+        )
+        return response.json()
+
 # noinspection NonAsciiCharacters
 class 互动卡片_API:
     def __init__(self, _client:DingTalkClient):
@@ -325,3 +408,171 @@ class 互动卡片_API:
         )
 
         return response.json()
+
+# noinspection NonAsciiCharacters
+class OA审批_API:
+    def __init__(self, _client:DingTalkClient):
+        self.__client:DingTalkClient = _client
+        self.审批实例 = OA审批_审批实例_API(_client)
+        self.审批钉盘 = OA审批_审批钉盘_API(_client)
+
+# noinspection NonAsciiCharacters
+class OA审批_审批实例_API:
+    def __init__(self, _client:DingTalkClient):
+        self.__client:DingTalkClient = _client
+
+    class CommentAttachment(BaseModel):
+        spaceId: str = Field(description="钉盘空间ID")
+        fileSize: str = Field(description="文件大小")
+        fileId: str = Field(description="文件ID")
+        fileName: str = Field(description="文件名称")
+        fileType: str = Field(description="文件类型")
+
+    def 获取单个审批实例详情(self, instance_id:str) -> dict:
+        """
+        调用本接口可以获取审批实例详情数据，根据审批实例ID，获取审批实例详情，包括审批实例标题、发起人的userId、审批人userId、操作记录列表等内容。
+
+        https://open.dingtalk.com/document/orgapp/obtains-the-details-of-a-single-approval-instance-pop
+
+        :param instance_id: 审批实例ID。
+
+        :return:
+            {
+                "success": boolean,
+                "result": {}
+            }
+        """
+        response = self.__client.api.get(url="/v1.0/workflow/processInstances", params={'processInstanceId': instance_id})
+        return response.json()
+
+    def 撤销审批实例(self, instance_id:str, is_system:bool = True, remark:str|None = None, operating_user_id:str = None) -> dict:
+        """
+        撤销发起的处于流程中的审批实例。审批发起15秒内不能撤销审批流程。本接口只能撤销流程中的审批实例，不能撤销已审批完成的审批实例。
+
+        https://open.dingtalk.com/document/orgapp/revoke-an-approval-instance
+
+        :param instance_id: 审批实例ID。
+        :param is_system: 是否通过系统操作。默认为 True。当为 false 时，需要传发起人才能撤销。
+        :param remark: 终止说明。
+        :param operating_user_id: 操作人的userId。is_system 为 false 时必填。
+
+        :return:
+            {
+                "success": boolean,
+                "result": {}
+            }
+        """
+        response = self.__client.api.post(
+            url="/v1.0/workflow/processInstances",
+            json={
+              "processInstanceId" : instance_id,
+              "isSystem" : is_system,
+              "remark" : remark,
+              "operatingUserId" : operating_user_id
+            }
+        )
+        return response.json()
+
+    def 添加审批评论(
+            self, instance_id:str, text:str, comment_user_id: str,
+            photos: List[str]|None = None, attachments: List[CommentAttachment]|None = None
+    ) -> dict:
+        """
+        调用本接口可以获取审批实例详情数据，根据审批实例ID，获取审批实例详情，包括审批实例标题、发起人的userId、审批人userId、操作记录列表等内容。
+
+        其中，添加审批评论附件需调用获取审批钉盘空间信息接口，获取钉盘空间的上传权限，并获取审批钉盘空间spaceId。
+
+        https://open.dingtalk.com/document/orgapp/obtains-the-details-of-a-single-approval-instance-pop
+
+        :param instance_id: 审批实例 ID。
+        :param text: 评论的内容。
+        :param comment_user_id: 评论人的 UserId
+        :param photos: 图片的 URL 链接的列表，默认为 None。
+        :param attachments: 附件列表，默认为 None。添加审批评论附件需将文件上传至审批钉盘空间，可以获取到相关接口参数。
+
+        :return:
+            {
+                "success": boolean,
+                "result": boolean
+            }
+        """
+
+        data = {
+            'processInstanceId': instance_id,
+            'text': text,
+            'commentUserId': comment_user_id,
+        }
+
+        if photos or attachments:
+            data.update({'file': {"photos": photos, "attachments": attachments}})
+
+        response = self.__client.api.post(
+            url="/v1.0/workflow/processInstances/comments",
+            json=data
+        )
+        return response.json()
+
+    def 获取审批实例ID列表(
+            self, process_code:str, start_time:datetime, end_time:datetime, next_token: int = 0, max_results: int = 20,
+            statuses: Literal["RUNNING", "TERMINATED", "COMPLETED"]|None = None, user_ids = List[str]
+    ) -> dict:
+        """
+        获取权限范围内的相关部门审批实例ID列表。
+
+        https://open.dingtalk.com/document/orgapp/obtain-an-approval-list-of-instance-ids
+
+        :param user_ids:
+        :param process_code: 审批流模板的 code。
+        :param start_time: 审批实例开始时间。
+        :param end_time: 审批实例结束时间。
+        :param next_token: 分页游标, 首次调用传 0, 默认值为 0
+        :param max_results: 分页小，最多传20，默认值为 20
+        :param statuses: 筛选流程实例状态，默认为 None，表示不筛选。 RUNNING-审批中 TERMINATED-已撤销 COMPLETED-审批完成
+
+        :return:
+            {
+                "success": boolean,
+                "result": {}
+            }
+        """
+        response = self.__client.api.post(
+            url="/v1.0/workflow/processes/instanceIds/query",
+            json={
+              "processCode" : process_code,
+              "startTime" : int(start_time.timestamp()*1000),
+              "endTime" : int(end_time.timestamp()*1000),
+              "nextToken" : next_token,
+              "maxResults" : max_results,
+              "userIds" : user_ids,
+              "statuses" : statuses
+            })
+        return response.json()
+
+# noinspection NonAsciiCharacters
+class OA审批_审批钉盘_API:
+    def __init__(self, _client:DingTalkClient):
+        self.__client:DingTalkClient = _client
+
+    def 获取审批钉盘空间信息(self, user_id:str) -> dict:
+        """
+        获取审批钉盘空间的ID并授予当前用户上传附件的权限。
+
+        https://open.dingtalk.com/document/orgapp/obtains-the-information-about-approval-nail-disk
+
+        :param user_id: 用户的userId。
+
+        :return:
+            {
+                "success": bool,
+                "result": {
+                    "spaceId": int
+                }
+            }
+        """
+        response = self.__client.api.post(
+            url="/v1.0/workflow/processInstances/spaces/infos/query",
+            json={
+              "userId" : user_id,
+              "agentId" : self.__client.agent_id
+            })
+        return response.json()

dagster_dingtalk-0.1.15/dagster_dingtalk/operations.py

@@ -0,0 +1,86 @@
+from dagster import In, OpExecutionContext, op, Out
+
+# noinspection PyProtectedMember
+from dagster._annotations import experimental
+
+from .app_client import DingTalkClient
+from .resources import DingTalkWebhookResource
+
+@experimental
+@op(description="钉钉Webhook发送文本消息",
+    required_resource_keys={'dingtalk_webhook'},
+    ins={
+        "text": In(str),
+        "at": In(default_value=None, description="@列表，传List[str]解析为userId,传List[int]解析为phone，传ALL解析为全部。")
+    })
+def op_send_simple_text(context: OpExecutionContext, text, at):
+    webhook:DingTalkWebhookResource = context.resources.dingtalk_webhook
+    if isinstance(at, str) and at == 'ALL':
+        webhook.send_text(text=text, at_all=True)
+    if isinstance(at, list) and isinstance(at[0], str):
+        webhook.send_text(text=text, at_user_ids=at)
+    if isinstance(at, list) and isinstance(at[0], int):
+        at = [str(mobile) for mobile in at]
+        webhook.send_text(text=text, at_mobiles=at)
+    if not at:
+        webhook.send_text(text=text)
+
+
+@op(description="钉钉Webhook发送Markdown消息",
+    required_resource_keys={'dingtalk_webhook'},
+    ins={
+        "text": In(str),
+        "title": In(str, default_value=''),
+        "at": In(default_value=None, description="@列表，传List[str]解析为userId,传List[int]解析为phone，传ALL解析为全部。")
+    })
+def op_send_markdown(context: OpExecutionContext, text, title, at):
+    webhook:DingTalkWebhookResource = context.resources.dingtalk_webhook
+    if isinstance(at, str) and at == 'ALL':
+        webhook.send_markdown(text=text, title=title, at_all=True)
+    if isinstance(at, list) and isinstance(at[0], str):
+        webhook.send_markdown(text=text, title=title, at_user_ids=at)
+    if isinstance(at, list) and isinstance(at[0], int):
+        at = [str(mobile) for mobile in at]
+        webhook.send_markdown(text=text, title=title, at_mobiles=at)
+    if not at:
+        webhook.send_markdown(text=text, title=title)
+
+
+@op(description="更新钉钉互动卡片",
+    required_resource_keys={"dingtalk"},
+    ins={"card_param_map":In(), "out_track_id":In(str), "update_by_key":In(bool, default_value=True)},
+    out={"is_success":Out(bool, is_required=False)})
+def renew_card(context:OpExecutionContext, card_param_map, out_track_id, update_by_key):
+    try:
+        dingtalk_yunxiao: DingTalkClient = context.resources.dingtalk_yunxiao
+        res = dingtalk_yunxiao.互动卡片.更新卡片(out_track_id=out_track_id, card_param_map=card_param_map, update_card_data_by_key=update_by_key)
+        context.log.info(res)
+        if res.get('success') and res.get('result'):
+            return True
+        else:
+            return False
+    except Exception as e:
+        context.log.error(e)
+        return False
+
+
+@op(description="创建并发送钉钉互动卡片",
+    ins={"search_type_name":In(str), "alert_content":In(str), "card_template_id":In(str), "card_param_map":In(), "out_track_id":In(str), "open_space_id":In(str)},
+    out={"is_success":Out(bool, is_required=False)}, required_resource_keys={"dingtalk"})
+def send_revenue_dt_card(context:OpExecutionContext, search_type_name, alert_content,card_template_id, card_param_map, out_track_id, open_space_id):
+    try:
+        dingtalk_yunxiao: DingTalkClient = context.resources.dingtalk_yunxiao
+        res = dingtalk_yunxiao.互动卡片.创建并投放卡片(
+            search_type_name=search_type_name,
+            search_desc=alert_content,
+            card_template_id=card_template_id,
+            card_param_map=card_param_map,
+            alert_content=alert_content,
+            out_track_id=out_track_id,
+            open_space_ids=[open_space_id]
+        )
+        context.log.info(res)
+        return res.get("success")
+    except Exception as e:
+        context.log.error(e)
+        return False

{dagster_dingtalk-0.1.14 → dagster_dingtalk-0.1.15}/dagster_dingtalk/resources.py

@@ -48,7 +48,7 @@ class DingTalkWebhookResource(ConfigurableResource):
     - **secret** (str, optional):
         如使用加签安全配置，则需传签名密钥。默认值为 None。
     - **alias** (str, optional):
-        如提供别名，可以在使用 `MultiDingTalkWebhookResource` 中使用别名进行 webhook 选择。默认值为 None。
+        别名，仅用作标记。默认值为 None。
     - **base_url** (str, optional):
         通用地址，一般无需更改。默认值为 “https://oapi.dingtalk.com/robot/send”。
 
@@ -303,8 +303,6 @@ class DingTalkWebhookResource(ConfigurableResource):
 
 class DingTalkAppResource(ConfigurableResource):
     """
-该 Dagster 资源允许定义一个钉钉的 API Client，更加便捷地调用钉钉服务端企业内部应用 API
-
 [钉钉服务端 API](https://open.dingtalk.com/document/orgapp/api-overview) 企业内部应用部分的第三方封装。
 
 通过此资源，可以调用部分钉钉服务端 API。具体封装的 API 可以在 IDE 中通过引入 `DingTalkAppClient` 类来查看 IDE 提示：

dagster_dingtalk-0.1.15/dagster_dingtalk/version.py

@@ -0,0 +1 @@
+__version__ = "0.1.15"

{dagster_dingtalk-0.1.14 → dagster_dingtalk-0.1.15}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "dagster-dingtalk"
-version = "0.1.14"
+version = "0.1.15"
 description = "A dagster plugin for the DingTalk"
 authors = ["YiZixuan <sqkkyzx@qq.com>"]
 readme = "README.md"

dagster_dingtalk-0.1.14/dagster_dingtalk/operations.py

@@ -1,20 +0,0 @@
-from dagster import In, OpExecutionContext, op
-
-# noinspection PyProtectedMember
-from dagster._annotations import experimental
-
-
-@experimental
-@op(description="使用钉钉 Webhook 发送文本消息",
-    required_resource_keys={'dingtalk_webhook'},
-    ins={"text": In(str)})
-def op_send_simple_text(context: OpExecutionContext, text):
-    webhook = context.resources.dingtalk_webhook
-    webhook.send_text(text)
-
-@op(description="使用钉钉 Webhook 发送 Markdown 消息",
-    required_resource_keys={'dingtalk_webhook'},
-    ins={"text": In(str), "title": In(str, default_value='')})
-def op_simple_markdown(context: OpExecutionContext, text, title):
-    webhook = context.resources.dingtalk_webhook
-    webhook.send_text(text, title)

dagster_dingtalk-0.1.14/dagster_dingtalk/version.py

@@ -1 +0,0 @@
-__version__ = "0.1.14"