plexus-python-common 1.0.24__tar.gz → 1.0.25__tar.gz

{plexus_python_common-1.0.24 → plexus_python_common-1.0.25}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: plexus-python-common
-Version: 1.0.24
+Version: 1.0.25
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: <3.15,>=3.12
 Requires-Dist: boto3>=1.41
+Requires-Dist: boto3-stubs>=1.41
 Requires-Dist: cloudpathlib>=0.21
 Requires-Dist: lxml>=6.0
 Requires-Dist: numpy>=2.3

{plexus_python_common-1.0.24 → plexus_python_common-1.0.25}/pyproject.toml

@@ -9,6 +9,7 @@ build-backend = "setuptools.build_meta"
 [dependency-groups]
 dev = [
     "boto3>=1.41",
+    "boto3-stubs>=1.41",
     "cloudpathlib>=0.21",
     "lxml>=6.0",
     "numpy>=2.3",
@@ -48,6 +49,7 @@ classifiers = [
 ]
 dependencies = [
     "boto3>=1.41",
+    "boto3-stubs>=1.41",
     "cloudpathlib>=0.21",
     "lxml>=6.0",
     "numpy>=2.3",

{plexus_python_common-1.0.24 → plexus_python_common-1.0.25}/src/plexus/common/utils/s3utils.py

@@ -7,6 +7,7 @@ import mimetypes
 import os
 import os.path
 import tempfile
+import typing
 from collections.abc import Callable, Generator
 from pathlib import Path
 from typing import Literal
@@ -34,20 +35,29 @@ __all__ = [
 ]
 
 
-@dataclasses.dataclass
+@dataclasses.dataclass(frozen=True, eq=True)
 class S3ObjectMeta(object):
     key: str
     last_modified: datetime.datetime
     size: int
 
 
+if typing.TYPE_CHECKING:
+    def s3_make_client(
+        access_key_id: str = None,
+        secret_access_key: str = None,
+        region_name: str = None,
+        endpoint_url: str = None,
+    ) -> contextlib.AbstractContextManager[S3Client]: ...
+
+
 @contextlib.contextmanager
 def s3_make_client(
     access_key_id: str = None,
     secret_access_key: str = None,
     region_name: str = None,
     endpoint_url: str = None,
-) -> Generator[S3Client]:
+) -> Generator[S3Client, None, None]:
     """
     Creates an S3 client as a context manager for safe resource handling.
 
@@ -60,7 +70,12 @@ def s3_make_client(
     session = boto3.Session(aws_access_key_id=trim_to_none(access_key_id),
                             aws_secret_access_key=trim_to_none(secret_access_key),
                             region_name=trim_to_none(region_name))
-    yield S3Client(boto3_session=session, endpoint_url=trim_to_none(endpoint_url))
+    client = S3Client(boto3_session=session, endpoint_url=trim_to_none(endpoint_url))
+    try:
+        yield client
+    finally:
+        if hasattr(client, "close"):
+            client.close()
 
 
 def s3_list_objects(client: S3Client, bucket: str, prefix: str, limit: int = None) -> Generator[S3ObjectMeta]:
@@ -386,6 +401,15 @@ def s3_make_progress_callback(
     return progress_callback
 
 
+if typing.TYPE_CHECKING:
+    def s3_make_progressed_client(
+        access_key_id: str = None,
+        secret_access_key: str = None,
+        region_name: str = None,
+        endpoint_url: str = None,
+    ) -> contextlib.AbstractContextManager[S3Client]: ...
+
+
 @contextlib.contextmanager
 def s3_make_progressed_client(
     access_key_id: str = None,

{plexus_python_common-1.0.24 → plexus_python_common-1.0.25}/src/plexus/common/utils/testutils.py

@@ -1,3 +1,5 @@
+import uuid as py_uuid
+
 import textcase
 from iker.common.utils.jsonutils import JsonType
 from iker.common.utils.jsonutils import json_difference, json_reformat
@@ -6,6 +8,7 @@ from plexus.common.utils.datautils import compute_vin_code_check_digit
 
 __all__ = [
     "generate_dummy_uuid_str",
+    "generate_dummy_uuid",
     "generate_dummy_vin_code",
     "case_insensitive_json_compare",
 ]
@@ -20,6 +23,10 @@ def generate_dummy_uuid_str(*nums: int) -> str:
     return f"{i0:04x}{i1:04x}-{i2:04x}-{i3:04x}-{i4:04x}-{i5:04x}{i6:04x}{i7:04x}"
 
 
+def generate_dummy_uuid(*nums: int) -> py_uuid.UUID:
+    return py_uuid.UUID(generate_dummy_uuid_str(*nums))
+
+
 def generate_dummy_vin_code(*nums: int) -> str:
     if len(nums) > 4:
         raise ValueError("a maximum of 4 integers can be provided")

{plexus_python_common-1.0.24 → plexus_python_common-1.0.25}/src/plexus_python_common.egg-info/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: plexus-python-common
-Version: 1.0.24
+Version: 1.0.25
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: <3.15,>=3.12
 Requires-Dist: boto3>=1.41
+Requires-Dist: boto3-stubs>=1.41
 Requires-Dist: cloudpathlib>=0.21
 Requires-Dist: lxml>=6.0
 Requires-Dist: numpy>=2.3

{plexus_python_common-1.0.24 → plexus_python_common-1.0.25}/src/plexus_python_common.egg-info/requires.txt

@@ -1,4 +1,5 @@
 boto3>=1.41
+boto3-stubs>=1.41
 cloudpathlib>=0.21
 lxml>=6.0
 numpy>=2.3