python-filewrap 0.2.9__py3-none-any.whl → 0.3.0__py3-none-any.whl

filewrap/__init__.py

@@ -2,18 +2,19 @@
 # encoding: utf-8
 
 __author__ = "ChenyangGao <https://chenyanggao.github.io>"
-__version__ = (0, 2, 9)
+__version__ = (0, 3, 0)
 __all__ = [
     "SupportsRead", "SupportsReadinto", "SupportsWrite", "SupportsSeek", 
-    "AsyncBufferedReader", "AsyncTextIOWrapper", "buffer_length", 
-    "bio_chunk_iter", "bio_chunk_async_iter", "bio_skip_iter", "bio_skip_async_iter", 
-    "bytes_iter", "bytes_async_iter", "bytes_iter_skip", "bytes_async_iter_skip", 
-    "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", "copyfileobj", "copyfileobj_async", 
-    "bound_bytes_reader", "bound_async_bytes_reader", 
+    "AsyncBufferedReader", "AsyncTextIOWrapper", "buffer_length", "to_string_buffer", 
+    "to_bytes_buffer", "bio_chunk_iter", "bio_chunk_async_iter", "bio_skip_iter", 
+    "bio_skip_async_iter", "bytes_iter", "bytes_async_iter", "bytes_iter_skip", 
+    "bytes_async_iter_skip", "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", 
+    "copyfileobj", "copyfileobj_async", "bound_bytes_reader", "bound_async_bytes_reader", 
 ]
 
+from array import array
 from asyncio import Lock as AsyncLock
 from codecs import getdecoder, getencoder
 from collections.abc import (
@@ -120,19 +121,19 @@ class AsyncBufferedReader(BufferedReader):
 
     @cached_property
     def _flush(self, /):
-        return ensure_async(self.raw.flush, threaded=True)
+        return ensure_async(getattr(self.raw, "flush"), threaded=True)
 
     @cached_property
     def _read(self, /):
-        return ensure_async(self.raw.read, threaded=True)
+        return ensure_async(getattr(self.raw, "read"), threaded=True)
 
     @cached_property
     def _readinto(self, /):
-        return ensure_async(self.raw.readinto, threaded=True)
+        return ensure_async(getattr(self.raw, "readinto"), threaded=True)
 
     @cached_property
     def _readline(self, /):
-        return ensure_async(self.raw.readline, threaded=True)
+        return ensure_async(getattr(self.raw, "readline"), threaded=True)
 
     @cached_property
     def _seek(self, /):
@@ -262,7 +263,7 @@ class AsyncBufferedReader(BufferedReader):
             length = buffer_length(data)
             self._pos += buffer_length(prev_data) + length
             if BUFSIZE <= length:
-                buf_view[:] = memoryview(data)[-BUFSIZE:]
+                buf_view[:] = memoryview(data).cast("B")[-BUFSIZE:]
                 self._buf_pos = self._buf_stop = BUFSIZE
             else:
                 buf_pos_stop = buf_stop + length
@@ -307,7 +308,7 @@ class AsyncBufferedReader(BufferedReader):
                 else:
                     return 0
         BUFSIZE = buffer_length(buf_view)
-        buffer_view = memoryview(buffer)
+        buffer_view = memoryview(buffer).cast("B")
         buffer_view[:buf_size] = buf_view[buf_pos:buf_stop]
         buf_pos = self._buf_pos = buf_stop
         self._pos += buf_size
@@ -379,7 +380,7 @@ class AsyncBufferedReader(BufferedReader):
                 else:
                     return 0
         BUFSIZE = buffer_length(buf_view)
-        buffer_view = memoryview(buffer)
+        buffer_view = memoryview(buffer).cast("B")
         buffer_view[:buf_size] = buf_view[buf_pos:buf_stop]
         buf_pos = self._buf_pos = buf_stop
         self._pos += buf_size
@@ -470,7 +471,7 @@ class AsyncBufferedReader(BufferedReader):
         prev_data = buf_view[buf_pos:buf_stop].tobytes()
         self._pos += buffer_length(prev_data) + length
         if BUFSIZE <= length:
-            buf_view[:] = memoryview(data)[-BUFSIZE:]
+            buf_view[:] = memoryview(data).cast("B")[-BUFSIZE:]
             self._buf_pos = self._buf_stop = BUFSIZE
         else:
             buf_pos_stop = buf_stop + length
@@ -656,7 +657,7 @@ class AsyncTextIOWrapper(TextIOWrapper):
                 size -= len(text)
             return n
 
-        cache: bytes | memoryview = memoryview(data)
+        cache: bytes | memoryview = memoryview(data).cast("B")
         while size and buffer_length(data) == size:
             while cache:
                 try:
@@ -826,9 +827,19 @@ def get_bom(encoding: str, /) -> bytes:
 
 
 def buffer_length(b: Buffer, /) -> int:
-    if isinstance(b, (bytes, bytearray, memoryview)):
+    if isinstance(b, (bytes, bytearray)):
         return len(b)
-    return len(memoryview(b))
+    return memoryview(b).nbytes
+
+
+def to_string_buffer(s: str, /) -> array:
+    return array("w", s)
+
+
+def to_bytes_buffer(b: Buffer, /) -> bytes | bytearray | memoryview:
+    if isinstance(b, (bytes, bytearray)):
+        return b
+    return memoryview(b).cast("B")
 
 
 def bio_chunk_iter(
@@ -842,10 +853,10 @@ def bio_chunk_iter(
     use_readinto = False
     if callable(bio):
         read = bio
-    elif can_buffer and isinstance(bio, SupportsReadinto):
+    elif can_buffer and hasattr(bio, "readinto"):
         readinto = bio.readinto
         use_readinto = True
-    elif isinstance(bio, SupportsRead):
+    elif hasattr(bio, "read"):
         read = bio.read
     else:
         readinto = bio.readinto
@@ -915,10 +926,10 @@ async def bio_chunk_async_iter(
     use_readinto = False
     if callable(bio):
         read: Callable[[int], Awaitable[Buffer]] = ensure_async(bio, threaded=True)
-    elif can_buffer and isinstance(bio, SupportsReadinto):
+    elif can_buffer and hasattr(bio, "readinto"):
         readinto = ensure_async(bio.readinto, threaded=True)
         use_readinto = True
-    elif isinstance(bio, SupportsRead):
+    elif hasattr(bio, "read"):
         read = ensure_async(bio.read, threaded=True)
     else:
         readinto = ensure_async(bio.readinto, threaded=True)
@@ -1140,7 +1151,7 @@ def bytes_iter(
             else:
                 break
         else:
-            yield memoryview(b)[:size]
+            yield memoryview(b).cast("B")[:size]
             if callback is not None:
                 callback(size)
             break
@@ -1172,7 +1183,7 @@ async def bytes_async_iter(
             else:
                 break
         else:
-            yield memoryview(b)[:size]
+            yield memoryview(b).cast("B")[:size]
             if callback is not None:
                 await callback(size)
             break
@@ -1189,8 +1200,8 @@ def bytes_iter_skip(
         return it
     if not callable(callback):
         callback = None
-    m: memoryview
-    for m in map(memoryview, it): # type: ignore
+    for b in it:
+        m = memoryview(b).cast("B")
         l = buffer_length(m)
         if callback:
             callback(min(l, size))
@@ -1215,7 +1226,7 @@ async def bytes_async_iter_skip(
         return it
     callback = ensure_async(callback) if callable(callback) else None
     async for b in it:
-        m = memoryview(b)
+        m = memoryview(b).cast("B")
         l = buffer_length(m)
         if callback:
             await callback(min(l, size))
@@ -1291,8 +1302,9 @@ def bytes_iter_to_reader(
                 del unconsumed[:]
             try:
                 while True:
-                    if b := memoryview(getnext()):
-                        m = n + len(b)
+                    b = memoryview(getnext()).cast("B")
+                    if b_len := b.nbytes:
+                        m = n + b_len
                         if m >= bufsize:
                             delta = bufsize - n
                             buf[n:] = b[:delta]
@@ -1301,7 +1313,7 @@ def bytes_iter_to_reader(
                             return bufsize
                         else:
                             buf[n:m] = b
-                            pos += len(b)
+                            pos += b_len
                             n = m
             except StopIteration:
                 at_end = True
@@ -1460,8 +1472,9 @@ def bytes_iter_to_async_reader(
                 del unconsumed[:]
             try:
                 while True:
-                    if b := memoryview(await getnext()):
-                        m = n + len(b)
+                    b = memoryview(await getnext()).cast("B")
+                    if b_len := b.nbytes:
+                        m = n + b_len
                         if m >= bufsize:
                             delta = bufsize - n
                             buf[n:] = b[:delta]
@@ -1470,7 +1483,7 @@ def bytes_iter_to_async_reader(
                             return bufsize
                         else:
                             buf[n:m] = b
-                            pos += len(b)
+                            pos += b_len
                             n = m
             except (StopIteration, StopAsyncIteration):
                 at_end = True
@@ -1566,7 +1579,7 @@ def bytes_to_chunk_iter(
     /, 
     chunksize: int = READ_BUFSIZE, 
 ) -> Iterator[memoryview]:
-    m = memoryview(b)
+    m = memoryview(b).cast("B")
     for i in range(0, buffer_length(m), chunksize):
         yield m[i:i+chunksize]
 
@@ -1576,7 +1589,7 @@ async def bytes_to_chunk_async_iter(
     /, 
     chunksize: int = READ_BUFSIZE, 
 ) -> AsyncIterator[memoryview]:
-    m = memoryview(b)
+    m = memoryview(b).cast("B")
     for i in range(0, buffer_length(m), chunksize):
         yield m[i:i+chunksize]
 
@@ -1588,7 +1601,7 @@ def bytes_ensure_part_iter(
 ) -> Iterator[Buffer]:
     n = partsize
     for b in it:
-        m = memoryview(b)
+        m = memoryview(b).cast("B")
         l = buffer_length(m)
         if l <= n:
             yield b
@@ -1616,7 +1629,7 @@ async def bytes_ensure_part_async_iter(
 ) -> AsyncIterator[Buffer]:
     n = partsize
     async for b in ensure_aiter(it):
-        m = memoryview(b)
+        m = memoryview(b).cast("B")
         l = buffer_length(m)
         if l <= n:
             yield b
@@ -1730,7 +1743,7 @@ def copyfileobj(
     fsrc_readinto = getattr(fsrc, "readinto", None)
     if callable(fsrc_readinto):
         buf = bytearray(chunksize)
-        view = memoryview(buf)
+        view = memoryview(buf).cast("B")
         while size := fsrc_readinto(buf):
             fdst_write(view[:size])
     elif callable(fsrc_read):
@@ -1757,7 +1770,7 @@ async def copyfileobj_async(
     if callable(fsrc_readinto):
         fsrc_readinto = ensure_async(fsrc_readinto, threaded=threaded)
         buf = bytearray(chunksize)
-        view = memoryview(buf)
+        view = memoryview(buf).cast("B")
         while size := await fsrc_readinto(buf):
             await fdst_write(view[:size])
     elif callable(fsrc_read):
@@ -1798,7 +1811,7 @@ def bound_bytes_reader(
             if f_readinto is None:
                 raise NotImplementedError("readinto")
             if size > 0:
-                n = f_readinto(memoryview(buffer)[:size])
+                n = f_readinto(memoryview(buffer).cast("B")[:size])
                 size -= n
                 return n
             return 0
@@ -1833,7 +1846,7 @@ def bound_async_bytes_reader(
             if f_readinto is None:
                 raise NotImplementedError("readinto")
             if size > 0:
-                n = await f_readinto(memoryview(buffer)[:size])
+                n = await f_readinto(memoryview(buffer).cast("B")[:size])
                 size -= n
                 return n
             return 0

{python_filewrap-0.2.9.dist-info → python_filewrap-0.3.0.dist-info}/METADATA

@@ -1,9 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-filewrap
-Version: 0.2.9
+Version: 0.3.0
 Summary: Python file wrappers.
-Home-page: https://github.com/ChenyangGao/python-modules/tree/main/python-filewrap
 License: MIT
+License-File: LICENSE
 Keywords: file,wrapper
 Author: ChenyangGao
 Author-email: wosiwujm@gmail.com
@@ -16,12 +16,14 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 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-asynctools (>=0.1.3)
 Requires-Dist: python-property (>=0.0.3)
+Project-URL: Homepage, https://github.com/ChenyangGao/python-modules/tree/main/python-filewrap
 Project-URL: Repository, https://github.com/ChenyangGao/python-modules/tree/main/python-filewrap
 Description-Content-Type: text/markdown
 

python_filewrap-0.3.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+filewrap/__init__.py,sha256=39yU6QyabFchtrykF_4uiL4y4Ytm2MzeuCd7CCUuhH8,61018
+filewrap/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_filewrap-0.3.0.dist-info/METADATA,sha256=X36-8X7woDyEu1LJHgjuDSe99qPm2Suf0Ta7Itl3HIQ,1417
+python_filewrap-0.3.0.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
+python_filewrap-0.3.0.dist-info/licenses/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
+python_filewrap-0.3.0.dist-info/RECORD,,

{python_filewrap-0.2.9.dist-info → python_filewrap-0.3.0.dist-info}/WHEEL

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

python_filewrap-0.2.9.dist-info/LICENSE

@@ -1,21 +0,0 @@
-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.2.9.dist-info/RECORD

@@ -1,7 +0,0 @@
-LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-filewrap/__init__.py,sha256=5NZu2cdLJ9n12S9baxgvkfItnMDeHvSgfNr7kqXOqaw,60483
-filewrap/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-python_filewrap-0.2.9.dist-info/LICENSE,sha256=o5242_N2TgDsWwFhPn7yr8YJNF7XsJM5NxUMtcT97bc,1100
-python_filewrap-0.2.9.dist-info/METADATA,sha256=NsWZxGEw5vJADKKNJkGL-XSQEXEea3BxUCMQYC4Grfg,1332
-python_filewrap-0.2.9.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-python_filewrap-0.2.9.dist-info/RECORD,,