httpx_request 0.0.1__tar.gz

httpx_request-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ChenyangGao <https://github.com/ChenyangGao>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

httpx_request-0.0.1/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.1
+Name: httpx_request
+Version: 0.0.1
+Summary: httpx request extension.
+Home-page: https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/httpx_request
+License: MIT
+Keywords: httpx,request
+Author: ChenyangGao
+Author-email: wosiwujm@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: httpx
+Requires-Dist: python-argtools
+Project-URL: Repository, https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/httpx_request
+Description-Content-Type: text/markdown
+
+# httpx request extension.
+
+## Installation
+
+You can install via [pypi](https://pypi.org/project/httpx_request/)
+
+```console
+pip install -U httpx_request
+```
+
+## Usage
+
+```python
+from httpx_request import request
+```
+

httpx_request-0.0.1/httpx_request/__init__.py

@@ -0,0 +1,181 @@
+#!/usr/bin/env python3
+# coding: utf-8
+
+__author__ = "ChenyangGao <https://chenyanggao.github.io>"
+__version__ = (0, 0, 1)
+__all__ = ["request"]
+
+from asyncio import get_running_loop, run, run_coroutine_threadsafe
+from collections.abc import Callable
+from json import loads
+
+from argtools import argcount
+from httpx._types import AuthTypes, SyncByteStream, URLTypes
+from httpx._client import AsyncClient, Client, Response, UseClientDefault, USE_CLIENT_DEFAULT
+
+if "__del__" not in Client.__dict__:
+    setattr(Client, "__del__", Client.close)
+
+if "__del__" not in AsyncClient.__dict__:
+    def __del__(self, /):
+        try:
+            try:
+                loop = get_running_loop()
+            except RuntimeError:
+                run(self.aclose())
+            else:
+                run_coroutine_threadsafe(self.aclose(), loop)
+        except Exception:
+            pass
+    setattr(Client, "__del__", __del__)
+
+if "__del__" not in Response.__dict__:
+    def __del__(self, /):
+        if self.is_closed:
+            return
+        if isinstance(self.stream, SyncByteStream):
+            self.close()
+        else:
+            try:
+                try:
+                    loop = get_running_loop()
+                except RuntimeError:
+                    run(self.aclose())
+                else:
+                    run_coroutine_threadsafe(self.aclose(), loop)
+            except Exception:
+                pass
+    setattr(Response, "__del__", __del__)
+
+
+def request_sync(
+    url: URLTypes, 
+    method: str = "GET", 
+    session: None | Client = None, 
+    auth: None | AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT, 
+    follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT, 
+    stream: bool = True, 
+    raise_for_status: bool = False, 
+    parse: None | bool | Callable = None, 
+    **request_kwargs, 
+):
+    if session is None:
+        with Client() as session:
+            return request_sync(
+                url, 
+                method, 
+                session=session, 
+                auth=auth, 
+                follow_redirects=follow_redirects, 
+                stream=stream, 
+                **request_kwargs, 
+            )
+    request = session.build_request(
+        method=method, 
+        url=url, 
+        **request_kwargs, 
+    )
+    resp = session.send(
+        request=request,
+        auth=auth,
+        follow_redirects=follow_redirects,
+        stream=stream,
+    )
+    if raise_for_status:
+        resp.raise_for_status()
+    if parse is None:
+        return resp
+    elif parse is False:
+        return resp.read()
+    elif parse is True:
+        resp.read()
+        content_type = resp.headers.get("Content-Type", "")
+        if content_type == "application/json":
+            return resp.json()
+        elif content_type.startswith("application/json;"):
+            return loads(resp.text)
+        elif content_type.startswith("text/"):
+            return resp.text
+        return resp.content
+    else:
+        ac = argcount(parse)
+        if ac == 1:
+            return parse(resp)
+        else:
+            return parse(resp, resp.read())
+
+
+async def request_async(
+    url: URLTypes, 
+    method: str = "GET", 
+    session: None | AsyncClient = None, 
+    auth: None | AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT, 
+    follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT, 
+    stream: bool = True, 
+    raise_for_status: bool = False, 
+    parse: None | bool | Callable = None, 
+    **request_kwargs, 
+):
+    if session is None:
+        async with AsyncClient() as session:
+            return await request_async(
+                url, 
+                method, 
+                session=session, 
+                auth=auth, 
+                follow_redirects=follow_redirects, 
+                stream=stream, 
+                **request_kwargs, 
+            )
+    request = session.build_request(
+        method=method, 
+        url=url, 
+        **request_kwargs, 
+    )
+    resp = await session.send(
+        request=request,
+        auth=auth,
+        follow_redirects=follow_redirects,
+        stream=stream,
+    )
+    if raise_for_status:
+        resp.raise_for_status()
+    if parse is None:
+        return resp
+    elif parse is False:
+        return await resp.aread()
+    elif parse is True:
+        await resp.aread()
+        content_type = resp.headers.get("Content-Type", "")
+        if content_type == "application/json":
+            return resp.json()
+        elif content_type.startswith("application/json;"):
+            return loads(resp.text)
+        elif content_type.startswith("text/"):
+            return resp.text
+        return resp.content
+    else:
+        ac = argcount(parse)
+        if ac == 1:
+            return parse(resp)
+        else:
+            return parse(resp, await resp.aread())
+
+
+def request(
+    url: URLTypes, 
+    method: str = "GET", 
+    session: None | Client | AsyncClient = None, 
+    async_: bool = False, 
+    **request_kwargs, 
+):
+    if session is not None:
+        async_ = isinstance(session, AsyncClient)
+    request = request_async if async_ else request_sync
+    return request( # type: ignore
+        url, 
+        method, 
+        session=session, 
+        **request_kwargs, 
+    )
+

httpx_request-0.0.1/pyproject.toml

@@ -0,0 +1,38 @@
+[tool.poetry]
+name = "httpx_request"
+version = "0.0.1"
+description = "httpx request extension."
+authors = ["ChenyangGao <wosiwujm@gmail.com>"]
+license = "MIT"
+readme = "readme.md"
+homepage = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/httpx_request"
+repository = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/httpx_request"
+keywords = ["httpx", "request"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Development Status :: 5 - Production/Stable",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3 :: Only",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+include = [
+    "LICENSE",
+]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+httpx = "*"
+python-argtools = "*"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[[tool.poetry.packages]]
+include = "httpx_request"

httpx_request-0.0.1/readme.md

@@ -0,0 +1,15 @@
+# httpx request extension.
+
+## Installation
+
+You can install via [pypi](https://pypi.org/project/httpx_request/)
+
+```console
+pip install -U httpx_request
+```
+
+## Usage
+
+```python
+from httpx_request import request
+```