p115client 0.0.5.11.6__py3-none-any.whl → 0.0.5.11.7.1__py3-none-any.whl

p115client/client.py

@@ -766,7 +766,7 @@ def normalize_attr_app[D: dict[str, Any]](
     simple: bool = False, 
     keep_raw: bool = False, 
     *, 
-    dict_cls: None | type[D] = None, 
+    dict_cls: type[D], 
 ) -> D:
     ...
 def normalize_attr_app[D: dict[str, Any]](
@@ -896,7 +896,7 @@ def normalize_attr_app2[D: dict[str, Any]](
     simple: bool = False, 
     keep_raw: bool = False, 
     *, 
-    dict_cls: None | type[D] = None, 
+    dict_cls: type[D], 
 ) -> D:
     ...
 def normalize_attr_app2[D: dict[str, Any]](
@@ -1082,7 +1082,7 @@ def normalize_attr_simple(
     /, 
     keep_raw: bool = False, 
     *, 
-    dict_cls: None = None, 
+    dict_cls: None, 
 ) -> dict[str, Any]:
     ...
 @overload
@@ -1091,7 +1091,7 @@ def normalize_attr_simple[D: dict[str, Any]](
     /, 
     keep_raw: bool = False, 
     *, 
-    dict_cls: type[D], 
+    dict_cls: type[D] = AttrDict, # type: ignore
 ) -> D:
     ...
 def normalize_attr_simple[D: dict[str, Any]](
@@ -1099,7 +1099,7 @@ def normalize_attr_simple[D: dict[str, Any]](
     /, 
     keep_raw: bool = False, 
     *, 
-    dict_cls: None | type[D] = None, 
+    dict_cls: None | type[D] = AttrDict, # type: ignore
 ) -> dict[str, Any] | D:
     return normalize_attr(
         info, 
@@ -1138,7 +1138,7 @@ class IgnoreCaseDict[V](dict[str, V]):
         return cls(zip(map(str.lower, iterable), repeat(value)))
 
     @overload
-    def get(self, key: str) -> None | V:
+    def get(self, key: str, default: None = None) -> None | V:
         ...
     @overload
     def get[T](self, key: str, default: T) -> V | T:
@@ -2329,7 +2329,7 @@ class ClientRequestMixin:
     def login_with_app_id(
         cls, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         console_qrcode: bool = True, 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
@@ -2342,7 +2342,7 @@ class ClientRequestMixin:
     def login_with_app_id(
         cls, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         console_qrcode: bool = True, 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
@@ -2354,7 +2354,7 @@ class ClientRequestMixin:
     def login_with_app_id(
         cls, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         console_qrcode: bool = True, 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
@@ -4994,7 +4994,7 @@ class P115OpenClient(ClientRequestMixin):
                         else:
                             filesize, filesha1_obj = file_digest(file, "sha1")
                     finally:
-                        yield seek(curpos)
+                        yield cast(Callable, seek)(curpos)
                     filesha1 = filesha1_obj.hexdigest()
                 if filesize < 0:
                     try:
@@ -5006,9 +5006,9 @@ class P115OpenClient(ClientRequestMixin):
                         except TypeError:
                             if seekable:
                                 try:
-                                    filesize = (yield seek(0, 2)) - curpos
+                                    filesize = (yield cast(Callable, seek)(0, 2)) - curpos
                                 finally:
-                                    yield seek(curpos)
+                                    yield cast(Callable, seek)(curpos)
                 if filesize == 0:
                     filesha1 = "DA39A3EE5E6B4B0D3255BFEF95601890AFD80709"
                 elif multipart_resume_data is None and filesize >= 1 << 20:
@@ -5018,13 +5018,13 @@ class P115OpenClient(ClientRequestMixin):
                             async_read = ensure_async(file.read, threaded=True)
                             async def read_range_bytes_or_hash(sign_check: str, /):
                                 start, end = map(int, sign_check.split("-"))
-                                await seek(curpos + start)
+                                await cast(Callable, seek)(curpos + start)
                                 return await async_read(end - start + 1)
                         else:
                             read = cast(Callable[[int], Buffer], file.read)
                             def read_range_bytes_or_hash(sign_check: str, /):
                                 start, end = map(int, sign_check.split("-"))
-                                seek(curpos + start)
+                                cast(Callable, seek)(curpos + start)
                                 return read(end - start + 1)
             elif isinstance(file, (URL, SupportsGeturl)):
                 if isinstance(file, URL):
@@ -5194,6 +5194,60 @@ class P115OpenClient(ClientRequestMixin):
         api = complete_proapi("/open/user/info", base_url)
         return self.request(url=api, async_=async_, **request_kwargs)
 
+    @overload
+    def vip_qr_url(
+        self, 
+        payload: int | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def vip_qr_url(
+        self, 
+        payload: int | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def vip_qr_url(
+        self, 
+        payload: int | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取产品列表地址（即引导用户扫码购买 115 的 VIP 服务，以获取提成）
+
+        GET https://proapi.115.com/open/open/vip/qr_url
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/cguk6qshgapwg4qn#oByvI
+
+        :payload:
+            - open_device: int
+            - default_product_id: int = <default> 💡 打开产品列表默认选中的产品对应的产品id，如果没有则使用默认的产品顺序。
+
+                - 月费: 5
+                - 年费: 1
+                - 尝鲜1天: 101
+                - 长期VIP(长期): 24072401
+                - 超级VIP: 24072402
+        """
+        api = complete_proapi("/open/vip/qr_url", base_url)
+        if not isinstance(payload, dict):
+            payload = {"open_device": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
     download_url_open = download_url
     download_url_info_open = download_url_info
     fs_copy_open = fs_copy
@@ -5226,6 +5280,7 @@ class P115OpenClient(ClientRequestMixin):
     user_info_open = user_info
     upload_file_init_open = upload_file_init
     upload_file_open = upload_file
+    vip_qr_url_open = vip_qr_url
 
 
 class P115Client(P115OpenClient):
@@ -5902,7 +5957,7 @@ class P115Client(P115OpenClient):
     def login_with_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         show_warning: bool = False, 
         async_: Literal[False] = False, 
@@ -5913,7 +5968,7 @@ class P115Client(P115OpenClient):
     def login_with_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         show_warning: bool = False, 
         async_: Literal[True], 
@@ -5923,7 +5978,7 @@ class P115Client(P115OpenClient):
     def login_with_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         show_warning: bool = False, 
         async_: Literal[False, True] = False, 
@@ -6098,7 +6153,7 @@ class P115Client(P115OpenClient):
     def login_another_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         replace: Literal[True] | Self, 
         show_warning: bool = False, 
@@ -6110,7 +6165,7 @@ class P115Client(P115OpenClient):
     def login_another_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         replace: Literal[True] | Self, 
         show_warning: bool = False, 
@@ -6122,7 +6177,7 @@ class P115Client(P115OpenClient):
     def login_another_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         replace: Literal[False] = False, 
         show_warning: bool = False, 
@@ -6134,7 +6189,7 @@ class P115Client(P115OpenClient):
     def login_another_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         replace: Literal[False] = False, 
         show_warning: bool = False, 
@@ -6145,7 +6200,7 @@ class P115Client(P115OpenClient):
     def login_another_open(
         self, 
         /, 
-        app_id: int | str = 100195993, 
+        app_id: int | str, 
         *, 
         replace: bool | Self = False, 
         show_warning: bool = False, 
@@ -6540,7 +6595,7 @@ class P115Client(P115OpenClient):
                                 continue
                             if i or is_auth_error:
                                 raise
-                            app_id = getattr(self, "app_id", 100195993)
+                            app_id = getattr(self, "app_id")
                             yield self.login_another_open(
                                 app_id, 
                                 replace=True, 
@@ -21125,7 +21180,7 @@ class P115Client(P115OpenClient):
                         else:
                             filesize, filesha1_obj = file_digest(file, "sha1")
                     finally:
-                        yield seek(curpos)
+                        yield cast(Callable, seek)(curpos)
                     filesha1 = filesha1_obj.hexdigest()
                 if filesize < 0:
                     try:
@@ -21137,9 +21192,9 @@ class P115Client(P115OpenClient):
                         except TypeError:
                             if seekable:
                                 try:
-                                    filesize = (yield seek(0, 2)) - curpos
+                                    filesize = (yield cast(Callable, seek)(0, 2)) - curpos
                                 finally:
-                                    yield seek(curpos)
+                                    yield cast(Callable, seek)(curpos)
                 if filesize == 0:
                     filesha1 = "DA39A3EE5E6B4B0D3255BFEF95601890AFD80709"
                 elif not upload_directly and multipart_resume_data is None and filesize >= 1 << 20:
@@ -21149,13 +21204,13 @@ class P115Client(P115OpenClient):
                             async_read = ensure_async(file.read, threaded=True)
                             async def read_range_bytes_or_hash(sign_check: str, /):
                                 start, end = map(int, sign_check.split("-"))
-                                await seek(curpos + start)
+                                await cast(Callable, seek)(curpos + start)
                                 return await async_read(end - start + 1)
                         else:
                             read = cast(Callable[[int], Buffer], file.read)
                             def read_range_bytes_or_hash(sign_check: str, /):
                                 start, end = map(int, sign_check.split("-"))
-                                seek(curpos + start)
+                                cast(Callable, seek)(curpos + start)
                                 return read(end - start + 1)
             elif isinstance(file, (URL, SupportsGeturl)):
                 if isinstance(file, URL):

p115client/const.py

@@ -5,18 +5,14 @@ from __future__ import annotations
 
 __author__ = "ChenyangGao <https://chenyanggao.github.io>"
 __all__ = [
-    "AVAILABLE_APP_IDS", "AVAILABLE_APPS", "APP_TO_SSOENT", "SSOENT_TO_APP", 
-    "CLIENT_API_MAP", "CLASS_TO_TYPE", "SUFFIX_TO_TYPE", "errno", 
+    "AVAILABLE_APPS", "APP_TO_SSOENT", "SSOENT_TO_APP", "CLIENT_API_MAP", 
+    "CLASS_TO_TYPE", "SUFFIX_TO_TYPE", "errno", 
 ]
 
 from enum import IntEnum
 from typing import Final
 
 
-#: 可用的 AppID 列表
-AVAILABLE_APP_IDS = range(100195123, 100196845, 2)
-
-
 #: 目前可用的登录设备
 AVAILABLE_APPS: Final[tuple[str, ...]] = (
     "web", "ios", "115ios", "android", "115android", "115ipad", "tv", "qandroid", 

p115client/tool/attr.py

@@ -55,8 +55,8 @@ def get_attr(
     if isinstance(client, str):
         client = P115Client(client, check_for_relogin=True)
     def gen_step():
+        from dictattr import AttrDict
         if skim:
-            from dictattr import AttrDict
             resp = yield client.fs_file_skim(id, async_=async_, **request_kwargs)
             check_response(resp)
             info = resp["data"][0]
@@ -71,7 +71,7 @@ def get_attr(
         else:
             resp = yield client.fs_file(id, async_=async_, **request_kwargs)
             check_response(resp)
-            return normalize_attr_web(resp["data"][0])
+            return normalize_attr_web(resp["data"][0], dict_cls=AttrDict)
     return run_gen_step(gen_step, may_call=False, async_=async_)
 
 

p115client/tool/download.py

@@ -10,7 +10,7 @@ __all__ = [
 __doc__ = "这个模块提供了一些和下载有关的函数"
 
 from asyncio import create_task, to_thread, Queue as AsyncQueue, TaskGroup
-from collections.abc import AsyncIterator, Callable, Coroutine, Iterable, Iterator
+from collections.abc import AsyncIterator, Callable, Coroutine, Iterable, Iterator, MutableMapping
 from concurrent.futures import ThreadPoolExecutor
 from errno import ENOTDIR
 from functools import partial
@@ -243,7 +243,7 @@ def iter_files_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     user_agent: str = "", 
@@ -264,7 +264,7 @@ def iter_files_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     user_agent: str = "", 
@@ -284,7 +284,7 @@ def iter_files_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     user_agent: str = "", 
@@ -417,7 +417,7 @@ def iter_images_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     *, 
@@ -436,7 +436,7 @@ def iter_images_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     *, 
@@ -454,7 +454,7 @@ def iter_images_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     *, 
@@ -575,7 +575,7 @@ def iter_subtitles_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     *, 
@@ -594,7 +594,7 @@ def iter_subtitles_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     *, 
@@ -612,7 +612,7 @@ def iter_subtitles_with_url(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     raise_for_changed_count: bool = False, 
     *, 
@@ -855,7 +855,7 @@ def make_strm(
     suffix: str = "", 
     type: Literal[1, 2, 3, 4, 5, 6, 7, 99] = 4, 
     max_workers: None | int = None, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     path_already: bool = False, 
     app: str = "android", 
     fs_files_cooldown: int | float = 0.5, 
@@ -881,7 +881,7 @@ def make_strm(
     suffix: str = "", 
     type: Literal[1, 2, 3, 4, 5, 6, 7, 99] = 4, 
     max_workers: None | int = None, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     path_already: bool = False, 
     app: str = "android", 
     fs_files_cooldown: int | float = 0.5, 
@@ -906,7 +906,7 @@ def make_strm(
     suffix: str = "", 
     type: Literal[1, 2, 3, 4, 5, 6, 7, 99] = 4, 
     max_workers: None | int = None, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     path_already: bool = False, 
     app: str = "android", 
     fs_files_cooldown: int | float = 0.5, 
@@ -1295,7 +1295,7 @@ def iter_download_nodes(
 def iter_download_files(
     client: str | P115Client, 
     cid: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     escape: None | bool | Callable[[str], str] = True, 
     with_ancestors: bool = True, 
     max_workers: None | int = None, 
@@ -1309,7 +1309,7 @@ def iter_download_files(
 def iter_download_files(
     client: str | P115Client, 
     cid: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     escape: None | bool | Callable[[str], str] = True, 
     with_ancestors: bool = True, 
     max_workers: None | int = None, 
@@ -1322,7 +1322,7 @@ def iter_download_files(
 def iter_download_files(
     client: str | P115Client, 
     cid: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     escape: None | bool | Callable[[str], str] = True, 
     with_ancestors: bool = True, 
     max_workers: None | int = None, 

p115client/tool/iterdir.py

@@ -21,7 +21,7 @@ from asyncio import create_task, sleep as async_sleep, Lock as AsyncLock
 from collections import defaultdict
 from collections.abc import (
     AsyncIterable, AsyncIterator, Callable, Collection, Coroutine, Iterable, Iterator, 
-    Mapping, Sequence, 
+    Mapping, MutableMapping, Sequence, 
 )
 from dataclasses import dataclass
 from errno import EIO, ENOENT, ENOTDIR
@@ -129,7 +129,7 @@ def get_path_to_cid(
     root_id: None | int = None, 
     escape: None | bool | Callable[[str], str] = True, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[False] = False, 
@@ -143,7 +143,7 @@ def get_path_to_cid(
     root_id: None | int = None, 
     escape: None | bool | Callable[[str], str] = True, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[True], 
@@ -156,7 +156,7 @@ def get_path_to_cid(
     root_id: None | int = None, 
     escape: None | bool | Callable[[str], str] = True, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[False, True] = False, 
@@ -245,7 +245,7 @@ def get_path_to_cid(
 def get_file_count(
     client: str | P115Client, 
     cid: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     use_fs_files: bool = True, 
     *, 
@@ -257,7 +257,7 @@ def get_file_count(
 def get_file_count(
     client: str | P115Client, 
     cid: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     use_fs_files: bool = True, 
     *, 
@@ -268,7 +268,7 @@ def get_file_count(
 def get_file_count(
     client: str | P115Client, 
     cid: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     use_fs_files: bool = True, 
     *, 
@@ -377,7 +377,7 @@ def get_file_count(
 def get_ancestors(
     client: str | P115Client, 
     attr: int | dict, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[False] = False, 
@@ -388,7 +388,7 @@ def get_ancestors(
 def get_ancestors(
     client: str | P115Client, 
     attr: int | dict, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[True], 
@@ -398,7 +398,7 @@ def get_ancestors(
 def get_ancestors(
     client: str | P115Client, 
     attr: int | dict, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[False, True] = False, 
@@ -598,7 +598,7 @@ def get_ancestors_to_cid(
     client: str | P115Client, 
     cid: int = 0, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[False] = False, 
@@ -610,7 +610,7 @@ def get_ancestors_to_cid(
     client: str | P115Client, 
     cid: int = 0, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[True], 
@@ -621,7 +621,7 @@ def get_ancestors_to_cid(
     client: str | P115Client, 
     cid: int = 0, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     *, 
     async_: Literal[False, True] = False, 
@@ -704,7 +704,7 @@ def get_id_to_path(
     ensure_file: None | bool = None, 
     is_posixpath: bool = False, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     dont_use_getid: bool = False, 
     *, 
@@ -720,7 +720,7 @@ def get_id_to_path(
     ensure_file: None | bool = None, 
     is_posixpath: bool = False, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     dont_use_getid: bool = False, 
     *, 
@@ -735,7 +735,7 @@ def get_id_to_path(
     ensure_file: None | bool = None, 
     is_posixpath: bool = False, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     dont_use_getid: bool = False, 
     *, 
@@ -1063,7 +1063,7 @@ def _iter_fs_files(
     payload: int | str | dict = 0, 
     first_page_size: int = 0, 
     page_size: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1080,7 +1080,7 @@ def _iter_fs_files(
     payload: int | str | dict = 0, 
     first_page_size: int = 0, 
     page_size: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1096,7 +1096,7 @@ def _iter_fs_files(
     payload: int | str | dict = 0, 
     first_page_size: int = 0, 
     page_size: int = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1213,7 +1213,7 @@ def iter_stared_dirs_raw(
     first_page_size: int = 0, 
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -1230,7 +1230,7 @@ def iter_stared_dirs_raw(
     first_page_size: int = 0, 
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -1246,7 +1246,7 @@ def iter_stared_dirs_raw(
     first_page_size: int = 0, 
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -1307,7 +1307,7 @@ def iter_stared_dirs(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -1325,7 +1325,7 @@ def iter_stared_dirs(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -1342,7 +1342,7 @@ def iter_stared_dirs(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -1404,7 +1404,7 @@ def ensure_attr_path[D: dict](
     use_star: bool = False, 
     life_event_cooldown: int | float = 0.5, 
     escape: None | bool | Callable[[str], str] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     make_up_missing: bool = True, 
     app: str = "web", 
     errors: Literal["ignore", "raise", "warn"] = "raise", 
@@ -1423,7 +1423,7 @@ def ensure_attr_path[D: dict](
     use_star: bool = False, 
     life_event_cooldown: int | float = 0.5, 
     escape: None | bool | Callable[[str], str] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     make_up_missing: bool = True, 
     app: str = "web", 
     errors: Literal["ignore", "raise", "warn"] = "raise", 
@@ -1441,7 +1441,7 @@ def ensure_attr_path[D: dict](
     use_star: bool = False, 
     life_event_cooldown: int | float = 0.5, 
     escape: None | bool | Callable[[str], str] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     make_up_missing: bool = True, 
     app: str = "web", 
     errors: Literal["ignore", "raise", "warn"] = "raise", 
@@ -1603,7 +1603,7 @@ def ensure_attr_path_by_category_get[D: dict](
     with_ancestors: bool = False, 
     with_path: bool = True, 
     escape: None | bool | Callable[[str], str] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     max_workers: None | int = 20, 
     *, 
@@ -1618,7 +1618,7 @@ def ensure_attr_path_by_category_get[D: dict](
     with_ancestors: bool = False, 
     with_path: bool = True, 
     escape: None | bool | Callable[[str], str] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     max_workers: None | int = 20, 
     *, 
@@ -1632,7 +1632,7 @@ def ensure_attr_path_by_category_get[D: dict](
     with_ancestors: bool = False, 
     with_path: bool = True, 
     escape: None | bool | Callable[[str], str] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     max_workers: None | int = 20, 
     *, 
@@ -1789,7 +1789,7 @@ def iterdir_raw(
     asc: Literal[0, 1] = 1, 
     show_dir: Literal[0, 1] = 1, 
     fc_mix: Literal[0, 1] = 1, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1810,7 +1810,7 @@ def iterdir_raw(
     asc: Literal[0, 1] = 1, 
     show_dir: Literal[0, 1] = 1, 
     fc_mix: Literal[0, 1] = 1, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1830,7 +1830,7 @@ def iterdir_raw(
     asc: Literal[0, 1] = 1, 
     show_dir: Literal[0, 1] = 1, 
     fc_mix: Literal[0, 1] = 1, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1907,7 +1907,7 @@ def iterdir(
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1932,7 +1932,7 @@ def iterdir(
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -1956,7 +1956,7 @@ def iterdir(
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     ensure_file: None | bool = None, 
     app: str = "web", 
@@ -2088,7 +2088,7 @@ def iterdir_limited(
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     ensure_file: None | bool = None, 
     *, 
     async_: Literal[False, True] = False, 
@@ -2253,7 +2253,7 @@ def iter_files_raw(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     cur: Literal[0, 1] = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2274,7 +2274,7 @@ def iter_files_raw(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     cur: Literal[0, 1] = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2294,7 +2294,7 @@ def iter_files_raw(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     cur: Literal[0, 1] = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2385,7 +2385,7 @@ def iter_files(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2411,7 +2411,7 @@ def iter_files(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2436,7 +2436,7 @@ def iter_files(
     use_star: None | bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2626,7 +2626,7 @@ def traverse_files(
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2650,7 +2650,7 @@ def traverse_files(
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2673,7 +2673,7 @@ def traverse_files(
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2821,7 +2821,7 @@ def traverse_files(
 def iter_dirs(
     client: str | P115Client, 
     cid: int | str = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     with_pickcode: bool = False, 
     max_workers: None | int = None, 
     *, 
@@ -2833,7 +2833,7 @@ def iter_dirs(
 def iter_dirs(
     client: str | P115Client, 
     cid: int | str = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     with_pickcode: bool = False, 
     max_workers: None | int = None, 
     *, 
@@ -2844,7 +2844,7 @@ def iter_dirs(
 def iter_dirs(
     client: str | P115Client, 
     cid: int | str = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     with_pickcode: bool = False, 
     max_workers: None | int = None, 
     *, 
@@ -2928,7 +2928,7 @@ def iter_dupfiles[K](
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2953,7 +2953,7 @@ def iter_dupfiles[K](
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -2977,7 +2977,7 @@ def iter_dupfiles[K](
     with_path: bool = False, 
     escape: None | bool | Callable[[str], str] = True, 
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -3173,7 +3173,7 @@ def share_iterdir(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     normalize_attr: None | Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[False] = False, 
     **request_kwargs, 
@@ -3189,7 +3189,7 @@ def share_iterdir(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     normalize_attr: None | Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[True], 
     **request_kwargs, 
@@ -3204,7 +3204,7 @@ def share_iterdir(
     order: Literal["file_name", "file_size", "file_type", "user_utime", "user_ptime", "user_otime"] = "user_ptime", 
     asc: Literal[0, 1] = 1, 
     normalize_attr: None | Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[False, True] = False, 
     **request_kwargs, 
@@ -3281,7 +3281,7 @@ def share_iter_files(
     client: str | P115Client, 
     share_link: str, 
     receive_code: str = "", 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[False] = False, 
     **request_kwargs, 
@@ -3292,7 +3292,7 @@ def share_iter_files(
     client: str | P115Client, 
     share_link: str, 
     receive_code: str = "", 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[True], 
     **request_kwargs, 
@@ -3302,7 +3302,7 @@ def share_iter_files(
     client: str | P115Client, 
     share_link: str, 
     receive_code: str = "", 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None,  
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None,  
     *, 
     async_: Literal[False, True] = False, 
     **request_kwargs, 
@@ -3389,7 +3389,7 @@ def share_get_id_to_path(
     ensure_file: None | bool = None, 
     is_posixpath: bool = False, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[False] = False, 
     **request_kwargs, 
@@ -3405,7 +3405,7 @@ def share_get_id_to_path(
     ensure_file: None | bool = None, 
     is_posixpath: bool = False, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[True], 
     **request_kwargs, 
@@ -3420,7 +3420,7 @@ def share_get_id_to_path(
     ensure_file: None | bool = None, 
     is_posixpath: bool = False, 
     refresh: bool = False, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     *, 
     async_: Literal[False, True] = False, 
     **request_kwargs, 
@@ -3555,7 +3555,7 @@ def iter_selected_nodes(
     ids: Iterable[int], 
     ignore_deleted: bool = True, 
     normalize_attr: None | Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False] = False, 
@@ -3568,7 +3568,7 @@ def iter_selected_nodes(
     ids: Iterable[int], 
     ignore_deleted: bool = True, 
     normalize_attr: None | Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[True], 
@@ -3580,7 +3580,7 @@ def iter_selected_nodes(
     ids: Iterable[int], 
     ignore_deleted: bool = True, 
     normalize_attr: None | Callable[[dict], dict] = normalize_attr, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False, True] = False, 
@@ -3652,7 +3652,7 @@ def iter_selected_nodes_by_pickcode(
     ids: Iterable[int | str], 
     ignore_deleted: None | bool = True, 
     normalize_attr: None | Callable[[dict], dict] = None, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False] = False, 
@@ -3665,7 +3665,7 @@ def iter_selected_nodes_by_pickcode(
     ids: Iterable[int | str], 
     ignore_deleted: None | bool = True, 
     normalize_attr: None | Callable[[dict], dict] = None, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20,  
     *, 
     async_: Literal[True], 
@@ -3677,7 +3677,7 @@ def iter_selected_nodes_by_pickcode(
     ids: Iterable[int | str], 
     ignore_deleted: None | bool = True, 
     normalize_attr: None | Callable[[dict], dict] = None, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False, True] = False, 
@@ -3765,7 +3765,7 @@ def iter_selected_nodes_by_pickcode(
 def iter_selected_nodes_using_edit(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False] = False, 
@@ -3776,7 +3776,7 @@ def iter_selected_nodes_using_edit(
 def iter_selected_nodes_using_edit(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[True], 
@@ -3786,7 +3786,7 @@ def iter_selected_nodes_using_edit(
 def iter_selected_nodes_using_edit(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False, True] = False, 
@@ -3852,7 +3852,7 @@ def iter_selected_nodes_using_edit(
 def iter_selected_nodes_using_category_get(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False] = False, 
@@ -3863,7 +3863,7 @@ def iter_selected_nodes_using_category_get(
 def iter_selected_nodes_using_category_get(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[True], 
@@ -3873,7 +3873,7 @@ def iter_selected_nodes_using_category_get(
 def iter_selected_nodes_using_category_get(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = 20, 
     *, 
     async_: Literal[False, True] = False, 
@@ -3940,7 +3940,7 @@ def iter_selected_nodes_using_star_event(
     ids: Iterable[int], 
     with_pics: bool = False, 
     normalize_attr: None | bool | Callable[[dict], dict] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     cooldown: int | float = 0, 
     *, 
@@ -3954,7 +3954,7 @@ def iter_selected_nodes_using_star_event(
     ids: Iterable[int], 
     with_pics: bool = False, 
     normalize_attr: None | bool | Callable[[dict], dict] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     cooldown: int | float = 0, 
     *, 
@@ -3967,7 +3967,7 @@ def iter_selected_nodes_using_star_event(
     ids: Iterable[int], 
     with_pics: bool = False, 
     normalize_attr: None | bool | Callable[[dict], dict] = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     app: str = "web", 
     cooldown: int | float = 0, 
     *, 
@@ -4095,7 +4095,7 @@ def iter_selected_nodes_using_star_event(
 def iter_selected_dirs_using_star(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -4109,7 +4109,7 @@ def iter_selected_dirs_using_star(
 def iter_selected_dirs_using_star(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -4122,7 +4122,7 @@ def iter_selected_dirs_using_star(
 def iter_selected_dirs_using_star(
     client: str | P115Client, 
     ids: Iterable[int], 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     raise_for_changed_count: bool = False, 
     app: str = "web", 
     cooldown: int | float = 0, 
@@ -4393,7 +4393,7 @@ def iter_files_with_path(
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
     escape: None | bool | Callable[[str], str] = True, 
     with_ancestors: bool = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     path_already: bool = False, 
     raise_for_changed_count: bool = False, 
     app: str = "android", 
@@ -4417,7 +4417,7 @@ def iter_files_with_path(
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
     escape: None | bool | Callable[[str], str] = True, 
     with_ancestors: bool = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     path_already: bool = False, 
     raise_for_changed_count: bool = False, 
     app: str = "android", 
@@ -4440,7 +4440,7 @@ def iter_files_with_path(
     normalize_attr: Callable[[dict], dict] = normalize_attr, 
     escape: None | bool | Callable[[str], str] = True, 
     with_ancestors: bool = True, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     path_already: bool = False, 
     raise_for_changed_count: bool = False, 
     app: str = "android", 
@@ -5001,7 +5001,7 @@ def iter_parents_3_level(
 def iter_dir_nodes(
     client: str | P115Client, 
     cid: int | str = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = None, 
     *, 
     async_: Literal[False] = False, 
@@ -5012,7 +5012,7 @@ def iter_dir_nodes(
 def iter_dir_nodes(
     client: str | P115Client, 
     cid: int | str = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = None, 
     *, 
     async_: Literal[True], 
@@ -5022,7 +5022,7 @@ def iter_dir_nodes(
 def iter_dir_nodes(
     client: str | P115Client, 
     cid: int | str = 0, 
-    id_to_dirnode: None | EllipsisType | dict[int, tuple[str, int] | DirNode] = None, 
+    id_to_dirnode: None | EllipsisType | MutableMapping[int, tuple[str, int] | DirNode] = None, 
     max_workers: None | int = None, 
     *, 
     async_: Literal[False, True] = False, 

p115client/tool/pool.py

@@ -21,7 +21,6 @@ from time import time
 
 from iterutils import run_gen_step
 from p115client import check_response, P115Client
-from p115client.const import AVAILABLE_APP_IDS
 from p115client.exception import P115OSError, AuthenticationError, LoginError
 
 from .util import get_status_code, is_timeouterror
@@ -55,7 +54,7 @@ class ComparedWithID[T]:
 
 def generate_auth_factory(
     client: str | P115Client, 
-    app_ids: Iterable[int] = AVAILABLE_APP_IDS, 
+    app_ids: Iterable[int], 
     **request_kwargs, 
 ) -> Callable:
     """利用一个已登录设备的 cookies，产生若干开放应用的 access_token
@@ -238,7 +237,7 @@ def make_pool[T](
 
 def auth_pool(
     client: str | P115Client, 
-    app_ids: Iterable[int] = AVAILABLE_APP_IDS, 
+    app_ids: Iterable[int], 
     heap: None | list[tuple[float, dict | ComparedWithID[dict]]] = None, 
     cooldown_time: int | float = 1, 
     live_time: int | float = 7000, 

{p115client-0.0.5.11.6.dist-info → p115client-0.0.5.11.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: p115client
-Version: 0.0.5.11.6
+Version: 0.0.5.11.7.1
 Summary: Python 115 webdisk client.
 Home-page: https://github.com/ChenyangGao/p115client
 License: MIT
@@ -108,7 +108,7 @@ client = P115Client(Path("~/115-cookies.txt").expanduser(), check_for_relogin=Tr
 
 如果你有一个申请通过的开放接口的应用，则可以创建开放接口的客户端实例
 
-你可以直接从一个 `P115Client` 实例拿到授权（自动扫码登录并授权），如果不提供 `app_id`，则使用默认值
+你可以直接从一个 `P115Client` 实例拿到授权（自动扫码登录并授权）
 
 ```python
 app_id = <开放接口应用的 AppID>

{p115client-0.0.5.11.6.dist-info → p115client-0.0.5.11.7.1.dist-info}/RECORD

@@ -1,26 +1,26 @@
 LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
 p115client/__init__.py,sha256=1mx7njuAlqcuEWONTjSiiGnXyyNyqOcJyNX1FMHqQ-4,214
 p115client/_upload.py,sha256=RTYpM_EDFuI3O7yf08f13NdeG0iD03o_V4H6Je6Nsr8,30754
-p115client/client.py,sha256=pkwJCBfjefUknbMkfIiSJqwGeVfJdg-EVtJvDA_xkXI,770973
-p115client/const.py,sha256=Ks8eYjHYApxlkelVCbSJlpmlCYtbk8fX80jETV72BTY,7754
+p115client/client.py,sha256=vRFeTy3SjoWu4uqmsZWkRl9xdXe0S1CrvoFXEACamvc,772745
+p115client/const.py,sha256=KqDGr9KsOnSkNVM3RIdQGptCMHbidMmZ_ffyFPiniww,7654
 p115client/exception.py,sha256=O4SlfjbtI9GPjzbzJrFaFUZENJFz2qA3VDEKZfdhHbc,3590
 p115client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 p115client/tool/__init__.py,sha256=NjT9rroMhLwKI7UlpSCksSsnB3GexXzxvhfunNWzjY0,386
-p115client/tool/attr.py,sha256=rSnmVXhIqkUJ7NmwTo0LR76ZC2bOh1qaZkQok10Pzt8,2899
-p115client/tool/download.py,sha256=-iq2JOolc4uba00wsp-Z_I03ZTFgqM4UKrfHAWpH2QA,61368
+p115client/tool/attr.py,sha256=VRte9LuE2YG8nPIxbeetdzDJgZL5ZFVp7RzjpIXUPN4,2914
+p115client/tool/download.py,sha256=CZJE5f1SHi26eCNTPcF5VjSoht8WTUYravEG219i4gk,61534
 p115client/tool/edit.py,sha256=kRz-Ee7KuNNlHhcVi4uHdh9DSfF1ZxUREIhK9x4hNIE,17771
 p115client/tool/export_dir.py,sha256=1r2qDuYIirtDkCBQfYXh6lbm06IStRpiom-ZjtIYdbo,24502
 p115client/tool/fs_files.py,sha256=XTG12a_MVwYI4p1hs-xMol-AQsa8C9pWFt0BUzlQCws,15634
 p115client/tool/history.py,sha256=qquCiiOIRpxOqmyXbmdwS_qpfPkduJilM6AGuOufrYU,7462
-p115client/tool/iterdir.py,sha256=j7hZXrlUWBmg-kAgTjQ36BqY-8EiF9KLmPMM2ogHRPc,199632
+p115client/tool/iterdir.py,sha256=dXBMPfxPzRcFhBpnBT3X1LYkhc3l31rYCLRKRFbggSk,200498
 p115client/tool/life.py,sha256=ceweN2uNKYxigSOaBQ4Abo5u05zqppRm_P7k-_rHjcA,17301
-p115client/tool/pool.py,sha256=IR_ssyVhBSQYmfD--5Blyi7X3wtiPk7cLKb7YowhmEU,14033
+p115client/tool/pool.py,sha256=H65VhoNxQC6xWSL1THq_PximWnBOqB4EfU6kWBTAnlA,13946
 p115client/tool/request.py,sha256=rjXuQwRganE5Z-4rfgnyPFjE4jzdQSLdIs9s0cIDshU,7043
 p115client/tool/upload.py,sha256=i6laoeG7GdNO7hvCDVBy8Yv2Is800wL7O5na6a3v70g,15971
 p115client/tool/util.py,sha256=0o9TrXdoPcljgxDDRdxRon41bq1OjuUYCWsR0XLfmPo,3357
 p115client/tool/xys.py,sha256=vU28Px2yeQzIxxGkopJIpvV6TdOnWJ5xB6NPXpTgM0Y,10306
 p115client/type.py,sha256=7kOp98uLaYqcTTCgCrb3DRcl8ukMpn7ibsnVvtw2nG8,6250
-p115client-0.0.5.11.6.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-p115client-0.0.5.11.6.dist-info/METADATA,sha256=VxWxcCRCKshkjt7_Svyb4-C_8hYUO3vDiaXFp9UwX6Q,8240
-p115client-0.0.5.11.6.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-p115client-0.0.5.11.6.dist-info/RECORD,,
+p115client-0.0.5.11.7.1.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+p115client-0.0.5.11.7.1.dist-info/METADATA,sha256=gLBpBgItF8bDZtseomQxMYZP4Qi7MYaNX3M3JaVrm8U,8194
+p115client-0.0.5.11.7.1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+p115client-0.0.5.11.7.1.dist-info/RECORD,,