p115client 0.0.5.10.7__tar.gz → 0.0.5.10.8__tar.gz

{p115client-0.0.5.10.7 → p115client-0.0.5.10.8}/PKG-INFO

@@ -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 → p115client-0.0.5.10.8}/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 → p115client-0.0.5.10.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "p115client"
-version = "0.0.5.10.7"
+version = "0.0.5.10.8"
 description = "Python 115 webdisk client."
 authors = ["ChenyangGao <wosiwujm@gmail.com>"]
 license = "MIT"
@@ -31,8 +31,8 @@ python = "^3.12"
 aiofile = "*"
 ed2k = ">=0.0.2.1"
 http_response = ">=0.0.2.2"
-httpx = "*"
-httpx_request = ">=0.1.3"
+httpx = ">=0.28"
+httpx_request = ">=0.1.4"
 iter_collect = ">=0.0.5.1"
 multidict = "*"
 orjson = "*"