p123client 0.0.6.8__py3-none-any.whl → 0.0.6.9.1__py3-none-any.whl

p123client/client.py

@@ -1215,6 +1215,8 @@ class P123OpenClient:
         })
         return self.request(api, params=payload, async_=async_, **request_kwargs)
 
+    fs_list_v2 = fs_list
+
     @overload
     def fs_list_v1(
         self, 
@@ -1261,7 +1263,7 @@ class P123OpenClient:
         :payload:
             - limit: int = 100         💡 分页大小，最多 100
             - orderBy: str = "file_id" 💡 排序依据
-            
+
                 - "file_id": 文件 id
                 - "file_name": 文件名
                 - "size":  文件大小
@@ -4288,6 +4290,7 @@ class P123OpenClient:
     fs_detail_open = fs_detail
     fs_info_open = fs_info
     fs_list_open = fs_list
+    fs_list_v2_open = fs_list_v2
     fs_list_v1_open = fs_list_v1
     fs_mkdir_open = fs_mkdir
     fs_move_open = fs_move
@@ -5094,7 +5097,7 @@ class P123Client(P123OpenClient):
             - next: int = 0    💡 下一批拉取开始的 id
             - orderBy: str = "file_id" 💡 排序依据
 
-                - "file_id": 文件 id
+                - "file_id": 文件 id，也可以写作 "fileId"
                 - "file_name": 文件名
                 - "size":  文件大小
                 - "create_at": 创建时间
@@ -5190,7 +5193,7 @@ class P123Client(P123OpenClient):
             - next: int = 0    💡 下一批拉取开始的 id
             - orderBy: str = "file_id" 💡 排序依据
 
-                - "fileId": 文件 id
+                - "file_id": 文件 id，也可以写作 "fileId"
                 - "file_name": 文件名
                 - "size":  文件大小
                 - "create_at": 创建时间
@@ -7596,8 +7599,9 @@ class P123Client(P123OpenClient):
             **request_kwargs, 
         )
 
-# TODO: 添加扫码登录接口，以及通过扫码登录的方法
+# TODO: 添加扫码登录接口，以及通过扫码登录的方法，特别是用已登录的设备扫描一个新的 token 出来
 # TODO: 添加 同步空间 和 直链空间 的操作接口
 # TODO: 添加 图床 的操作接口
 # TODO: 添加 视频转码 的操作接口
 # TODO: 对于某些工具的接口封装，例如 重复文件清理
+# TODO: 开放接口有更新了(全部添加后，版本号可以来到 0.0.7)，从此开始 https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/xogi45g7okqk7svr

p123client/tool/__init__.py

@@ -6,14 +6,14 @@ __all__ = ["make_uri", "upload_uri", "get_downurl", "iterdir", "share_iterdir"]
 
 from asyncio import sleep as async_sleep
 from collections import deque
-from collections.abc import AsyncIterator, Callable, Coroutine, Iterator
+from collections.abc import AsyncIterator, Callable, Coroutine, Iterable, Iterator, Mapping
 from errno import EISDIR, ENOENT
 from functools import partial
 from itertools import count
 from time import sleep, time
 from typing import Literal
 from typing import overload, Any, Literal
-from urllib.parse import unquote
+from urllib.parse import unquote, urlsplit
 
 from encode_uri import encode_uri_component_loose
 from iterutils import run_gen_step, run_gen_step_iter, Yield
@@ -216,6 +216,9 @@ def get_downurl(
     return run_gen_step(gen_step, async_)
 
 
+# TODO: _iterdir 支持广度优先遍历
+# TODO: 失败时，报错信息支持返回已经成功和未成功的列表，并且形式上也要利于断点重试
+# TODO: 支持传入其它自定义的查询参数
 @overload
 def _iterdir(
     fs_files: Callable, 
@@ -224,7 +227,9 @@ def _iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
+    extra_data: None | Mapping | Iterable[tuple[str, Any]] = None, 
     *, 
     async_: Literal[False] = False, 
     **request_kwargs, 
@@ -238,7 +243,9 @@ def _iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
+    extra_data: None | Mapping | Iterable[tuple[str, Any]] = None, 
     *, 
     async_: Literal[True], 
     **request_kwargs, 
@@ -251,7 +258,9 @@ def _iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
+    extra_data: None | Mapping | Iterable[tuple[str, Any]] = None, 
     *, 
     async_: Literal[False, True] = False, 
     **request_kwargs, 
@@ -270,7 +279,9 @@ def _iterdir(
         - 如果返回值是 False，则跳过此节点（但依然会继续处理位于此节点之下的节点）
         - 如果返回值是 True，则输出此节点
 
-    :param interval: 两次调用之间，休息的时间
+    :param cooldown: 两次调用之间，冷却的时间（用两次调用开始时的时间差，而不是一次完成到下一次开始的时间差）
+    :param base_url: 基地址，如果为空，则用默认
+    :param extra_data: 附加数据
     :param async_: 是否异步
     :param request_kwargs: 其它请求参数
 
@@ -278,6 +289,8 @@ def _iterdir(
     """
     default_payload = payload
     page_size = int(payload.setdefault("limit", 100))
+    if base_url:
+        request_kwargs["base_url"] = base_url
     def gen_step():
         nonlocal parent_id
         dq: deque[tuple[int, int, str]] = deque()
@@ -290,13 +303,13 @@ def _iterdir(
             payload = {**default_payload, "parentFileId": parent_id}
             for i in count(1):
                 payload["Page"] = i
-                if last_ts and interval > 0 and (remains := last_ts + interval - time()) > 0:
+                if last_ts and cooldown > 0 and (remains := last_ts + cooldown - time()) > 0:
                     if async_:
                         yield async_sleep(remains)
                     else:
                         sleep(remains)
                 resp = yield fs_files(payload, async_=async_, **request_kwargs)
-                if interval > 0:
+                if cooldown > 0:
                     last_ts = time()
                 check_response(resp)
                 info_list = resp["data"]["InfoList"]
@@ -320,6 +333,8 @@ def _iterdir(
                         continue
                     elif pred:
                         if depth >= min_depth:
+                            if extra_data:
+                                info = dict(extra_data, **info)
                             yield Yield(info)
                         if pred is 1:
                             continue
@@ -343,7 +358,8 @@ def iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
     use_list_new: bool = False, 
     *, 
     async_: Literal[False] = False, 
@@ -357,7 +373,8 @@ def iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
     use_list_new: bool = False, 
     *, 
     async_: Literal[True], 
@@ -370,7 +387,8 @@ def iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
     use_list_new: bool = False, 
     *, 
     async_: Literal[False, True] = False, 
@@ -389,7 +407,8 @@ def iterdir(
         - 如果返回值是 False，则跳过此节点（但依然会继续处理位于此节点之下的节点）
         - 如果返回值是 True，则输出此节点
 
-    :param interval: 两次调用之间，休息的时间
+    :param cooldown: 两次调用之间，冷却的时间（用两次调用开始时的时间差，而不是一次完成到下一次开始的时间差）
+    :param base_url: 基地址，如果为空，则用默认
     :param use_list_new: 使用 `P123Client.fs_list_new` 而不是 `P123Client.fs_list`
     :param async_: 是否异步
     :param request_kwargs: 其它请求参数
@@ -402,7 +421,8 @@ def iterdir(
         min_depth=min_depth, 
         max_depth=max_depth, 
         predicate=predicate, 
-        interval=interval, 
+        cooldown=cooldown, 
+        base_url=base_url, 
         async_=async_, 
         **request_kwargs, 
     )
@@ -416,7 +436,8 @@ def share_iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
     *, 
     async_: Literal[False] = False, 
     **request_kwargs, 
@@ -430,7 +451,8 @@ def share_iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
     *, 
     async_: Literal[True], 
     **request_kwargs, 
@@ -443,15 +465,24 @@ def share_iterdir(
     min_depth: int = 1, 
     max_depth: int = 1, 
     predicate: None | Callable[[dict], Literal[None, 0, 1, False, True]] = None, 
-    interval: int | float = 0, 
+    cooldown: int | float = 0, 
+    base_url: None | str | Callable[[], str] = None, 
     *, 
     async_: Literal[False, True] = False, 
     **request_kwargs, 
 ) -> Iterator[dict] | AsyncIterator[dict]:
     """遍历分享的文件列表
 
-    :param share_key: 分享码，在分享链接中的位置形如 "https://www.123pan.com/s/{share_key}"
-    :param share_pwd: 密码，如果没有就不传
+    :param share_key: 分享码或者分享链接（可以携带提取码）
+
+        .. note::
+            在分享链接中的位置形如 f"https://www.123pan.com/s/{share_key}"
+
+            如果携带提取码，要写成 f"https://www.123pan.com/s/{share_key}?提取码:{share_pwd}"
+
+            上面的基地址不必是 "https://www.123pan.com"
+
+    :param share_pwd: 提取码（4个文字），可以为空
     :param parent_id: 父目录 id，默认是根目录
     :param min_depth: 最小深度，小于此深度的不会输出
     :param max_depth: 最大深度，大于此深度的不会输出，如果小于 0 则无限
@@ -462,20 +493,33 @@ def share_iterdir(
         - 如果返回值是 False，则跳过此节点（但依然会继续处理位于此节点之下的节点）
         - 如果返回值是 True，则输出此节点
 
-    :param interval: 两次调用之间，休息的时间
+    :param cooldown: 两次调用之间，冷却的时间（用两次调用开始时的时间差，而不是一次完成到下一次开始的时间差）
+    :param base_url: 基地址，如果为空，则用默认
     :param async_: 是否异步
     :param request_kwargs: 其它请求参数
 
     :return: 迭代器，产生文件或目录的信息
     """
+    if share_key.startswith(("http://", "https://")):
+        urlp = urlsplit(share_key)
+        # if not base_url:
+        #     base_url = f"{urlp.scheme}://{urlp.netloc}"
+        share_key = urlp.path.rsplit("/", 1)[-1]
+        if not share_pwd:
+            share_pwd = urlp.query.rpartition(":")[-1]
+            if len(share_pwd) != 4:
+                share_pwd = ""
+    payload = {"ShareKey": share_key, "SharePwd": share_pwd}
     return _iterdir(
         P123Client.share_fs_list, 
-        {"ShareKey": share_key, "SharePwd": share_pwd}, 
+        payload, 
         parent_id=parent_id, 
         min_depth=min_depth, 
         max_depth=max_depth, 
         predicate=predicate, 
-        interval=interval, 
+        cooldown=cooldown, 
+        base_url=base_url, 
+        extra_data=payload, 
         async_=async_, 
         **request_kwargs, 
     )

{p123client-0.0.6.8.dist-info → p123client-0.0.6.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: p123client
-Version: 0.0.6.8
+Version: 0.0.6.9.1
 Summary: Python 123 webdisk client.
 Home-page: https://github.com/ChenyangGao/p123client
 License: MIT

p123client-0.0.6.9.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+p123client/__init__.py,sha256=gfUum-q3f_XuXOk2HpArDAIxAlscZm8Fau1kiNkNFpg,214
+p123client/client.py,sha256=FYb3ZmYN9reFJn9g5eO0s28ckEd4zi1UxdN2HF9-CeE,258851
+p123client/const.py,sha256=T17OzPQrnIG6w_Hzjc8TF_fFMKa-hQMSn1gff8pVcBc,56
+p123client/exception.py,sha256=020xGo8WQmGCJz1UzNg9oFzpEvToQcgTye0s6lkFASQ,1540
+p123client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+p123client/tool/__init__.py,sha256=Okg3C6NNIKp1FxNzO7K40wFujYhxKWnUjD2v5jKJuas,18802
+p123client/type.py,sha256=T17OzPQrnIG6w_Hzjc8TF_fFMKa-hQMSn1gff8pVcBc,56
+p123client-0.0.6.9.1.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+p123client-0.0.6.9.1.dist-info/METADATA,sha256=nJl2uZaJwSdAoKeu8L1DjHepXx35aDfI9u-x09Az3Tc,8861
+p123client-0.0.6.9.1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+p123client-0.0.6.9.1.dist-info/RECORD,,

p123client-0.0.6.8.dist-info/RECORD

@@ -1,12 +0,0 @@
-LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-p123client/__init__.py,sha256=gfUum-q3f_XuXOk2HpArDAIxAlscZm8Fau1kiNkNFpg,214
-p123client/client.py,sha256=vK7kdjvd7I3iVUroiC89E1rt-HG-A1YhwECAaGr8aqk,258512
-p123client/const.py,sha256=T17OzPQrnIG6w_Hzjc8TF_fFMKa-hQMSn1gff8pVcBc,56
-p123client/exception.py,sha256=020xGo8WQmGCJz1UzNg9oFzpEvToQcgTye0s6lkFASQ,1540
-p123client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-p123client/tool/__init__.py,sha256=MFMue0hh3czAtfTf3yInzBgcNIWVVjO-8tHrPka4TGA,16454
-p123client/type.py,sha256=T17OzPQrnIG6w_Hzjc8TF_fFMKa-hQMSn1gff8pVcBc,56
-p123client-0.0.6.8.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-p123client-0.0.6.8.dist-info/METADATA,sha256=kQ9PI-wnjaB8NQe1vL8J0dzlZsLqinejvRpxB615KH0,8859
-p123client-0.0.6.8.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-p123client-0.0.6.8.dist-info/RECORD,,