miniopy-async 1.23.0__tar.gz → 1.23.2__tar.gz

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: miniopy-async
-Version: 1.23.0
+Version: 1.23.2
 Summary: Asynchronous MinIO Client SDK for Python
 Home-page: https://github.com/hlf20010508/miniopy-async
 License: Apache-2.0
@@ -18,7 +18,6 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: aiofile (>=3.9.0,<4.0.0)
 Requires-Dist: aiohttp (>=3.11.14,<4.0.0)
 Requires-Dist: aiohttp-retry (>=2.9.1,<3.0.0)
 Requires-Dist: argon2-cffi (>=23.1.0,<24.0.0)

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/__init__.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage,
 # (C) 2015, 2016, 2017 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 # type: ignore[reportUnusedImport]
 
 """
@@ -42,7 +36,7 @@ miniopy-async - Asynchronous MinIO Client SDK for Python
 
 __title__ = "miniopy-async"
 __author__ = "L-ING"
-__version__ = "1.23.0"
+__version__ = "1.23.2"
 __license__ = "Apache 2.0"
 __copyright__ = "(C) 2022 L-ING <hlf01@icloud.com>"
 

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/api.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2015, 2016, 2017 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2015, 2016, 2017 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 # pylint: disable=too-many-lines,disable=too-many-branches,too-many-statements
 # pylint: disable=too-many-arguments
 
@@ -42,7 +36,6 @@ from urllib.parse import urlunsplit
 from xml.etree import ElementTree as ET
 
 import certifi
-from aiofile import FileIOWrapperBase, async_open
 from aiohttp import ClientResponse, ClientSession, ClientTimeout, TCPConnector
 from aiohttp.typedefs import LooseHeaders
 from aiohttp_retry import ExponentialRetry, RetryClient
@@ -79,6 +72,7 @@ from .helpers import (
     DictType,
     ObjectWriteResult,
     ProgressType,
+    Substream,
     check_bucket_name,
     check_object_name,
     check_sse,
@@ -90,7 +84,6 @@ from .helpers import (
     makedirs,
     md5sum_hash,
     queryencode,
-    read_part_data,
     sha256_hash,
 )
 from .legalhold import LegalHold
@@ -272,7 +265,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         self,
         host: str,
         headers: LooseHeaders | DictType | None,
-        body: bytes | BytesIO | None,
+        body: bytes | BytesIO | Substream | None,
         creds: Credentials | None,
     ) -> tuple[dict[str, str], datetime]:
         """Build headers with given parameters."""
@@ -283,11 +276,13 @@ class Minio:  # pylint: disable=too-many-public-methods
         sha256 = None
         md5sum = None
 
-        if isinstance(body, BytesIO):
-            body = body.getvalue()
-
         if body:
-            headers["Content-Length"] = str(len(body))
+            if isinstance(body, BytesIO):
+                headers["Content-Length"] = str(body.getbuffer().nbytes)
+            elif isinstance(body, Substream):
+                headers["Content-Length"] = str(body.size)
+            else:
+                headers["Content-Length"] = str(len(body))
         if creds:
             if self._base_url.is_https:
                 sha256 = "UNSIGNED-PAYLOAD"
@@ -312,7 +307,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         region: str,
         bucket_name: str | None = None,
         object_name: str | None = None,
-        body: bytes | BytesIO | None = None,
+        body: bytes | BytesIO | Substream | None = None,
         headers: LooseHeaders | DictType | None = None,
         query_params: DictType | None = None,
         no_body_trace: bool = False,
@@ -503,7 +498,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         method: str,
         bucket_name: str | None = None,
         object_name: str | None = None,
-        body: bytes | BytesIO | None = None,
+        body: bytes | BytesIO | Substream | None = None,
         headers: DictType | None = None,
         query_params: DictType | None = None,
         no_body_trace: bool = False,
@@ -1489,7 +1484,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         """
 
         file_size = os.stat(file_path).st_size
-        async with async_open(file_path, "rb") as file_data:
+        with open(file_path, "rb") as file_data:
             return await self.put_object(
                 bucket_name,
                 object_name,
@@ -1609,9 +1604,9 @@ class Minio:  # pylint: disable=too-many-public-methods
                         object_name=object_name, total_length=length
                     )
 
-                async with async_open(tmp_file_path, "wb") as tmp_file:
+                with open(tmp_file_path, "wb") as tmp_file:
                     async for data in response.content.iter_chunked(n=1024 * 1024):
-                        size = await tmp_file.write(data)
+                        size = tmp_file.write(data)
                         if progress:
                             await progress.update(size)
 
@@ -2305,7 +2300,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         self,
         bucket_name: str,
         object_name: str,
-        data: bytes,
+        data: Substream,
         headers: DictType | None,
         query_params: DictType | None = None,
     ) -> ObjectWriteResult:
@@ -2314,7 +2309,7 @@ class Minio:  # pylint: disable=too-many-public-methods
             "PUT",
             bucket_name,
             object_name,
-            body=BytesIO(data),
+            body=data,
             headers=headers,
             query_params=query_params,
             no_body_trace=True,
@@ -2331,7 +2326,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         self,
         bucket_name: str,
         object_name: str,
-        data: bytes,
+        data: Substream,
         headers: DictType | None,
         upload_id: str,
         part_number: int,
@@ -2365,7 +2360,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         self,
         bucket_name: str,
         object_name: str,
-        data: BinaryIO | FileIOWrapperBase,
+        data: BinaryIO,
         length: int,
         content_type: str = "application/octet-stream",
         metadata: DictType | None = None,
@@ -2509,7 +2504,6 @@ class Minio:  # pylint: disable=too-many-public-methods
         object_size = length
         uploaded_size = 0
         part_number = 0
-        one_byte = b""
         stop = False
         upload_id = None
         parts = []
@@ -2523,31 +2517,26 @@ class Minio:  # pylint: disable=too-many-public-methods
                     if part_number == part_count:
                         part_size = object_size - uploaded_size
                         stop = True
-                    part_data = await read_part_data(
-                        data,
-                        part_size,
-                        progress=progress,
-                    )
-                    if len(part_data) != part_size:
+                    part_data = Substream(data, uploaded_size, part_size)
+                    if part_data.size != part_size:
                         raise IOError(
                             f"stream having not enough data;"
                             f"expected: {part_size}, "
-                            f"got: {len(part_data)} bytes"
+                            f"got: {part_data.size} bytes"
                         )
                 else:
-                    part_data = await read_part_data(
-                        data, part_size + 1, one_byte, progress=progress
-                    )
-                    # If part_data_size is less or equal to part_size,
-                    # then we have reached last part.
-                    if len(part_data) <= part_size:
+                    part_data = Substream(data, uploaded_size, part_size)
+                    if part_data.size == 0:
+                        break
+                    if part_data.size < part_size:
                         part_count = part_number
                         stop = True
-                    else:
-                        one_byte = part_data[-1:]
-                        part_data = part_data[:-1]
+                        part_size = part_data.size
+
+                if progress:
+                    await progress.update(part_size)
 
-                uploaded_size += len(part_data)
+                uploaded_size += part_size
 
                 if part_count == 1:
                     return await self._put_object(
@@ -4166,6 +4155,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         self,
         bucket_name: str,
         object_list: Iterable[SnowballObject],
+        object_name: str | None = None,
         metadata: DictType | None = None,
         sse: Sse | None = None,
         tags: Tags | None = None,
@@ -4182,6 +4172,8 @@ class Minio:  # pylint: disable=too-many-public-methods
         :param str bucket_name: Name of the bucket.
         :param Iterable[SnowballObject] object_list: An iterable containing
             :class:`SnowballObject` object.
+        :param str object_name: Optional name for the uploaded TAR archive.
+            If not provided, a random name in the format `snowball.<random>.tar` will be used.
         :param DictType | None metadata: Any additional metadata to be uploaded along
             with your PUT request.
         :param Sse | None sse: Server-side encryption.
@@ -4227,7 +4219,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         """
         check_bucket_name(bucket_name, s3_check=self._base_url.is_aws_host)
 
-        object_name = f"snowball.{random()}.tar"
+        object_name = object_name or f"snowball.{random()}.tar"
 
         # turn list like objects into an iterator.
         object_list = itertools.chain(object_list)
@@ -4256,7 +4248,7 @@ class Minio:  # pylint: disable=too-many-public-methods
         else:
             length = os.stat(name).st_size
 
-        part_size = 0
+        part_size = 0 if length < MIN_PART_SIZE else length
 
         if name:
             return await self.fput_object(

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/commonconfig.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 """Common request/response configuration of S3 APIs."""
 # pylint: disable=invalid-name
 

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/credentials/__init__.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage,
 # (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 # type: ignore[reportUnusedImport]
 
 """Credential module."""

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/credentials/credentials.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage,
 # (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/credentials/providers.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage,
 # (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 """Credential providers."""
 
 from __future__ import annotations
@@ -40,7 +34,6 @@ from urllib.parse import urlencode, urlsplit, urlunsplit
 from xml.etree import ElementTree as ET
 
 import certifi
-from aiofile import async_open
 from aiohttp import ClientResponse, ClientSession, TCPConnector
 from aiohttp.typedefs import LooseHeaders
 from aiohttp_retry import ExponentialRetry, RetryClient
@@ -339,8 +332,8 @@ class MinioClientConfigProvider(Provider):
     async def retrieve(self) -> Credentials:
         """Retrieve credential value from MinIO client configuration file."""
         try:
-            async with async_open(self._filename, encoding="utf-8") as conf_file:
-                config = json.loads(await conf_file.read())
+            with open(self._filename, encoding="utf-8") as conf_file:
+                config = json.loads(conf_file.read())
             aliases = config.get("hosts") or config.get("aliases")
             if not aliases:
                 raise ValueError(
@@ -374,8 +367,8 @@ def _check_loopback_host(url: str):
 async def _get_jwt_token(token_file: str) -> dict[str, str]:
     """Read and return content of token file."""
     try:
-        async with async_open(token_file, encoding="utf-8") as file:
-            return {"access_token": await file.read(), "expires_in": "0"}
+        with open(token_file, encoding="utf-8") as file:
+            return {"access_token": file.read(), "expires_in": "0"}
     except (IOError, OSError) as exc:
         raise ValueError(f"error in reading file {token_file}") from exc
 
@@ -481,8 +474,8 @@ class IamAwsProvider(Provider):
             token = self._token
             if self._token_file:
                 url = self._full_uri
-                async with async_open(self._token_file, encoding="utf-8") as file:
-                    token = await file.read()
+                with open(self._token_file, encoding="utf-8") as file:
+                    token = file.read()
             else:
                 if not url:
                     url = self._full_uri

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/datatypes.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 """
 Response of ListBuckets, ListObjects, ListObjectsV2 and ListObjectVersions API.
 """

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/deleteobjects.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/error.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
 # (C) 2015-2019 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 # pylint: disable=too-many-lines
 
 """This module provides custom exception classes for MinIO library and API specific errors."""
@@ -176,3 +170,10 @@ class MinioAdminException(Exception):
 
     def __reduce__(self):
         return type(self), (self._code, self._body)
+
+
+class UnreachableError(MinioException):
+    """Raised when unreachable code reached."""
+
+    def __init__(self):
+        super().__init__("unreachable code reached, please report this issue.")

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/helpers.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2015, 2016, 2017 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2015, 2016, 2017 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,18 +14,14 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 """Helper functions."""
 
 from __future__ import absolute_import, annotations, division, unicode_literals
 
-import asyncio
 import base64
 import errno
 import hashlib
+import io
 import math
 import os
 import platform
@@ -36,9 +30,10 @@ import urllib.parse
 from datetime import datetime
 from typing import BinaryIO, Dict, List, Protocol, Tuple, Union
 
-from aiofile import FileIOWrapperBase
 from aiohttp.typedefs import LooseHeaders
 
+from miniopy_async.error import UnreachableError
+
 from . import __title__, __version__
 from .sse import Sse, SseCustomerKey
 from .time import to_iso8601utc
@@ -214,29 +209,6 @@ class ProgressType(Protocol):
         """Set current progress length."""
 
 
-async def read_part_data(
-    stream: BinaryIO | FileIOWrapperBase,
-    size: int,
-    part_data: bytes = b"",
-    progress: ProgressType | None = None,
-) -> bytes:
-    """Read part data of given size from stream."""
-    size -= len(part_data)
-    while size:
-        data = stream.read(size)
-        if asyncio.iscoroutine(data):
-            data = await data
-        if not data:
-            break  # EOF reached
-        if not isinstance(data, bytes):
-            raise ValueError("read() must return 'bytes' object")
-        part_data += data
-        size -= len(data)
-        if progress:
-            await progress.update(len(data))
-    return part_data
-
-
 def makedirs(path: str):
     """Wrapper of os.makedirs() ignores errno.EEXIST."""
     try:
@@ -335,7 +307,7 @@ def check_sse(sse: Sse | None):
         raise ValueError("Sse type is required")
 
 
-def md5sum_hash(data: str | bytes | None) -> str | None:
+def md5sum_hash(data: str | bytes | BinaryIO | Substream | None) -> str | None:
     """Compute MD5 of data and return hash as Base64 encoded value."""
     if data is None:
         return None
@@ -346,19 +318,53 @@ def md5sum_hash(data: str | bytes | None) -> str | None:
         "md5",
         usedforsecurity=False,
     )
-    hasher.update(data.encode() if isinstance(data, str) else data)
+    if isinstance(data, (str, bytes)):
+        hasher.update(data.encode() if isinstance(data, str) else data)
+    elif isinstance(data, (io.BytesIO, Substream)) and data.readable():
+        pos = data.tell()
+        data.seek(0)
+
+        chunk_size = 8192
+        while True:
+            chunk = data.read(chunk_size)
+            if not chunk:
+                break
+            hasher.update(chunk)
+
+        data.seek(pos)
+    else:
+        raise TypeError(
+            "data must be str, bytes, or BinaryIO type",
+        )
+
     md5sum = base64.b64encode(hasher.digest())
-    return md5sum.decode() if isinstance(md5sum, bytes) else md5sum
+    return md5sum.decode()
 
 
-def sha256_hash(data: str | bytes | None) -> str:
+def sha256_hash(data: str | bytes | BinaryIO | Substream | None) -> str:
     """Compute SHA-256 of data and return hash as hex encoded value."""
     data = data or b""
     hasher = hashlib.sha256()
-    hasher.update(data.encode() if isinstance(data, str) else data)
+    if isinstance(data, (str, bytes)):
+        hasher.update(data.encode() if isinstance(data, str) else data)
+    elif isinstance(data, (io.BytesIO, Substream)) and data.readable():
+        pos = data.tell()
+        data.seek(0)
+
+        chunk_size = 8192
+        while True:
+            chunk = data.read(chunk_size)
+            if not chunk:
+                break
+            hasher.update(chunk)
+
+        data.seek(pos)
+    else:
+        raise TypeError(
+            "data must be str, bytes, or BinaryIO type",
+        )
+
     sha256sum = hasher.hexdigest()
-    if isinstance(sha256sum, bytes):
-        return sha256sum.decode()
     return sha256sum
 
 
@@ -850,3 +856,126 @@ class ObjectWriteResult:
     def location(self) -> str | None:
         """Get location."""
         return self._location
+
+
+class Substream(io.IOBase):
+    def __init__(self, base: BinaryIO, offset: int, part_size: int):
+        if not (hasattr(base, "read") and hasattr(base, "seek")):
+            raise TypeError("Base object must support read() and seek()")
+
+        self._base = base
+        self._start = offset
+        self._size = self._get_size(part_size)
+        self._pos = 0
+        self._closed = False
+
+    def _get_size(self, part_size: int) -> int:
+        """Get size of the substream using bisection."""
+        head = self._start
+        tail = self._start + part_size - 1
+
+        self._base.seek(tail)
+        data = self._base.read(1)
+        if data:
+            return part_size
+
+        self._base.seek(head)
+        data = self._base.read(1)
+        if not data:
+            return 0
+
+        # bisection
+        while tail >= head:
+            center = (head + tail) // 2
+            self._base.seek(center)
+            data = self._base.read(2)
+            if not data:
+                tail = center - 1
+            elif len(data) == 2:
+                head = center + 1
+            else:
+                return center - self._start + 1
+
+        raise UnreachableError
+
+    @property
+    def size(self) -> int:
+        """Get size of the substream."""
+        return self._size
+
+    def read(self, size: int = -1) -> bytes:
+        """Read data from the substream."""
+        self._check_closed()
+        self._base.seek(self._start + self._pos)
+
+        remaining = self._size - self._pos
+        if remaining <= 0:
+            return b""
+        if size < 0 or size > remaining:
+            size = remaining
+        data = self._base.read(size)
+        self._pos += len(data)
+        return data
+
+    def is_empty(self) -> bool:
+        """Check if the substream is empty."""
+        pos = self._pos
+
+        self.seek(0)
+        if not self.read(1):
+            return True
+
+        self._pos = pos
+        return False
+
+    def seek(self, offset: int, whence: int = io.SEEK_SET) -> int:
+        """Seek to a position in the substream."""
+        if whence == io.SEEK_SET:
+            new_pos = offset
+        elif whence == io.SEEK_CUR:
+            new_pos = self._pos + offset
+        elif whence == io.SEEK_END:
+            new_pos = self._size + offset
+        else:
+            raise ValueError(f"Invalid whence: {whence!r}")
+
+        if not 0 <= new_pos <= self._size:
+            raise ValueError("seek position out of range")
+
+        self._pos = new_pos
+        return self._pos
+
+    def tell(self) -> int:
+        """Return the current position in the substream."""
+        self._check_closed()
+        return self._pos
+
+    def readable(self) -> bool:
+        """Check if the substream is readable."""
+        return True
+
+    def seekable(self) -> bool:
+        """Check if the substream is seekable."""
+        return True
+
+    def close(self) -> None:
+        self._closed = True
+
+    @property
+    def closed(self) -> bool:
+        return self._closed
+
+    def _check_closed(self) -> None:
+        if self._closed:
+            raise ValueError("I/O operation on closed file.")
+
+    def __enter__(self):
+        self._check_closed()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+
+    def remaining(self) -> int:
+        """Bytes left to read."""
+        return max(0, self._size - self._pos)

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/legalhold.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/lifecycleconfig.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2015, 2016, 2017, 2018, 2019 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2015, 2016, 2017, 2018, 2019 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/minioadmin.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
 # (C) 2021 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/notificationconfig.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2021 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/objectlockconfig.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/replicationconfig.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/retention.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/select.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 """Request/response of SelectObjectContent API."""
 
 from __future__ import absolute_import, annotations

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/signer.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
 # (C) 2015-2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 """This module implements all helpers for AWS Signature version '4' support."""
 
 from __future__ import absolute_import, annotations

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/sse.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
 # (C) 2018 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,10 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# NOTICE: This file has been changed and differs from the original
-# Author: L-ING
-# Date: 2022-07-11
-
 """This module contains core API parsers."""
 from __future__ import absolute_import, annotations
 

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/sseconfig.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/tagging.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/time.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/versioningconfig.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/miniopy_async/xml.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
-# Asynchronous MinIO Client SDK for Python
-# (C) 2020 MinIO, Inc.
-# (C) 2022 Huseyn Mashadiyev <mashadiyev.huseyn@gmail.com>
-# (C) 2022 L-ING <hlf01@icloud.com>
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{miniopy_async-1.23.0 → miniopy_async-1.23.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "miniopy-async"
-version = "1.23.0"
+version = "1.23.2"
 description = "Asynchronous MinIO Client SDK for Python"
 authors = [
     "L-ING <hlf01@icloud.com>",
@@ -25,7 +25,6 @@ package-mode = true
 [tool.poetry.dependencies]
 python = "^3.10"
 aiohttp = "^3.11.14"
-aiofile = "^3.9.0"
 certifi = "^2025.1.31"
 aiohttp-retry = "^2.9.1"
 argon2-cffi = "^23.1.0"
@@ -36,6 +35,7 @@ sanic = "^24.12.0"
 sanic-jinja2 = "^2022.11.11"
 sphinx = "8.1.3"
 sphinx-rtd-theme = "^3.0.2"
+faker = "^37.4.0"
 
 [build-system]
 requires = ["poetry-core"]