urllib3_request 0.0.1__tar.gz

urllib3_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.

urllib3_request-0.0.1/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.1
+Name: urllib3_request
+Version: 0.0.1
+Summary: urllib3 request extension.
+Home-page: https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/urllib3_request
+License: MIT
+Keywords: urllib3,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: python-argtools
+Requires-Dist: urllib3
+Project-URL: Repository, https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/urllib3_request
+Description-Content-Type: text/markdown
+
+# urllib3 request extension.
+
+## Installation
+
+You can install via [pypi](https://pypi.org/project/urllib3_request/)
+
+```console
+pip install -U urllib3_request
+```
+
+## Usage
+
+```python
+from urllib3_request import request
+```
+

urllib3_request-0.0.1/pyproject.toml

@@ -0,0 +1,38 @@
+[tool.poetry]
+name = "urllib3_request"
+version = "0.0.1"
+description = "urllib3 request extension."
+authors = ["ChenyangGao <wosiwujm@gmail.com>"]
+license = "MIT"
+readme = "readme.md"
+homepage = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/urllib3_request"
+repository = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/urllib3_request"
+keywords = ["urllib3", "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"
+urllib3 = "*"
+python-argtools = "*"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[[tool.poetry.packages]]
+include = "urllib3_request"

urllib3_request-0.0.1/readme.md

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

urllib3_request-0.0.1/urllib3_request/__init__.py

@@ -0,0 +1,97 @@
+#!/usr/bin/env python3
+# coding: utf-8
+
+__author__ = "ChenyangGao <https://chenyanggao.github.io>"
+__version__ = (0, 0, 1)
+__all__ = ["request"]
+
+from collections.abc import Callable, Iterable, Mapping, Sequence
+from json import loads
+from re import compile as re_compile
+from typing import Any
+from urllib.error import HTTPError
+from urllib.parse import urlencode, urlparse, urlunparse
+
+from argtools import argcount
+from urllib3 import _DEFAULT_POOL # type: ignore
+from urllib3 import Retry, Timeout
+from urllib3.poolmanager import PoolManager
+
+
+if "__del__" not in PoolManager.__dict__:
+    setattr(PoolManager, "__del__", PoolManager.clear)
+
+CRE_search_charset = re_compile(r"\bcharset=(?P<charset>[^ ;]+)").search
+
+
+def get_charset(content_type: str, default="utf-8") -> str:
+    match = CRE_search_charset(content_type)
+    if match is None:
+        return "utf-8"
+    return match["charset"]
+
+
+def request(
+    url: str, 
+    method: str = "GET", 
+    parse: None | bool | Callable = None, 
+    params: None | str | Mapping | Sequence[tuple[Any, Any]] = None, 
+    data: None | bytes | str | Mapping | Sequence[tuple[Any, Any]] | Iterable[bytes] = None, 
+    timeout: None | float | Timeout = Timeout(connect=5, read=60), 
+    raise_for_status: bool = True, 
+    pool: PoolManager = _DEFAULT_POOL, 
+    retries: None | int | Retry = Retry(connect=5, read=5), 
+    stream: bool = True, 
+    **request_kwargs, 
+):
+    if params:
+        if not isinstance(params, str):
+            params = urlencode(params)
+        if params:
+            urlp = urlparse(url)
+            if urlp.query:
+                query = urlp.query + "&" + params
+            else:
+                query = params
+            url = urlunparse(urlp._replace(query=query))
+    request_kwargs["preload_content"] = not stream
+    if retries:
+        if isinstance(retries, int):
+            retries = Retry(retries)
+        request_kwargs["retries"] = retries
+    resp = pool.request(
+        method=method, 
+        url=url, 
+        timeout=timeout, 
+        **request_kwargs, 
+    )
+    if data is None:
+        pass
+    elif isinstance(data, (Mapping, Sequence)):
+        request_kwargs["fields"] = data
+    elif isinstance(data, (bytes, Iterable)):
+        request_kwargs["body"] = data
+    if raise_for_status and resp.status >= 400:
+        raise HTTPError(resp.url, resp.status, resp.reason, resp.headers, resp)
+    if parse is None:
+        return resp
+    with resp:
+        if isinstance(parse, bool):
+            content = resp.read()
+            if parse:
+                content_type = resp.headers.get("Content-Type") or ""
+                if content_type == "application/json":
+                    return resp.json()
+                elif content_type.startswith("application/json;"):
+                    return loads(content.decode(get_charset(content_type)))
+                elif content_type.startswith("text/"):
+                    return content.decode(get_charset(content_type))
+            return content
+        else:
+            ac = argcount(parse)
+            with resp:
+                if ac == 1:
+                    return parse(resp)
+                else:
+                    return parse(resp, resp.read())
+