hexkit 3.4.0__tar.gz → 3.6.0__tar.gz

{hexkit-3.4.0/src/hexkit.egg-info → hexkit-3.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hexkit
-Version: 3.4.0
+Version: 3.6.0
 Summary: A Toolkit for Building Microservices using the Hexagonal Architecture
 Author-email: "German Human Genome Phenome Archive (GHGA)" <contact@ghga.de>
 License: Apache 2.0

{hexkit-3.4.0 → hexkit-3.6.0}/pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
     "Intended Audience :: Developers",
 ]
 name = "hexkit"
-version = "3.4.0"
+version = "3.6.0"
 description = "A Toolkit for Building Microservices using the Hexagonal Architecture"
 dependencies = [
     "pydantic >=2, <3",

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/config.py

@@ -17,13 +17,13 @@
 
 import os
 from pathlib import Path
-from typing import Any, Callable, Final, Optional
+from typing import Callable, Final, Optional
 
-import yaml
 from pydantic_settings import (
     BaseSettings,
     PydanticBaseSettingsSource,
     SettingsConfigDict,
+    YamlConfigSettingsSource,
 )
 
 # Default config prefix:
@@ -79,29 +79,6 @@ def get_default_config_yaml(prefix: str) -> Optional[Path]:
     return None
 
 
-def yaml_settings_factory(
-    config_yaml: Optional[Path] = None,
-) -> Callable[[], dict[str, Any]]:
-    """
-    A factory of source methods for pydantic's BaseSettings Config that load
-    settings from a yaml file.
-
-    Args:
-        config_yaml (str, Optional):
-            Path to the yaml file to read from.
-    """
-
-    def yaml_settings() -> dict[str, Any]:
-        """Source method for loading pydantic BaseSettings from a yaml file"""
-        if config_yaml is None:
-            return {}
-
-        with open(config_yaml, encoding="utf8") as yaml_file:
-            return yaml.safe_load(yaml_file)
-
-    return yaml_settings
-
-
 def config_from_yaml(
     prefix: str = DEFAULT_CONFIG_PREFIX,
 ) -> Callable:
@@ -119,7 +96,7 @@ def config_from_yaml(
 
     Args:
         prefix: (str, optional):
-            When defining parameters via enviroment variables, all variables
+            When defining parameters via environment variables, all variables
             have to be prefixed with this string following this pattern
             "{prefix}_{actual_variable_name}". Moreover, this prefix is used
             to derive the default location for the config yaml file
@@ -161,12 +138,12 @@ def config_from_yaml(
                 raise ConfigYamlDoesNotExist(path=config_yaml)
 
             class ModSettings(settings):
-                """Modifies the orginal Settings class provided by the user"""
+                """Modifies the original Settings class provided by the user"""
 
                 model_config = SettingsConfigDict(frozen=True, env_prefix=f"{prefix}_")
 
                 @classmethod
-                def settings_customise_sources(  # noqa: PLR0913
+                def settings_customise_sources(
                     cls,
                     settings_cls: type[BaseSettings],
                     init_settings: PydanticBaseSettingsSource,
@@ -174,12 +151,12 @@ def config_from_yaml(
                     dotenv_settings: PydanticBaseSettingsSource,
                     file_secret_settings: PydanticBaseSettingsSource,
                 ):
-                    """Add custom yaml source"""
+                    """Add custom yaml source, but maintain the priority of sources."""
                     return (
                         init_settings,
                         env_settings,
                         file_secret_settings,
-                        yaml_settings_factory(config_yaml),
+                        YamlConfigSettingsSource(settings_cls, config_yaml),
                     )
 
             # construct settings class:

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/protocols/dao.py

@@ -21,6 +21,7 @@ with the database.
 # ruff: noqa: PLR0913
 
 import typing
+import warnings
 from abc import ABC, abstractmethod
 from collections.abc import AsyncGenerator, AsyncIterator, Collection, Mapping
 from contextlib import AbstractAsyncContextManager
@@ -29,6 +30,7 @@ from typing import Any, Optional, TypeVar, Union, overload
 from uuid import uuid4
 
 from pydantic import BaseModel
+from typing_extensions import deprecated
 
 from hexkit.utils import FieldNotInModelError, validate_fields_in_model
 
@@ -61,7 +63,7 @@ class ResourceAlreadyExistsError(RuntimeError):
     """Raised when a resource did unexpectedly exist."""
 
     def __init__(self, *, id_: str):
-        message = f'The resource with the id "{id_}" does already exist.'
+        message = f'The resource with the id "{id_}" already exists.'
         super().__init__(message)
 
 
@@ -259,6 +261,9 @@ class DaoNaturalId(DaoCommons[Dto], typing.Protocol[Dto]):
         ...
 
 
+@deprecated(
+    "uuid4_id_generator is deprecated as of v3.6 and will be removed in hexkit v4."
+)
 async def uuid4_id_generator() -> AsyncGenerator[str, None]:
     """Generates a new ID using the UUID4 algorithm.
     This is an AsyncGenerator to be compliant with the id_generator requirements of the
@@ -441,6 +446,15 @@ class DaoFactoryProtocol(DaoFactoryBase, ABC):
             # instantiate the default ID generator:
             id_generator = uuid4_id_generator()
 
+        if dto_creation_model is not None:
+            dep_msg = (
+                "The DAO API (and existing providers) are deprecated as of v3.6."
+                + " They will be simplified in hexkit v4."
+                + " Please plan to provide IDs during resource creation. The same model"
+                + " should be used for both creation and retrieval."
+            )
+            warnings.warn(dep_msg, category=DeprecationWarning, stacklevel=2)
+
         return await self._get_dao(
             name=name,
             dto_model=dto_model,

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/akafka/config.py

@@ -18,7 +18,7 @@
 
 from typing import Literal
 
-from pydantic import Field, SecretStr
+from pydantic import Field, PositiveInt, SecretStr
 from pydantic_settings import BaseSettings
 
 
@@ -76,3 +76,9 @@ class KafkaConfig(BaseSettings):
             + " newly correlation ID will be generated and used in the event header."
         ),
     )
+    kafka_max_message_size: PositiveInt = Field(
+        default=1024 * 1024,  # 1 MiB
+        description="The largest message size that can be transmitted, in bytes. Only"
+        + " services that have a need to send/receive larger messages should set this.",
+        examples=[1024 * 1024, 16 * 1024 * 1024],
+    )

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/akafka/provider/eventpub.py

@@ -54,6 +54,7 @@ class KafkaProducerCompatible(Protocol):
         client_id: str,
         key_serializer: Callable[[Any], bytes],
         value_serializer: Callable[[Any], bytes],
+        max_request_size: int,
     ):
         """
         Initialize the producer with some config params.
@@ -67,6 +68,8 @@ class KafkaProducerCompatible(Protocol):
                 Function to serialize the keys into bytes.
             value_serializer:
                 Function to serialize the values into bytes.
+            max_request_size:
+                Maximum sendable message size.
         """
         ...
 
@@ -116,6 +119,7 @@ class KafkaEventPublisher(EventPublisherProtocol):
             value_serializer=lambda event_value: json.dumps(event_value).encode(
                 "ascii"
             ),
+            max_request_size=config.kafka_max_message_size,
         )
 
         try:

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/akafka/provider/eventsub.py

@@ -90,6 +90,7 @@ class KafkaConsumerCompatible(Protocol):
         enable_auto_commit: bool,
         key_deserializer: Callable[[bytes], str],
         value_deserializer: Callable[[bytes], str],
+        max_partition_fetch_bytes: int,
     ):
         """
         Initialize the consumer with some config params.
@@ -108,6 +109,8 @@ class KafkaConsumerCompatible(Protocol):
                 Function to deserialize the keys into strings.
             value_serializer:
                 Function to deserialize the values into strings.
+            max_partition_fetch_bytes:
+                Maximum receivable message size
         """
         ...
 
@@ -176,6 +179,7 @@ class KafkaEventSubscriber(InboundProviderBase):
             value_deserializer=lambda event_value: json.loads(
                 event_value.decode("ascii")
             ),
+            max_partition_fetch_bytes=config.kafka_max_message_size,
         )
         try:
             await consumer.start()

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/mongodb/provider.py

@@ -22,6 +22,7 @@ Utilities for testing are located in `./testutils.py`.
 # ruff: noqa: PLR0913
 
 import json
+import warnings
 from abc import ABC
 from collections.abc import AsyncGenerator, AsyncIterator, Collection, Mapping
 from contextlib import AbstractAsyncContextManager
@@ -31,6 +32,7 @@ from motor.core import AgnosticCollection
 from motor.motor_asyncio import AsyncIOMotorClient
 from pydantic import Field, SecretStr
 from pydantic_settings import BaseSettings
+from pymongo.errors import DuplicateKeyError
 
 from hexkit.protocols.dao import (
     DaoFactoryProtocol,
@@ -42,6 +44,7 @@ from hexkit.protocols.dao import (
     InvalidFindMappingError,
     MultipleHitsFoundError,
     NoHitsFoundError,
+    ResourceAlreadyExistsError,
     ResourceNotFoundError,
 )
 from hexkit.utils import FieldNotInModelError, validate_fields_in_model
@@ -161,6 +164,17 @@ class MongoDbDaoBase(ABC, Generic[Dto]):
         self._document_to_dto = document_to_dto
         self._dto_to_document = dto_to_document
 
+        warnings.warn(
+            "The MongoDbDaoBase class and subclasses are deprecated as of v3.6 and will"
+            + " be replaced in hexkit v4 with the new MongoDbDao class. To replace the"
+            + " MongoDbDaoNaturalId: just use the new class. To replace the"
+            + " MongoDbDaoSurrogateId: use the new class, remove the creation model and"
+            + " id_generator parameters, and make sure the supplied DTO model includes"
+            + " the ID field with a default factory for generating new IDs.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+
     async def get_by_id(self, id_: str) -> Dto:
         """Get a resource by providing its ID.
 
@@ -386,7 +400,10 @@ class MongoDbDaoNaturalId(MongoDbDaoBase[Dto]):
                 when a resource with the ID specified in the dto does already exist.
         """
         document = self._dto_to_document(dto)
-        await self._collection.insert_one(document)
+        try:
+            await self._collection.insert_one(document)
+        except DuplicateKeyError as error:
+            raise ResourceAlreadyExistsError(id_=document["_id"]) from error
 
     async def upsert(self, dto: Dto) -> None:
         """Update the provided resource if it already exists, create it otherwise.

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/mongokafka/provider.py

@@ -20,6 +20,7 @@ Require dependencies of the `akafka` and `mongodb` extras.
 """
 
 import json
+import logging
 from collections.abc import AsyncIterator, Awaitable, Collection, Mapping
 from contextlib import AbstractAsyncContextManager, asynccontextmanager, contextmanager
 from typing import Any, Callable, Generic, Optional
@@ -27,6 +28,7 @@ from typing import Any, Callable, Generic, Optional
 from aiokafka import AIOKafkaProducer
 from motor.core import AgnosticCollection
 from motor.motor_asyncio import AsyncIOMotorClient
+from pydantic import field_validator
 
 from hexkit.correlation import get_correlation_id, set_correlation_id
 from hexkit.custom_types import JsonObject
@@ -253,7 +255,14 @@ class MongoKafkaDaoPublisher(Generic[Dto]):
         document = self._dao._dto_to_document(dto)
         document.setdefault("__metadata__", {})["correlation_id"] = correlation_id
         result = await self._collection.replace_one(
-            {"_id": document["_id"], "__metadata__.deleted": False}, document
+            {
+                "_id": document["_id"],
+                "$or": [
+                    {"__metadata__": {"$exists": False}},
+                    {"__metadata__.deleted": False},
+                ],
+            },
+            document,
         )
         if result.matched_count == 0:
             raise ResourceNotFoundError(id_=document["_id"])
@@ -280,7 +289,14 @@ class MongoKafkaDaoPublisher(Generic[Dto]):
             },
         }
         result = await self._collection.replace_one(
-            {"_id": document["_id"], "__metadata__.deleted": False}, document
+            {
+                "_id": document["_id"],
+                "$or": [
+                    {"__metadata__": {"$exists": False}},
+                    {"__metadata__.deleted": False},
+                ],
+            },
+            document,
         )
         if result.matched_count == 0:
             raise ResourceNotFoundError(id_=id_)
@@ -396,6 +412,16 @@ class MongoKafkaDaoPublisher(Generic[Dto]):
 class MongoKafkaConfig(MongoDbConfig, KafkaConfig):
     """Config parameters and their defaults."""
 
+    @field_validator("kafka_max_message_size", mode="after")
+    @classmethod
+    def validate_max_message_size(cls, value: int) -> int:
+        """Validate the maximum message size."""
+        if value > 2**24:  # 16 MiB
+            logging.warning(
+                f"Max message size ({value}) exceeds the 16 MiB document size limit for MongoDB!"
+            )
+        return value
+
 
 class MongoKafkaDaoPublisherFactory(DaoPublisherFactoryProtocol):
     """A provider implementing the DaoPublisherFactoryProtocol based on MongoDB and

hexkit-3.6.0/src/hexkit/providers/s3/testutils/__init__.py

@@ -0,0 +1,94 @@
+# Copyright 2021 - 2024 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# for the German Human Genome-Phenome Archive (GHGA)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""S3-related test fixtures and support functions."""
+
+from ._fixtures import (
+    LOCALSTACK_IMAGE,
+    MEBIBYTE,
+    TEST_FILE_DIR,
+    TEST_FILE_PATHS,
+    FederatedS3Fixture,
+    FileObject,
+    S3ContainerFixture,
+    S3Fixture,
+    S3MultiContainerFixture,
+    calc_md5,
+    clean_federated_s3_fixture,
+    clean_s3_fixture,
+    federated_s3_fixture,
+    get_clean_federated_s3_fixture,
+    get_clean_s3_fixture,
+    get_persistent_federated_s3_fixture,
+    get_persistent_s3_fixture,
+    get_s3_container_fixture,
+    get_s3_multi_container_fixture,
+    persistent_federated_s3_fixture,
+    persistent_s3_fixture,
+    populate_storage,
+    s3_container_fixture,
+    s3_fixture,
+    s3_multi_container_fixture,
+    temp_file_object,
+    tmp_file,
+    upload_file,
+)
+from ._typical_workflow import typical_workflow
+from ._utils import (
+    check_part_size,
+    download_and_check_test_file,
+    multipart_upload_file,
+    upload_part,
+    upload_part_of_size,
+    upload_part_via_url,
+)
+
+__all__ = [
+    "LOCALSTACK_IMAGE",
+    "MEBIBYTE",
+    "TEST_FILE_DIR",
+    "TEST_FILE_PATHS",
+    "FileObject",
+    "S3ContainerFixture",
+    "S3Fixture",
+    "calc_md5",
+    "clean_s3_fixture",
+    "get_clean_s3_fixture",
+    "get_persistent_s3_fixture",
+    "get_s3_container_fixture",
+    "persistent_s3_fixture",
+    "populate_storage",
+    "s3_container_fixture",
+    "s3_fixture",
+    "temp_file_object",
+    "tmp_file",
+    "upload_file",
+    "typical_workflow",
+    "check_part_size",
+    "download_and_check_test_file",
+    "multipart_upload_file",
+    "upload_part",
+    "upload_part_of_size",
+    "upload_part_via_url",
+    "FederatedS3Fixture",
+    "S3MultiContainerFixture",
+    "clean_federated_s3_fixture",
+    "federated_s3_fixture",
+    "get_clean_federated_s3_fixture",
+    "get_s3_multi_container_fixture",
+    "get_persistent_federated_s3_fixture",
+    "s3_multi_container_fixture",
+    "persistent_federated_s3_fixture",
+]

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/s3/testutils/_fixtures.py

@@ -344,3 +344,151 @@ def tmp_file() -> Generator[FileObject, None, None]:
     """A fixture that provides a temporary file."""
     with temp_file_object() as temp_file:
         yield temp_file
+
+
+class FederatedS3Fixture:
+    """Fixture containing multiple S3 fixtures to simulate federated storage."""
+
+    def __init__(self, storages: dict[str, S3Fixture]):
+        self.storages = storages
+
+    def get_configs_by_alias(self) -> dict[str, S3Config]:
+        """Get the S3Config instance for each object storage in the fixture."""
+        return {alias: self.storages[alias].config for alias in self.storages}
+
+    async def populate_dummy_items(self, alias: str, contents: dict[str, list[str]]):
+        """Convenience function to populate a specific S3Fixture.
+
+        Args:
+        - `alias`: The alias of the S3Fixture to populate.
+        - `contents`: A dictionary with bucket names as keys and lists of object names
+        as values. The buckets can be empty, and the objects are created with a size of
+        1 byte.
+        """
+        if alias not in self.storages:
+            # This would indicate some kind of mismatch between config and fixture
+            raise RuntimeError(f"Alias '{alias}' not found in the federated S3 fixture")
+        storage = self.storages[alias]
+
+        # Populate the buckets so even empty buckets are established
+        await storage.populate_buckets([bucket for bucket in contents])
+
+        # Add the dummy items
+        for bucket, objects in contents.items():
+            for object in objects:
+                with temp_file_object(bucket, object, 1) as file:
+                    await storage.populate_file_objects([file])
+
+
+class S3MultiContainerFixture:
+    """Fixture for managing multiple running S3 test containers in order to mimic
+    multiple object storages.
+
+    Without this fixture, separate S3Fixture instances would access the same
+    underlying storage resources.
+    """
+
+    def __init__(self, s3_containers: dict[str, S3ContainerFixture]):
+        self.s3_containers = s3_containers
+
+    def __enter__(self):
+        """Enter the context manager and start the S3 containers."""
+        for container in self.s3_containers.values():
+            container.__enter__()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """Exit the context manager and clean up the S3 containers."""
+        for container in self.s3_containers.values():
+            container.__exit__(exc_type, exc_val, exc_tb)
+
+
+def _s3_multi_container_fixture(
+    request,
+) -> Generator[S3MultiContainerFixture, None, None]:
+    """Fixture function for getting multiple running S3 test containers."""
+    try:
+        storage_aliases = request.getfixturevalue("storage_aliases")
+    except pytest.FixtureLookupError as err:
+        raise NotImplementedError(
+            "You must provide a 'storage_aliases' fixture in your test setup."
+            + " It must have the same scope as 's3_multi_container'"
+            + " and it must return a list of the storage aliases to be used."
+        ) from err
+
+    if not storage_aliases:
+        raise RuntimeError("The 'storage_aliases' list must not be empty.")
+    s3_containers = {
+        alias: S3ContainerFixture(name=f"{alias}_s3_container")
+        for alias in storage_aliases
+    }
+    with S3MultiContainerFixture(s3_containers) as s3_multi_container:
+        yield s3_multi_container
+
+
+def get_s3_multi_container_fixture(
+    scope: PytestScope = "session", name: str = "s3_multi_container"
+):
+    """Get a fixture containing multiple LocalStack test containers.
+
+    By default, the session scope is used for LocalStack test containers.
+    Requires that a 'storage_aliases' fixture is provided in the test setup.
+    """
+    return pytest.fixture(_s3_multi_container_fixture, scope=scope, name=name)
+
+
+s3_multi_container_fixture = get_s3_multi_container_fixture()
+
+
+def _persistent_federated_s3_fixture(
+    s3_multi_container: S3MultiContainerFixture,
+) -> Generator[FederatedS3Fixture, None, None]:
+    """Fixture function that creates a persistent FederatedS3Fixture.
+
+    The state of each S3 storage in the fixture is not cleaned up.
+    """
+    s3_fixtures = {}
+    for alias, container in s3_multi_container.s3_containers.items():
+        config = container.s3_config
+        storage = S3ObjectStorage(config=config)
+        s3_fixtures[alias] = S3Fixture(config=config, storage=storage)
+    yield FederatedS3Fixture(s3_fixtures)
+
+
+def get_persistent_federated_s3_fixture(
+    scope: PytestScope = "function", name: str = "federated_s3"
+):
+    """Get a federated S3 storage fixture with desired scope.
+
+    The state of the S3 storage is not cleaned up by the fixture.
+    """
+    return pytest.fixture(_persistent_federated_s3_fixture, scope=scope, name=name)
+
+
+persistent_federated_s3_fixture = get_persistent_federated_s3_fixture()
+
+
+async def _clean_federated_s3_fixture(
+    s3_multi_container: S3MultiContainerFixture,
+) -> AsyncGenerator[FederatedS3Fixture, None]:
+    """Fixture function that creates a clean FederatedS3Fixture instance.
+
+    The state of each S3 storage is cleaned up before yielding the fixture.
+    """
+    for federated_s3_fixture in _persistent_federated_s3_fixture(s3_multi_container):
+        for s3_fixture in federated_s3_fixture.storages.values():
+            await s3_fixture.delete_buckets()
+        yield federated_s3_fixture
+
+
+def get_clean_federated_s3_fixture(
+    scope: PytestScope = "function", name: str = "federated_s3"
+):
+    """Get a federated S3 storage fixture with desired scope.
+
+    The state of the S3 storage is not cleaned up by the fixture.
+    """
+    return pytest_asyncio.fixture(_clean_federated_s3_fixture, scope=scope, name=name)
+
+
+federated_s3_fixture = clean_federated_s3_fixture = get_clean_federated_s3_fixture()

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/s3/testutils/_utils.py

@@ -44,7 +44,7 @@ class FileObject(BaseModel):
     bucket_id: str
     object_id: str
 
-    @computed_field  # type: ignore [misc]
+    @computed_field  # type: ignore [prop-decorator]
     @property
     def content(self) -> bytes:
         """Extract the content from the file at the provided path"""
@@ -53,7 +53,7 @@ class FileObject(BaseModel):
         with open(self.file_path, "rb") as file:
             return file.read()
 
-    @computed_field  # type: ignore [misc]
+    @computed_field  # type: ignore [prop-decorator]
     @property
     def md5(self) -> str:
         """Calculate the md5 hash of the content"""

{hexkit-3.4.0 → hexkit-3.6.0}/src/hexkit/providers/testing/eventpub.py

@@ -26,6 +26,8 @@ from typing import NamedTuple, Optional
 from hexkit.custom_types import JsonObject
 from hexkit.protocols.eventpub import EventPublisherProtocol
 
+__all__ = ["InMemEventStore", "InMemEventPublisher", "TopicExhaustedError"]
+
 
 class TopicExhaustedError(RuntimeError):
     """Thrown when now more event are queued in a topic."""

{hexkit-3.4.0 → hexkit-3.6.0/src/hexkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hexkit
-Version: 3.4.0
+Version: 3.6.0
 Summary: A Toolkit for Building Microservices using the Hexagonal Architecture
 Author-email: "German Human Genome Phenome Archive (GHGA)" <contact@ghga.de>
 License: Apache 2.0

hexkit-3.4.0/src/hexkit/providers/s3/testutils/__init__.py

@@ -1,47 +0,0 @@
-# Copyright 2021 - 2024 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
-# for the German Human Genome-Phenome Archive (GHGA)
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""S3-related test fixtures and support functions."""
-
-from ._fixtures import (  # noqa: F401
-    LOCALSTACK_IMAGE,
-    MEBIBYTE,
-    TEST_FILE_DIR,
-    TEST_FILE_PATHS,
-    FileObject,
-    S3ContainerFixture,
-    S3Fixture,
-    calc_md5,
-    clean_s3_fixture,
-    get_clean_s3_fixture,
-    get_persistent_s3_fixture,
-    get_s3_container_fixture,
-    persistent_s3_fixture,
-    populate_storage,
-    s3_container_fixture,
-    s3_fixture,
-    temp_file_object,
-    tmp_file,
-    upload_file,
-)
-from ._typical_workflow import typical_workflow  # noqa: F401
-from ._utils import (  # noqa: F401
-    check_part_size,
-    download_and_check_test_file,
-    multipart_upload_file,
-    upload_part,
-    upload_part_of_size,
-    upload_part_via_url,
-)