python-http_request 0.0.1__py3-none-any.whl

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.

http_request/__init__.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+# encoding: utf-8
+
+__author__ = "ChenyangGao <https://chenyanggao.github.io>"
+__version__ = (0, 0, 1)
+__all__ = ["encode_multipart_data", "encode_multipart_data_async"]
+
+from itertools import chain
+from collections.abc import AsyncIterable, AsyncIterator, ItemsView, Iterable, Iterator, Mapping
+from typing import Any
+from urllib.parse import quote
+from uuid import uuid4
+
+from asynctools import ensure_aiter, async_chain
+from filewrap import bio_chunk_iter, bio_chunk_async_iter, SupportsRead
+from integer_tool import int_to_bytes
+
+
+def ensure_bytes(s, /) -> bytes | bytearray | memoryview:
+    if isinstance(s, (bytes, bytearray, memoryview)):
+        return s
+    if isinstance(s, int):
+        return int_to_bytes(s)
+    elif isinstance(s, str):
+        return bytes(s, "utf-8")
+    try:
+        return bytes(s)
+    except TypeError:
+        return bytes(str(s), "utf-8")
+
+
+def encode_multipart_data(
+    data: Mapping[str, Any], 
+    files: Mapping[str, bytes | bytearray | memoryview | SupportsRead[bytes] | Iterable[bytes]], 
+    boundary: None | str = None, 
+) -> tuple[dict, Iterator[bytes]]:
+    if not boundary:
+        boundary = uuid4().bytes.hex()
+    headers = {"Content-Type": f"multipart/form-data; boundary={boundary}"}
+
+    def encode_data(data) -> Iterator[bytes]:
+        if isinstance(data, Mapping):
+            data = ItemsView(data)
+        for name, value in data:
+            yield boundary_line
+            yield b'Content-Disposition: form-data; name="%s"\r\n\r\n' % bytes(quote(name), "ascii")
+            yield ensure_bytes(value)
+            yield b"\r\n"
+
+    def encode_files(files) -> Iterator[bytes]:
+        if isinstance(files, Mapping):
+            files = ItemsView(files)
+        for name, file in files:
+            yield boundary_line
+            yield b'Content-Disposition: form-data; name="%s"\r\nContent-Type: application/octet-stream\r\n\r\n' % bytes(quote(name), "ascii")
+            if isinstance(file, (bytes, bytearray, memoryview)):
+                yield file
+            elif hasattr(file, "read"):
+                yield from bio_chunk_iter(file)
+            else:
+                yield from file
+            yield b"\r\n"
+
+    boundary_line = b"--%s\r\n" % boundary.encode("utf-8")
+    return headers, chain(encode_data(data), encode_files(files), (b'--%s--\r\n' % boundary.encode("ascii"),))
+
+
+def encode_multipart_data_async(
+    data: Mapping[str, Any], 
+    files: Mapping[str, bytes | bytearray | memoryview | SupportsRead[bytes] | Iterable[bytes] | AsyncIterable[bytes]], 
+    boundary: None | str = None, 
+) -> tuple[dict, AsyncIterator[bytes]]:
+    if not boundary:
+        boundary = uuid4().bytes.hex()
+    headers = {"Content-Type": f"multipart/form-data; boundary={boundary}"}
+
+    async def encode_data(data) -> AsyncIterator[bytes]:
+        if isinstance(data, Mapping):
+            data = ItemsView(data)
+        for name, value in data:
+            yield boundary_line
+            yield b'Content-Disposition: form-data; name="%s"\r\n\r\n' % bytes(quote(name), "ascii")
+            yield ensure_bytes(value)
+            yield b"\r\n"
+
+    async def encode_files(files) -> AsyncIterator[bytes]:
+        if isinstance(files, Mapping):
+            files = ItemsView(files)
+        for name, file in files:
+            yield boundary_line
+            yield b'Content-Disposition: form-data; name="%s"\r\nContent-Type: application/octet-stream\r\n\r\n' % bytes(quote(name), "ascii")
+            if isinstance(file, (bytes, bytearray, memoryview)):
+                yield file
+            elif hasattr(file, "read"):
+                async for b in bio_chunk_async_iter(file):
+                    yield b
+            else:
+                async for b in ensure_aiter(file):
+                    yield b
+            yield b"\r\n"
+
+    boundary_line = b"--%s\r\n" % boundary.encode("utf-8")
+    return headers, async_chain(encode_data(data), encode_files(files), (b'--%s--\r\n' % boundary.encode("ascii"),))
+

python_http_request-0.0.1.dist-info/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.

python_http_request-0.0.1.dist-info/METADATA

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

python_http_request-0.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+http_request/__init__.py,sha256=XFn8Ooa6VTEf90lYj2sijGgv1tywDxQ8bJoVH24Gv_M,3992
+http_request/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_http_request-0.0.1.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+python_http_request-0.0.1.dist-info/METADATA,sha256=l8J6UAwNpZ26OQraM82s0uHpCJc15piOxne5dLjvXz8,1457
+python_http_request-0.0.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+python_http_request-0.0.1.dist-info/RECORD,,

python_http_request-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.8.1
+Root-Is-Purelib: true
+Tag: py3-none-any