p115client 0.0.5.10.7__py3-none-any.whl → 0.0.5.10.8__py3-none-any.whl

p115client/client.py

@@ -4489,6 +4489,10 @@ class P115Client(P115OpenClient):
         """
         self.cookies = None
 
+    @locked_cacheproperty
+    def request_kwargs(self, /) -> dict:
+        return {}
+
     @locked_cacheproperty
     def user_id(self, /) -> int:
         cookie_uid = self.cookies.get("UID")
@@ -5420,7 +5424,7 @@ class P115Client(P115OpenClient):
                 return None
         return self.logout_by_ssoent(ssoent, async_=async_, **request_kwargs)
 
-    def request(
+    def _request(
         self, 
         /, 
         url: str, 
@@ -5662,6 +5666,90 @@ class P115Client(P115OpenClient):
                     return resp
         return run_gen_step(gen_step, async_=async_)
 
+    def request(
+        self, 
+        /, 
+        url: str, 
+        method: str = "GET", 
+        params = None, 
+        data = None, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ):
+        """帮助函数：可执行同步和异步的网络请求
+
+        :param url: HTTP 的请求链接
+        :param method: HTTP 的请求方法
+        :param params: 查询参数
+        :param check: 是否用 `check_response` 函数检查返回值
+        :param ecdh_encrypt: 使用 ecdh 算法进行加密（返回值也要解密）
+        :param fetch_cert_headers: 调用以获取认证信息头
+        :param revert_cert_headers: 调用以退还认证信息头
+        :param async_: 说明 `request` 是同步调用还是异步调用
+        :param request: HTTP 请求调用，如果为 None，则默认用 httpx 执行请求
+            如果传入调用，则必须至少能接受以下几个关键词参数：
+
+            - url:     HTTP 的请求链接
+            - method:  HTTP 的请求方法
+            - headers: HTTP 的请求头
+            - data:    HTTP 的请求体
+            - parse:   解析 HTTP 响应的方法，默认会构建一个 Callable，会把响应的字节数据视为 JSON 进行反序列化解析
+
+                - 如果为 None，则直接把响应对象返回
+                - 如果为 ...(Ellipsis)，则把响应对象关闭后将其返回
+                - 如果为 True，则根据响应头来确定把响应得到的字节数据解析成何种格式（反序列化），请求也会被自动关闭
+                - 如果为 False，则直接返回响应得到的字节数据，请求也会被自动关闭
+                - 如果为 Callable，则使用此调用来解析数据，接受 1-2 个位置参数，并把解析结果返回给 `request` 的调用者，请求也会被自动关闭
+                    - 如果只接受 1 个位置参数，则把响应对象传给它
+                    - 如果能接受 2 个位置参数，则把响应对象和响应得到的字节数据（响应体）传给它
+
+        :param request_kwargs: 其余的请求参数，会被传给 `request`
+
+        :return: 直接返回 `request` 执行请求后的返回值
+
+        .. note:: 
+            `request` 可以由不同的请求库来提供，下面是封装了一些模块
+
+            1. `httpx_request <https://pypi.org/project/httpx_request/>`_，由 `httpx <https://pypi.org/project/httpx/>`_ 封装，支持同步和异步调用，本模块默认用的就是这个封装
+
+                .. code:: python
+
+                    from httpx_request import request
+
+            2. `python-urlopen <https://pypi.org/project/python-urlopen/>`_，由 `urllib.request.urlopen <https://docs.python.org/3/library/urllib.request.html#urllib.request.urlopen>`_ 封装，支持同步调用，性能相对最差
+
+                .. code:: python
+
+                    from urlopen import request
+
+            3. `urllib3_request <https://pypi.org/project/urllib3_request/>`_，由 `urllib3 <https://pypi.org/project/urllib3/>`_ 封装，支持同步调用，性能相对较好，推荐使用
+
+                .. code:: python
+
+                    from urllib3_request import request
+
+            4. `requests_request <https://pypi.org/project/requests_request/>`_，由 `requests <https://pypi.org/project/requests/>`_ 封装，支持同步调用
+
+                .. code:: python
+
+                    from requests_request import request
+
+            5. `aiohttp_client_request <https://pypi.org/project/aiohttp_client_request/>`_，由 `aiohttp <https://pypi.org/project/aiohttp/>`_ 封装，支持异步调用，异步并发能力最强，推荐使用
+
+                .. code:: python
+
+                    from aiohttp_client_request import request
+
+            6. `blacksheep_client_request <https://pypi.org/project/blacksheep_client_request/>`_，由 `blacksheep <https://pypi.org/project/blacksheep/>`_ 封装，支持异步调用
+
+                .. code:: python
+
+                    from blacksheep_client_request import request
+        """
+        kwargs = {**self.request_kwargs, **request_kwargs}
+        return self._request(url, method, params, data, async_=async_, **kwargs)
+
     ########## Activity API ##########
 
     @overload
@@ -15047,6 +15135,13 @@ class P115Client(P115OpenClient):
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
+        """获取某个开放应用的授权信息
+
+        GET https://qrcodeapi.115.com/app/1.0/web/1.0/user/getAppAuthDetail
+
+        :payload:
+            - auth_id: int | str 💡 授权 id
+        """
         api = complete_api(f"/app/1.0/{app}/1.0/user/getAppAuthDetail", base_url=base_url)
         if isinstance(payload, (int, str)):
             payload = {"auth_id": payload}
@@ -15083,6 +15178,10 @@ class P115Client(P115OpenClient):
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
+        """获取所有授权的开放应用的列表
+
+        GET https://qrcodeapi.115.com/app/1.0/web/1.0/user/getAppAuthList
+        """
         api = complete_api(f"/app/1.0/{app}/1.0/user/getAppAuthList", base_url=base_url)
         return self.request(url=api, async_=async_, **request_kwargs)
 
@@ -15120,6 +15219,13 @@ class P115Client(P115OpenClient):
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
+        """取消某个开放应用的授权
+
+        GET https://qrcodeapi.115.com/app/1.0/web/1.0/user/deauthApp
+
+        :payload:
+            - auth_id: int | str 💡 授权 id
+        """
         api = complete_api(f"/app/1.0/{app}/1.0/user/deauthApp", base_url=base_url)
         if isinstance(payload, (int, str)):
             payload = {"auth_id": payload}

{p115client-0.0.5.10.7.dist-info → p115client-0.0.5.10.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: p115client
-Version: 0.0.5.10.7
+Version: 0.0.5.10.8
 Summary: Python 115 webdisk client.
 Home-page: https://github.com/ChenyangGao/p115client
 License: MIT
@@ -23,8 +23,8 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Dist: aiofile
 Requires-Dist: ed2k (>=0.0.2.1)
 Requires-Dist: http_response (>=0.0.2.2)
-Requires-Dist: httpx
-Requires-Dist: httpx_request (>=0.1.3)
+Requires-Dist: httpx (>=0.28)
+Requires-Dist: httpx_request (>=0.1.4)
 Requires-Dist: iter_collect (>=0.0.5.1)
 Requires-Dist: multidict
 Requires-Dist: orjson

{p115client-0.0.5.10.7.dist-info → p115client-0.0.5.10.8.dist-info}/RECORD

@@ -1,7 +1,7 @@
 LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
 p115client/__init__.py,sha256=1mx7njuAlqcuEWONTjSiiGnXyyNyqOcJyNX1FMHqQ-4,214
 p115client/_upload.py,sha256=DOckFLU_P7Fl0BNu_0-2od6pPsCnzroYY6zZE5_EMnM,30735
-p115client/client.py,sha256=wBfWdM8kcP0Bb7IjXlaLGgjFm6j4usulnAGQZn1IbG4,735678
+p115client/client.py,sha256=PPKoMONdbGQ7FqH2a00QBNwAEcec6N4D1J6trWfvTdw,740587
 p115client/const.py,sha256=Ks8eYjHYApxlkelVCbSJlpmlCYtbk8fX80jETV72BTY,7754
 p115client/exception.py,sha256=O4SlfjbtI9GPjzbzJrFaFUZENJFz2qA3VDEKZfdhHbc,3590
 p115client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -20,7 +20,7 @@ p115client/tool/upload.py,sha256=qK1OQYxP-Faq2eMDhc5sBXJiSr8m8EZ_gb0O_iA2TrI,159
 p115client/tool/util.py,sha256=0o9TrXdoPcljgxDDRdxRon41bq1OjuUYCWsR0XLfmPo,3357
 p115client/tool/xys.py,sha256=WMTisCyN4eYyv4A14yYOpjud2mBhQvBcUHOp6pJUQeA,10140
 p115client/type.py,sha256=7kOp98uLaYqcTTCgCrb3DRcl8ukMpn7ibsnVvtw2nG8,6250
-p115client-0.0.5.10.7.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-p115client-0.0.5.10.7.dist-info/METADATA,sha256=tDpsaOSwhFKsPqLLHLQ9qKrCo05Xx09zLWxUYsKUSqA,8232
-p115client-0.0.5.10.7.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-p115client-0.0.5.10.7.dist-info/RECORD,,
+p115client-0.0.5.10.8.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+p115client-0.0.5.10.8.dist-info/METADATA,sha256=o0xNuA8shlBXypTl1jBLay2nsh01W_I-zv5HhBhPdpo,8241
+p115client-0.0.5.10.8.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+p115client-0.0.5.10.8.dist-info/RECORD,,