dagster-dingtalk 0.1.41__tar.gz → 0.1.43__tar.gz

{dagster_dingtalk-0.1.41 → dagster_dingtalk-0.1.43}/.idea/.gitignore

@@ -6,3 +6,5 @@
 # Datasource local storage ignored files
 /dataSources/
 /dataSources.local.xml
+/MarsCodeWorkspaceAppSettings.xml
+/desktop.ini

dagster_dingtalk-0.1.43/.idea/MarsCodeWorkspaceAppSettings.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="com.codeverse.userSettings.MarscodeWorkspaceAppSettingsState">
+    <option name="ckgOperationStatus" value="SUCCESS" />
+  </component>
+</project>

{dagster_dingtalk-0.1.41 → dagster_dingtalk-0.1.43}/.idea/workspace.xml

@@ -4,9 +4,9 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="d56e898e-6e80-4770-9a14-5869f3cdca54" name="更改" comment="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.39 修改为 0.1.40&#10;- 将 version.py 中的版本号从 0.26.13 修改为 0.26.14">
+    <list default="true" id="d56e898e-6e80-4770-9a14-5869f3cdca54" name="更改" comment="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.41 修改为 0.1.42&#10;- 将 version.py 中的版本号从 0.26.17 修改为 0.26.20">
       <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/dagster_dingtalk/version.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/dagster_dingtalk/version.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/dagster_dingtalk/app_client.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/dagster_dingtalk/app_client.py" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -51,6 +51,7 @@
   &quot;keyToString&quot;: {
     &quot;Python.test.executor&quot;: &quot;Run&quot;,
     &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager&quot;: &quot;true&quot;,
     &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
     &quot;git-widget-placeholder&quot;: &quot;master&quot;,
     &quot;ignore.virus.scanning.warn.message&quot;: &quot;true&quot;,
@@ -108,8 +109,8 @@
   <component name="SharedIndexes">
     <attachedChunks>
       <set>
-        <option value="bundled-js-predefined-d6986cc7102b-6a121458b545-JavaScript-PY-251.25410.159" />
-        <option value="bundled-python-sdk-e0ed3721d81e-36ea0e71a18c-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-251.25410.159" />
+        <option value="bundled-js-predefined-d6986cc7102b-b26f3e71634d-JavaScript-PY-251.26094.141" />
+        <option value="bundled-python-sdk-9f8e2b94138c-36ea0e71a18c-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-251.26094.141" />
       </set>
     </attachedChunks>
   </component>
@@ -144,7 +145,9 @@
       <workItem from="1746446495722" duration="69000" />
       <workItem from="1746723436137" duration="161000" />
       <workItem from="1746881612246" duration="131000" />
-      <workItem from="1748502555257" duration="29000" />
+      <workItem from="1748502555257" duration="70000" />
+      <workItem from="1749879333099" duration="4165000" />
+      <workItem from="1749889527048" duration="48000" />
     </task>
     <task id="LOCAL-00001" summary="更改目录结构以便于使用 uv 构建和发布包">
       <option name="closed" value="true" />
@@ -258,7 +261,39 @@
       <option name="project" value="LOCAL" />
       <updated>1746881714128</updated>
     </task>
-    <option name="localTasksCounter" value="15" />
+    <task id="LOCAL-00015" summary="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.40 修改为 0.1.41&#10;- 将 version.py 中的版本号从 0.26.14 修改为 0.26.17">
+      <option name="closed" value="true" />
+      <created>1748502594787</created>
+      <option name="number" value="00015" />
+      <option name="presentableId" value="LOCAL-00015" />
+      <option name="project" value="LOCAL" />
+      <updated>1748502594787</updated>
+    </task>
+    <task id="LOCAL-00016" summary="chore: 更新 .idea/.gitignore 文件&#10;&#10;- 添加 MarsCodeWorkspaceAppSettings.xml 到忽略列表&#10;- 添加 desktop.ini 到忽略列表">
+      <option name="closed" value="true" />
+      <created>1749883326409</created>
+      <option name="number" value="00016" />
+      <option name="presentableId" value="LOCAL-00016" />
+      <option name="project" value="LOCAL" />
+      <updated>1749883326409</updated>
+    </task>
+    <task id="LOCAL-00017" summary="feat(storage): 优化文件上传接口并添加新功能&#10;&#10;- 新增群文件相关接口，包括获取群存储空间信息、发送文件给指定用户等&#10;- 优化文件上传接口，支持自定义文件冲突策略&#10;- 修复文件传输类中的文件提交方法，支持文件内容直接上传">
+      <option name="closed" value="true" />
+      <created>1749883365692</created>
+      <option name="number" value="00017" />
+      <option name="presentableId" value="LOCAL-00017" />
+      <option name="project" value="LOCAL" />
+      <updated>1749883365692</updated>
+    </task>
+    <task id="LOCAL-00018" summary="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.41 修改为 0.1.42&#10;- 将 version.py 中的版本号从 0.26.17 修改为 0.26.20">
+      <option name="closed" value="true" />
+      <created>1749883507831</created>
+      <option name="number" value="00018" />
+      <option name="presentableId" value="LOCAL-00018" />
+      <option name="project" value="LOCAL" />
+      <updated>1749883507831</updated>
+    </task>
+    <option name="localTasksCounter" value="19" />
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
@@ -290,7 +325,11 @@
     <MESSAGE value="build: 更新版本号&#10;&#10;-将 pyproject.toml 中的版本号从 0.1.38 修改为 0.1.39&#10;- 将 src/dagster_dingtalk/version.py 中的版本号从 0.26.12 修改为 0.26.13" />
     <MESSAGE value="build: 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.38 修改为 0.1.39&#10;- 将 src/dagster_dingtalk/version.py 中的版本号从 0.26.12 修改为 0.26.13" />
     <MESSAGE value="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.39 修改为 0.1.40&#10;- 将 version.py 中的版本号从 0.26.13 修改为 0.26.14" />
-    <option name="LAST_COMMIT_MESSAGE" value="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.39 修改为 0.1.40&#10;- 将 version.py 中的版本号从 0.26.13 修改为 0.26.14" />
+    <MESSAGE value="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.40 修改为 0.1.41&#10;- 将 version.py 中的版本号从 0.26.14 修改为 0.26.17" />
+    <MESSAGE value="chore: 更新 .idea/.gitignore 文件&#10;&#10;- 添加 MarsCodeWorkspaceAppSettings.xml 到忽略列表&#10;- 添加 desktop.ini 到忽略列表" />
+    <MESSAGE value="feat(storage): 优化文件上传接口并添加新功能&#10;&#10;- 新增群文件相关接口，包括获取群存储空间信息、发送文件给指定用户等&#10;- 优化文件上传接口，支持自定义文件冲突策略&#10;- 修复文件传输类中的文件提交方法，支持文件内容直接上传" />
+    <MESSAGE value="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.41 修改为 0.1.42&#10;- 将 version.py 中的版本号从 0.26.17 修改为 0.26.20" />
+    <option name="LAST_COMMIT_MESSAGE" value="build(dagster-dingtalk): 更新版本号&#10;&#10;- 将 pyproject.toml 中的版本号从 0.1.41 修改为 0.1.42&#10;- 将 version.py 中的版本号从 0.26.17 修改为 0.26.20" />
   </component>
   <component name="com.intellij.coverage.CoverageDataManagerImpl">
     <SUITE FILE_PATH="coverage/dagster_dingtalk$test.coverage" NAME="test 覆盖结果" MODIFIED="1739565257857" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />

{dagster_dingtalk-0.1.41 → dagster_dingtalk-0.1.43}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dagster-dingtalk
-Version: 0.1.41
+Version: 0.1.43
 Summary: A dagster plugin for the DingTalk
 Author-email: YiZixuan <sqkkyzx@qq.com>
 Requires-Python: >=3.11

{dagster_dingtalk-0.1.41 → dagster_dingtalk-0.1.43}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dagster-dingtalk"
-version = "0.1.41"
+version = "0.1.43"
 description = "A dagster plugin for the DingTalk"
 readme = "README.md"
 authors = [

{dagster_dingtalk-0.1.41 → dagster_dingtalk-0.1.43}/src/dagster_dingtalk/app_client.py

@@ -531,10 +531,170 @@ class 待办任务__:
 class 文档文件__:
     def __init__(self, _client:DingTalkClient):
         self.__client:DingTalkClient = _client
+        self.群文件 = 文档文件__群文件(_client)
         self.媒体文件 = 文档文件__媒体文件(_client)
+        self.存储管理 = 文档文件__存储管理(_client)
         self.文件传输 = 文档文件__存储管理__文件传输(_client)
 
 
+# noinspection NonAsciiCharacters, PyPep8Naming
+class 文档文件__群文件:
+    def __init__(self, _client:DingTalkClient):
+        self.__client:DingTalkClient = _client
+
+    def 获取群存储空间信息(self, unionId:str, openConversationId:str) -> dict:
+        """
+        接口版本：2025-01-14
+
+        调用本接口，可获取某个指定群的存储空间信息，包括群存储空间的ID、群存储空间创建的时间和修改时间等。
+
+        https://open.dingtalk.com/document/orgapp/obtain-group-storage-space-information
+
+        :param unionId: 操作人的unionId。
+        :param openConversationId: 会话openConversationId。
+
+        :return:
+            {
+              "space" : {
+                "spaceId" : "798****",
+                "corpId" : "ding1234****",
+                "createTime" : "2022-01-01T10:00:00Z",
+                "modifiedTime" : "2022-01-01T10:00:00Z"
+              }
+            }
+        """
+        response = self.__client.api(
+            method="POST",
+            path=f"/v1.0/convFile/conversations/spaces/query?unionId={unionId}",
+            json={'openConversationId': openConversationId}
+        )
+        return response.json()
+
+    def 以应用身份发送文件给指定用户(self, unionId:str, spaceId:str, dentryId:str) -> dict:
+        """
+        接口版本：2023-01-18
+
+        调用本接口可以把存储空间内的文件发送给用户。例如，以当前应用的身份给接收人发送一条工作通知。
+
+        https://open.dingtalk.com/document/orgapp/sends-a-storage-file-to-a-specified-user
+
+        :param unionId: 操作人的unionId。
+        :param spaceId: 文件所在空间ID。
+        :param dentryId: 文件ID。
+
+        :return:
+            {
+              "file" : {
+                "id" : "674****",
+                "conversationId" : "cidB1*****",
+                "spaceId" : "864*****",
+                "parentId" : "0",
+                "type" : "FILE",
+                "name" : "测试文件.xls",
+                "size" : 256,
+                "path" : "/测试文件.xls",
+                "version" : 1,
+                "status" : "NORMAL",
+                "extension" : "xls",
+                "creatorId" : "cHtUY****",
+                "modifierId" : "cHtUY****",
+                "createTime" : "2022-01-01T10:00:00Z",
+                "modifiedTime" : "2022-01-01T10:00:00Z"
+              }
+            }
+        """
+        response = self.__client.api(
+            method="POST",
+            path=f"/v1.0/convFile/apps/conversations/files/send?unionId={unionId}",
+            json={"spaceId" : spaceId, "dentryId" : dentryId}
+        )
+        return response.json()
+
+    def 发送文件到指定会话(self, unionId:str, spaceId:str, dentryId:str, openConversationId:str) -> dict:
+        """
+        接口版本：2023-01-18
+
+        调用本接口，可实现将存储空间内的文件发送到指定群内。
+
+        https://open.dingtalk.com/document/orgapp/send-file-to-specified-session
+
+        :param unionId: 操作人的unionId。
+        :param spaceId: 文件所在空间ID。
+        :param dentryId: 文件ID。
+        :param openConversationId: 会话openConversationId。
+
+        :return:
+            {
+              "file" : {
+                "id" : "897*****",
+                "conversationId" : "cid+vIrz*****",
+                "spaceId" : "865*****",
+                "parentId" : "parent_id",
+                "type" : "FILE",
+                "name" : "测试文件.txt",
+                "size" : 256,
+                "path" : "./测试文件.txt",
+                "version" : 1,
+                "status" : "NORMAL",
+                "extension" : "txt",
+                "creatorId" : "chy*****",
+                "modifierId" : "chy*****",
+                "createTime" : "2022-01-01T10:00:00Z",
+                "modifiedTime" : "2022-01-01T10:00:00Z",
+                "uuid" : "123*****"
+              }
+            }
+        """
+        response = self.__client.api(
+            method="POST",
+            path=f"/v1.0/convFile/conversations/files/send?unionId={unionId}",
+            json={"spaceId": spaceId, "dentryId": dentryId, "openConversationId": openConversationId}
+        )
+        return response.json()
+
+    def 发送文件链接到指定会话(self, unionId:str, spaceId:str, dentryId:str, openConversationId:str) -> dict:
+        """
+        接口版本：2023-01-18
+
+        调用本接口，可实现发送文件链接到指定群内。
+
+        https://open.dingtalk.com/document/orgapp/send-a-file-link-to-the-specified-session
+
+        :param unionId: 操作人的unionId。
+        :param spaceId: 文件所在空间ID。
+        :param dentryId: 文件ID。
+        :param openConversationId: 会话openConversationId。
+
+        :return:
+            {
+              "file" : {
+                "id" : "file_id",
+                "conversationId" : "open_conversation_id",
+                "spaceId" : "space_id",
+                "parentId" : "parent_id",
+                "type" : "file",
+                "name" : "file_name",
+                "size" : 256,
+                "path" : "file_path",
+                "version" : 1,
+                "status" : "NORMAL",
+                "extension" : "txt",
+                "creatorId" : "creator_id",
+                "modifierId" : "modified_id",
+                "createTime" : "2022-01-01T10:00:00Z",
+                "modifiedTime" : "2022-01-01T10:00:00Z",
+                "uuid" : "uuid"
+              }
+            }
+        """
+        response = self.__client.api(
+            method="POST",
+            path=f"/v1.0/convFile/conversations/files/links/send?unionId={unionId}",
+            json={"spaceId": spaceId, "dentryId": dentryId, "openConversationId": openConversationId}
+        )
+        return response.json()
+
+
 # noinspection NonAsciiCharacters, PyPep8Naming
 class 文档文件__媒体文件:
     def __init__(self, _client:DingTalkClient):
@@ -542,6 +702,8 @@ class 文档文件__媒体文件:
 
     def 上传媒体文件(self, file_path:Path|str, media_type:Literal['image', 'voice', 'video', 'file']) -> dict:
         """
+        接口版本：2023-05-24
+
         调用本接口，上传图片、语音媒体资源文件以及普通文件，接口返回媒体资源标识 media_id。
 
         https://open.dingtalk.com/document/orgapp/upload-media-files
@@ -565,59 +727,73 @@ class 文档文件__媒体文件:
         return response.json()
 
 
+# noinspection NonAsciiCharacters, PyPep8Naming
+class 文档文件__存储管理:
+    def __init__(self, _client:DingTalkClient):
+        self.__client:DingTalkClient = _client
+        self.文件传输 = 文档文件__存储管理__文件传输(self.__client)
+
+
 # noinspection NonAsciiCharacters, PyPep8Naming
 class 文档文件__存储管理__文件传输:
     def __init__(self, _client:DingTalkClient):
         self.__client:DingTalkClient = _client
 
-    def 获取文件上传信息(self, space_id:int, union_id:str, multi_part:bool = False) -> dict:
+    def 获取文件上传信息(self, parentDentryUuid:str, union_id:str) -> dict:
         """
-        调用本接口，上传图片、语音媒体资源文件以及普通文件，接口返回媒体资源标识 media_id。
+        接口版本：2024-01-05
 
-        https://open.dingtalk.com/document/orgapp/upload-media-files
+        调用本接口，获取文件上传信息。
+
+        https://open.dingtalk.com/document/orgapp/obtain-file-upload-informations
 
-        :param space_id: 空间Id。
         :param union_id: 操作者unionId。
-        :param multi_part: 是否需要分片上传。默认值为 False
+        :param parentDentryUuid: 父节点 dentryUuid，如果是空间根目录, 填空间根目录的dentryUuid。
 
         :return:
             {
-                "uploadKey": str,
-                "storageDriver": str,
-                "protocol": str,
-                "headerSignatureInfo": {
-                    "resourceUrls" : ["resourceUrl"],
-                    "headers" : {
-                      "key" : "header_value"
-                    },
-                }
+              "uploadKey" : "upload_key",
+              "storageDriver" : "DINGTALK",
+              "protocol" : "HEADER_SIGNATURE",
+              "headerSignatureInfo" : {
+                "resourceUrls" : [ "resourceUrl" ],
+                "headers" : {
+                  "key" : "header_value"
+                },
+                "expirationSeconds" : 900,
+                "region" : "ZHANGJIAKOU",
+                "internalResourceUrls" : [ "internalResourceUrl" ]
+              }
             }
         """
         response = self.__client.api(
             method="POST",
-            path=f"/v1.0/storage/spaces/{space_id}/files/uploadInfos/query",
+            path=f"/v2.0/storage/spaces/files/{parentDentryUuid}/uploadInfos/query",
             params={'unionId': union_id},
-            json={
-                "protocol": "HEADER_SIGNATURE",
-                "multipart": multi_part
-            }
+            json={"protocol" : "HEADER_SIGNATURE"}
         )
         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:
+    def 提交文件(
+            self, parentDentryUuid:str, upload_key:str, url:str, headers:dict, file_content: bytes,
+            file_path:Path|str, union_id:str, convert_to_online_doc:bool = False,
+            conflictStrategy:Literal['AUTO_RENAME', 'OVERWRITE', 'RETURN_DENTRY_IF_EXISTS', 'RETURN_ERROR_IF_EXISTS'] = 'AUTO_RENAME'
+    ) -> dict:
         """
+        接口版本：2023-07-06
+
         调用本接口，上传图片、语音媒体资源文件以及普通文件，接口返回媒体资源标识 media_id。
 
         https://open.dingtalk.com/document/orgapp/upload-media-files
-
+        :param parentDentryUuid: 父节点 dentryUuid。如果是空间根目录，填空间根目录的dentryUuid。
+        :param upload_key: 添加文件唯一标识。
         :param url: 获取文件上传信息得到的 resourceUrl。
         :param headers: 获取文件上传信息得到的 headers。
-        :param file_path: 文件路径
-        :param space_id: 空间Id。
+        :param file_content: 文件字节内容，如果提供了 file_content，则忽略 file_path。
+        :param file_path: 文件路径，如果提供了 file_content，则忽略 file_path。
         :param union_id: 操作者unionId。
-        :param upload_key: 添加文件唯一标识。
         :param convert_to_online_doc: 是否转换成在线文档。默认值 False
+        :param conflictStrategy: 文件名称冲突策略。AUTO_RENAME：自动重命名，默认值 OVERWRITE：覆盖 RETURN_DENTRY_IF_EXISTS：返回已存在文件 RETURN_ERROR_IF_EXISTS：文件已存在时报错
 
         :return:
             {
@@ -627,20 +803,27 @@ class 文档文件__存储管理__文件传输:
                 "headerSignatureInfo": dict,
             }
         """
-        with open(file_path, 'rb') as f:
-            httpx.put(
-                url=url,
-                files={"file":f},
-                headers=headers
-            )
+
+        if file_content:
+            httpx.put(url=url, content=file_content, headers=headers)
+        elif file_path:
+            file_path = Path(file_path)
+            if not file_path.exists():
+                raise FileNotFoundError(f"文件路径不存在: {file_path}")
+            else:
+                with open(file_path, 'rb') as f:
+                    httpx.put(url=url, files={"file": f}, headers=headers)
+        else:
+            raise FileNotFoundError(f"未提供任何文件路径或文件内容")
 
         response = self.__client.api(
             method="POST",
-            path=f"/v2.0/storage/spaces/files/{space_id}/commit?unionId={union_id}",
+            path=f"/v2.0/storage/spaces/files/{parentDentryUuid}/commit?unionId={union_id}",
             json={
                 "uploadKey": upload_key,
                 "name": file_path.split("/")[-1],
-                "convertToOnlineDoc": convert_to_online_doc
+                "convertToOnlineDoc": convert_to_online_doc,
+                "option": {"conflictStrategy": conflictStrategy}
             }
         )
         return response.json()

dagster_dingtalk-0.1.43/src/dagster_dingtalk/version.py

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

dagster_dingtalk-0.1.41/src/dagster_dingtalk/version.py

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