python-filewrap 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.

filewrap/__init__.py

@@ -0,0 +1,253 @@
+#!/usr/bin/env python3
+# encoding: utf-8
+
+__author__ = "ChenyangGao <https://chenyanggao.github.io>"
+__version__ = (0, 0, 1)
+__all__ = [
+    "SupportsRead", "SupportsWrite", "bio_chunk_iter", "bio_chunk_async_iter", 
+    "bio_skip_iter", "bio_skip_async_iter", "bio_skip_bytes", "bio_skip_bytes_async"
+]
+
+from asyncio import to_thread
+from functools import update_wrapper
+from inspect import isawaitable, iscoroutinefunction
+from collections.abc import AsyncIterator, Callable, Iterator
+from shutil import COPY_BUFSIZE # type: ignore
+from typing import Any, Protocol, TypeVar
+
+
+_T_co = TypeVar("_T_co", covariant=True)
+_T_contra = TypeVar("_T_contra", contravariant=True)
+
+
+class SupportsRead(Protocol[_T_co]):
+    def read(self, __length: int = ...) -> _T_co: ...
+
+
+class SupportsWrite(Protocol[_T_contra]):
+    def write(self, __s: _T_contra) -> object: ...
+
+
+def ensure_async(func, /):
+    if iscoroutinefunction(func):
+        return func
+    async def wrapper(*args, **kwds):
+        ret = to_thread(func, *args, **kwds)
+        if isawaitable(ret):
+            ret = await ret
+    return update_wrapper(wrapper, func)
+
+
+def bio_chunk_iter(
+    bio: SupportsRead[bytes], 
+    /, 
+    size: int = -1, 
+    chunksize: int = COPY_BUFSIZE, 
+    callback: None | Callable[[int], Any] = None, 
+) -> Iterator[bytes]:
+    read = bio.read
+    if not callable(callback):
+        callback = None
+    if size > 0:
+        while size:
+            readsize = min(chunksize, size)
+            chunk = read(readsize)
+            length = len(chunk)
+            if callback:
+                callback(length)
+            yield chunk
+            if length < readsize:
+                break
+            size -= readsize
+    elif size < 0:
+        while (chunk := read(chunksize)):
+            if callback:
+                callback(len(chunk))
+            yield chunk
+
+
+async def bio_chunk_async_iter(
+    bio: SupportsRead[bytes], 
+    /, 
+    size: int = -1, 
+    chunksize: int = COPY_BUFSIZE, 
+    callback: None | Callable[[int], Any] = None, 
+) -> AsyncIterator[bytes]:
+    read = ensure_async(bio.read)
+    callback = ensure_async(callback) if callable(callback) else None
+    if size > 0:
+        while size:
+            readsize = min(chunksize, size)
+            chunk = await read(readsize)
+            length = len(chunk)
+            if callback:
+                await callback(length)
+            yield chunk
+            if length < readsize:
+                break
+            size -= readsize
+    elif size < 0:
+        while (chunk := (await read(chunksize))):
+            if callback:
+                await callback(len(chunk))
+            yield chunk
+
+
+def bio_skip_iter(
+    bio: SupportsRead[bytes], 
+    /, 
+    size: int = -1, 
+    chunksize: int = COPY_BUFSIZE, 
+    callback: None | Callable[[int], Any] = None, 
+) -> Iterator[int]:
+    if size == 0:
+        return
+    if not callable(callback):
+        callback = None
+    try:
+        seek = getattr(bio, "seek")
+        curpos = seek(0, 1)
+        if size > 0:
+            length = seek(size, 1) - curpos
+        else:
+            length = seek(0, 2) - curpos
+    except Exception:
+        if chunksize <= 0:
+            chunksize = COPY_BUFSIZE
+        if hasattr(bio, "readinto"):
+            readinto = bio.readinto
+            buf = bytearray(chunksize)
+            if size > 0:
+                while size >= chunksize:
+                    length = readinto(buf)
+                    if callback:
+                        callback(length)
+                    yield length
+                    if length < chunksize:
+                        break
+                    size -= chunksize
+                else:
+                    if size:
+                        del buf[size:]
+                        length = readinto(buf)
+                        if callback:
+                            callback(length)
+                        yield length
+            else:
+                while (length := readinto(buf)):
+                    if callback:
+                        callback(length)
+                    yield length
+        else:
+            read = bio.read
+            if size > 0:
+                while size:
+                    readsize = min(chunksize, size)
+                    length = len(read(readsize))
+                    if callback:
+                        callback(length)
+                    yield length
+                    if length < readsize:
+                        break
+                    size -= readsize
+            else:
+                while (length := len(read(chunksize))):
+                    if callback:
+                        callback(length)
+                    yield length
+    else:
+        if callback:
+            callback(length)
+        yield length
+
+
+async def bio_skip_async_iter(
+    bio: SupportsRead[bytes], 
+    /, 
+    size: int = -1, 
+    chunksize: int = COPY_BUFSIZE, 
+    callback: None | Callable[[int], Any] = None, 
+) -> AsyncIterator[int]:
+    if size == 0:
+        return
+    callback = ensure_async(callback) if callable(callback) else None
+    try:
+        seek = ensure_async(getattr(bio, "seek"))
+        curpos = await seek(0, 1)
+        if size > 0:
+            length = (await seek(size, 1)) - curpos
+        else:
+            length = (await seek(0, 2)) - curpos
+    except Exception:
+        if chunksize <= 0:
+            chunksize = COPY_BUFSIZE
+        if hasattr(bio, "readinto"):
+            readinto = ensure_async(bio.readinto)
+            buf = bytearray(chunksize)
+            if size > 0:
+                while size >= chunksize:
+                    length = await readinto(buf)
+                    if callback:
+                        await callback(length)
+                    yield length
+                    if length < chunksize:
+                        break
+                    size -= chunksize
+                else:
+                    if size:
+                        del buf[size:]
+                        length = await readinto(buf)
+                        if callback:
+                            await callback(length)
+                        yield length
+            else:
+                while (length := (await readinto(buf))):
+                    if callback:
+                        await callback(length)
+                    yield length
+        else:
+            read = ensure_async(bio.read)
+            if size > 0:
+                while size:
+                    readsize = min(chunksize, size)
+                    length = len(await read(readsize))
+                    if callback:
+                        await callback(length)
+                    yield length
+                    if length < readsize:
+                        break
+                    size -= readsize
+            else:
+                while (length := len(await read(chunksize))):
+                    if callback:
+                        await callback(length)
+                    yield length
+    else:
+        if callback:
+            await callback(length)
+        yield length
+
+
+def bio_skip_bytes(
+    bio: SupportsRead[bytes], 
+    /, 
+    size: int = -1, 
+    chunksize: int = COPY_BUFSIZE, 
+    callback: None | Callable[[int], Any] = None, 
+) -> SupportsRead[bytes]:
+    for _ in bio_skip_iter(bio, size, chunksize, callback=callback):
+        pass
+    return bio
+
+
+async def bio_skip_bytes_async(
+    bio: SupportsRead[bytes], 
+    /, 
+    size: int = -1, 
+    chunksize: int = COPY_BUFSIZE, 
+    callback: None | Callable[[int], Any] = None, 
+) -> SupportsRead[bytes]:
+    async for _ in bio_skip_async_iter(bio, size, chunksize, callback=callback):
+        pass
+    return bio
+

python_filewrap-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_filewrap-0.0.1.dist-info/METADATA

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

python_filewrap-0.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+filewrap/__init__.py,sha256=v2fyorGxZAUFOtafLNuslJXNnJ2V0Fjh8DxGN44PliQ,7621
+filewrap/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_filewrap-0.0.1.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+python_filewrap-0.0.1.dist-info/METADATA,sha256=XyBEK0H_XINPYTQSyHRVgcw74Z0CBURuZr9JeeEt6UM,1329
+python_filewrap-0.0.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+python_filewrap-0.0.1.dist-info/RECORD,,

python_filewrap-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