python-filewrap 0.1__py3-none-any.whl → 0.1.1__py3-none-any.whl

filewrap/__init__.py

@@ -2,7 +2,7 @@
 # encoding: utf-8
 
 __author__ = "ChenyangGao <https://chenyanggao.github.io>"
-__version__ = (0, 1)
+__version__ = (0, 1, 1)
 __all__ = [
     "Buffer", "SupportsRead", "SupportsReadinto", 
     "SupportsWrite", "SupportsSeek", 
@@ -12,16 +12,17 @@ __all__ = [
     "bytes_iter_to_reader", "bytes_iter_to_async_reader", 
     "bytes_to_chunk_iter", "bytes_to_chunk_async_iter", 
     "bytes_ensure_part_iter", "bytes_ensure_part_async_iter", 
+    "progress_bytes_iter", "progress_bytes_async_iter", 
 ]
 
 from asyncio import to_thread, Lock as AsyncLock
 from collections.abc import Awaitable, AsyncIterable, AsyncIterator, Callable, Iterable, Iterator
 from functools import update_wrapper
-from inspect import isawaitable, iscoroutinefunction
+from inspect import isawaitable, iscoroutinefunction, isasyncgen, isgenerator
 from itertools import chain
 from shutil import COPY_BUFSIZE # type: ignore
 from threading import Lock
-from typing import runtime_checkable, Any, Protocol, TypeVar
+from typing import runtime_checkable, Any, ParamSpec, Protocol, TypeVar
 
 try:
     from collections.abc import Buffer # type: ignore
@@ -59,10 +60,10 @@ except ImportError:
     Buffer.register(memoryview)
     Buffer.register(array)
 
-
 from asynctools import async_chain, ensure_async, ensure_aiter
 
 
+Args = ParamSpec("Args")
 _T_co = TypeVar("_T_co", covariant=True)
 _T_contra = TypeVar("_T_contra", contravariant=True)
 
@@ -354,7 +355,7 @@ def bytes_iter_skip(
     /, 
     size: int = -1, 
     callback: None | Callable[[int], Any] = None, 
-) -> Iterator[memoryview | Buffer]:
+) -> Iterator[Buffer]:
     it = iter(it)
     if size == 0:
         return it
@@ -378,7 +379,7 @@ async def bytes_async_iter_skip(
     /, 
     size: int = -1, 
     callback: None | Callable[[int], Any] = None, 
-) -> AsyncIterator[memoryview | Buffer]:
+) -> AsyncIterator[Buffer]:
     it = aiter(ensure_aiter(it))
     if size == 0:
         return it
@@ -604,7 +605,7 @@ def bytes_ensure_part_iter(
     it: Iterable[Buffer], 
     /, 
     partsize: int = COPY_BUFSIZE, 
-) -> Iterator[Buffer | memoryview]:
+) -> Iterator[Buffer]:
     n = partsize
     for b in it:
         m = memoryview(b)
@@ -632,7 +633,7 @@ async def bytes_ensure_part_async_iter(
     it: Iterable[Buffer] | AsyncIterable[Buffer], 
     /, 
     partsize: int = COPY_BUFSIZE, 
-) -> AsyncIterator[Buffer | memoryview]:
+) -> AsyncIterator[Buffer]:
     n = partsize
     async for b in ensure_aiter(it):
         m = memoryview(b)
@@ -655,3 +656,71 @@ async def bytes_ensure_part_async_iter(
             else:
                 n = partsize
 
+
+def progress_bytes_iter(
+    it: Iterable[Buffer], 
+    make_progress: None | Callable[Args, Any] = None, 
+    /, 
+    *args: Args.args, 
+    **kwds: Args.kwargs, 
+) -> Iterator[Buffer]:
+    update_progress: None | Callable = None
+    close_progress: None | Callable = None
+    if callable(make_progress):
+        progress = make_progress(*args, **kwds)
+        if isgenerator(progress):
+            next(progress)
+            update_progress = progress.send
+            close_progress = progress.close
+        else:
+            update_progress = progress
+            close_progress = getattr(progress, "close", None)
+    try:
+        if callable(update_progress):
+            for chunk in it:
+                yield chunk
+                update_progress(len(chunk))
+        else:
+            for chunk in it:
+                yield chunk
+    finally:
+        if callable(close_progress):
+            close_progress()
+
+
+async def progress_bytes_async_iter(
+    it: Iterable[Buffer] | AsyncIterable[Buffer], 
+    make_progress: None | Callable[Args, Any] = None, 
+    /, 
+    *args: Args.args, 
+    **kwds: Args.kwargs, 
+) -> AsyncIterator[Buffer]:
+    update_progress: None | Callable = None
+    close_progress: None | Callable = None
+    if callable(make_progress):
+        progress = make_progress(*args, **kwds)
+        if isgenerator(progress):
+            await ensure_async(next)(progress)
+            update_progress = progress.send
+            close_progress = progress.close
+        elif isasyncgen(progress):
+            await anext(progress)
+            update_progress = progress.asend
+            close_progress = progress.aclose
+        else:
+            update_progress = progress
+            close_progress = getattr(progress, "close", None)
+    try:
+        it = ensure_aiter(it)
+        if callable(update_progress):
+            update_progress = ensure_async(update_progress)
+            async for chunk in it:
+                yield chunk
+                await update_progress(len(chunk))
+        else:
+            async for chunk in it:
+                yield chunk
+    finally:
+        if callable(close_progress):
+            await ensure_async(close_progress)()
+

{python_filewrap-0.1.dist-info → python_filewrap-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-filewrap
-Version: 0.1
+Version: 0.1.1
 Summary: Python file wrappers.
 Home-page: https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-filewrap
 License: MIT

python_filewrap-0.1.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+filewrap/__init__.py,sha256=reWapSDxv-DZT5S2r8YqWcs6-hYSuR7zNbIjesDcD00,22066
+filewrap/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_filewrap-0.1.1.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+python_filewrap-0.1.1.dist-info/METADATA,sha256=q7nHkF41UImZ2V-59k8upeUVpYacjBHXt-21oaTuUzo,1362
+python_filewrap-0.1.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+python_filewrap-0.1.1.dist-info/RECORD,,

python_filewrap-0.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-filewrap/__init__.py,sha256=LpqytTgLuqhqPmQpt6yD3LYJLmVow1_QKBx8z8hDRqk,19814
-filewrap/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-python_filewrap-0.1.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-python_filewrap-0.1.dist-info/METADATA,sha256=dnQEqPHE9x7i5QSZ-SRlr5OWFwYC1qXe8hU8hOoGcWo,1360
-python_filewrap-0.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-python_filewrap-0.1.dist-info/RECORD,,