hexkit 7.3.0__tar.gz → 8.1.0__tar.gz

{hexkit-7.3.0 → hexkit-8.1.0}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+   Copyright 2021 - 2026 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");

{hexkit-7.3.0/src/hexkit.egg-info → hexkit-8.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexkit
-Version: 7.3.0
+Version: 8.1.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
@@ -29,7 +29,7 @@ Provides-Extra: s3
 Requires-Dist: boto3<2,>=1.42; extra == "s3"
 Requires-Dist: botocore<2,>=1.42; extra == "s3"
 Provides-Extra: mongodb
-Requires-Dist: pymongo<5,>=4.15; extra == "mongodb"
+Requires-Dist: pymongo<5,>=4.16; extra == "mongodb"
 Provides-Extra: redis
 Requires-Dist: redis<8,>=7.1; extra == "redis"
 Provides-Extra: opentelemetry-base
@@ -64,16 +64,16 @@ Requires-Dist: hexkit[opentelemetry-fastapi]; extra == "opentelemetry"
 Requires-Dist: hexkit[opentelemetry-s3]; extra == "opentelemetry"
 Provides-Extra: test-akafka
 Requires-Dist: hexkit[akafka]; extra == "test-akafka"
-Requires-Dist: testcontainers[kafka]<5,>=4.13; extra == "test-akafka"
+Requires-Dist: testcontainers[kafka]<5,>=4.14; extra == "test-akafka"
 Provides-Extra: test-s3
 Requires-Dist: hexkit[s3]; extra == "test-s3"
-Requires-Dist: testcontainers<5,>=4.13; extra == "test-s3"
+Requires-Dist: testcontainers<5,>=4.14; extra == "test-s3"
 Provides-Extra: test-mongodb
 Requires-Dist: hexkit[mongodb]; extra == "test-mongodb"
-Requires-Dist: testcontainers[mongo]<5,>=4.13; extra == "test-mongodb"
+Requires-Dist: testcontainers[mongo]<5,>=4.14; extra == "test-mongodb"
 Provides-Extra: test-redis
 Requires-Dist: hexkit[redis]; extra == "test-redis"
-Requires-Dist: testcontainers[redis]<5,>=4.13; extra == "test-redis"
+Requires-Dist: testcontainers[redis]<5,>=4.14; extra == "test-redis"
 Provides-Extra: test
 Requires-Dist: hexkit[test-akafka,test-mongodb,test-s3]; extra == "test"
 Provides-Extra: all

{hexkit-7.3.0 → hexkit-8.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [build-system]
 requires = [
-    "setuptools>=80.9",
+    "setuptools>=80.10",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -23,7 +23,7 @@ classifiers = [
     "Intended Audience :: Developers",
 ]
 name = "hexkit"
-version = "7.3.0"
+version = "8.1.0"
 description = "A Toolkit for Building Microservices using the Hexagonal Architecture"
 dependencies = [
     "opentelemetry-api >=1.39, <2",
@@ -45,7 +45,7 @@ s3 = [
     "botocore >=1.42, <2",
 ]
 mongodb = [
-    "pymongo >=4.15, <5",
+    "pymongo >=4.16, <5",
 ]
 redis = [
     "redis >=7.1, <8",
@@ -89,19 +89,19 @@ opentelemetry = [
 ]
 test-akafka = [
     "hexkit[akafka]",
-    "testcontainers[kafka] >=4.13, <5",
+    "testcontainers[kafka] >=4.14, <5",
 ]
 test-s3 = [
     "hexkit[s3]",
-    "testcontainers >=4.13, <5",
+    "testcontainers >=4.14, <5",
 ]
 test-mongodb = [
     "hexkit[mongodb]",
-    "testcontainers[mongo] >=4.13, <5",
+    "testcontainers[mongo] >=4.14, <5",
 ]
 test-redis = [
     "hexkit[redis]",
-    "testcontainers[redis] >=4.13, <5",
+    "testcontainers[redis] >=4.14, <5",
 ]
 test = [
     "hexkit[test-akafka,test-s3,test-mongodb]",
@@ -221,7 +221,7 @@ check_untyped_defs = true
 no_site_packages = false
 
 [tool.pytest.ini_options]
-minversion = "8.4"
+minversion = "9.0"
 asyncio_mode = "strict"
 asyncio_default_fixture_loop_scope = "function"
 
@@ -251,6 +251,6 @@ legacy_tox_ini = """
     deps =
         --no-deps -r ./lock/requirements-dev.txt
     commands =
-        py310: pip install --no-deps backports.asyncio.runner==1.2.0 exceptiongroup==1.3.0 tomli==2.2.1
+        py310: pip install --no-deps backports.asyncio.runner==1.2.0 exceptiongroup==1.3.1 tomli==2.2.1
         pytest {posargs}
 """

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/__main__.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/base.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/config.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");
@@ -29,6 +29,8 @@ from pydantic_settings import (
 
 # Default config prefix:
 DEFAULT_CONFIG_PREFIX: Final = "ghga_services"
+# Default dotenv path:
+DEFAULT_DOTENV_PATH: Final[Path] = Path("/secrets")
 
 
 class ConfigYamlDoesNotExist(RuntimeError):
@@ -82,6 +84,7 @@ def get_default_config_yaml(prefix: str) -> Path | None:
 
 def config_from_yaml(
     prefix: str = DEFAULT_CONFIG_PREFIX,
+    dotenv_prefix: Path = DEFAULT_DOTENV_PATH,
 ) -> Callable:
     """A factory that returns decorator functions which extends a
     pydantic BaseSettings class to read in parameters from a config yaml.
@@ -102,6 +105,10 @@ def config_from_yaml(
             "{prefix}_{actual_variable_name}". Moreover, this prefix is used
             to derive the default location for the config yaml file
             ("~/.{prefix}.yaml"). Defaults to "ghga_services".
+        dotenv_prefix: (Path, optional):
+            When defining parameters via dotenv files, this prefix is used to set the path
+            for the dotenv files. The final path used is constructed as
+            "{dotenv_prefix}/.env". Defaults to "/secrets".
     """
 
     def decorator(settings) -> Callable:
@@ -141,7 +148,11 @@ def config_from_yaml(
             class ModSettings(settings):
                 """Modifies the original Settings class provided by the user"""
 
-                model_config = SettingsConfigDict(frozen=True, env_prefix=f"{prefix}_")
+                model_config = SettingsConfigDict(
+                    frozen=True,
+                    env_prefix=f"{prefix}_",
+                    env_file=(".env", dotenv_prefix / ".env"),
+                )
 
                 @classmethod
                 def settings_customise_sources(
@@ -156,6 +167,7 @@ def config_from_yaml(
                     return (
                         init_settings,
                         env_settings,
+                        dotenv_settings,
                         file_secret_settings,
                         YamlConfigSettingsSource(settings_cls, config_yaml),
                     )

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/correlation.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/custom_types.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/log.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/opentelemetry.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/dao.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");
@@ -23,7 +23,7 @@ from abc import ABC, abstractmethod
 from collections.abc import AsyncIterator, Collection, Mapping
 from contextlib import AbstractAsyncContextManager
 from functools import partial
-from typing import Any, TypeVar
+from typing import Any, Generic, TypeVar
 from uuid import uuid4
 
 from pydantic import BaseModel, Field
@@ -39,10 +39,22 @@ __all__ = [
     "ResourceAlreadyExistsError",
     "ResourceNotFoundError",
     "UUID4Field",
+    "UniqueConstraintViolationError",
 ]
 
+
+class IndexBase(ABC):
+    """Base from which all DAO index classes must inherit"""
+
+    @abstractmethod
+    def list_field_names(self) -> list[str]:
+        """Returns a list of all fields specified by this index"""
+        ...
+
+
 # Type variable for handling Data Transfer Objects:
 Dto = TypeVar("Dto", bound=BaseModel)
+Index = TypeVar("Index", bound=IndexBase)
 
 
 class DaoError(RuntimeError):
@@ -65,6 +77,20 @@ class ResourceAlreadyExistsError(DaoError):
         super().__init__(message)
 
 
+class UniqueConstraintViolationError(DaoError):
+    """Raised when attempting to insert a resource violated a uniqueness constraint.
+
+    This does not apply to the default unique index automatically applied to
+    the ID field.
+    """
+
+    def __init__(self, *, unique_fields: dict[str, Any]):
+        message = (
+            f"A resource with the unique field value(s) {unique_fields} already exists."
+        )
+        super().__init__(message)
+
+
 class FindError(DaoError):
     """Base for all error related to DAO find operations."""
 
@@ -152,6 +178,9 @@ class Dao(typing.Protocol[Dto]):
         Raises:
             ResourceNotFoundError:
                 when resource with the id specified in the dto was not found
+            UniqueConstraintViolationError:
+                when updating the dto would violate a unique index constraint over some
+                field other than the ID field.
         """
         ...
 
@@ -224,6 +253,9 @@ class Dao(typing.Protocol[Dto]):
         Raises:
             ResourceAlreadyExistsError:
                 when a resource with the ID specified in the dto does already exist.
+            UniqueConstraintViolationError:
+                when inserting the dto would violate a unique index constraint over some
+                field other than the ID field.
         """
         ...
 
@@ -234,6 +266,11 @@ class Dao(typing.Protocol[Dto]):
             dto:
                 Resource content as a pydantic-based data transfer object including the
                 resource ID.
+
+        Raises:
+            UniqueConstraintViolationError:
+                when upserting the dto would violate a unique index constraint over some
+                field other than the ID field.
         """
         ...
 
@@ -268,16 +305,19 @@ class DaoFactoryBase:
         cls,
         *,
         dto_model: type[Dto],
-        fields_to_index: Collection[str] | None,
+        indexes: Collection[Index] | None,
     ) -> None:
         """Checks that all provided fields are present in the dto_model.
         Raises IndexFieldsInvalidError otherwise.
         """
-        if fields_to_index is None:
+        if not indexes:
             return
 
         try:
-            validate_fields_in_model(model=dto_model, fields=fields_to_index)
+            for index in indexes:
+                validate_fields_in_model(
+                    model=dto_model, fields=index.list_field_names()
+                )
         except FieldNotInModelError as error:
             raise cls.IndexFieldsInvalidError(
                 f"Provided index fields are invalid: {error}"
@@ -289,16 +329,14 @@ class DaoFactoryBase:
         *,
         dto_model: type[Dto],
         id_field: str,
-        fields_to_index: Collection[str] | None,
+        indexes: Collection[Index] | None,
     ) -> None:
         """Validates the input parameters of the get_dao method."""
         cls._validate_dto_model_id(dto_model=dto_model, id_field=id_field)
-        cls._validate_fields_to_index(
-            dto_model=dto_model, fields_to_index=fields_to_index
-        )
+        cls._validate_fields_to_index(dto_model=dto_model, indexes=indexes)
 
 
-class DaoFactoryProtocol(DaoFactoryBase, ABC):
+class DaoFactoryProtocol(DaoFactoryBase, ABC, Generic[Index]):
     """A protocol describing a factory to produce Data Access Objects (DAO) objects
     that are enclosed in transactional scopes.
     """
@@ -309,7 +347,7 @@ class DaoFactoryProtocol(DaoFactoryBase, ABC):
         name: str,
         dto_model: type[Dto],
         id_field: str,
-        fields_to_index: Collection[str] | None = None,
+        indexes: Collection[Index] | None = None,
     ) -> Dao[Dto]:
         """Constructs a DAO for interacting with resources in a database.
 
@@ -322,9 +360,9 @@ class DaoFactoryProtocol(DaoFactoryBase, ABC):
             id_field:
                 The name of the field of the `dto_model` that serves as resource ID.
                 (DAO implementation might use this field as primary key.)
-            fields_to_index:
-                Optionally, provide any fields that should be indexed in addition to the
-                `id_field`. Defaults to None.
+            indexes:
+                Optionally, provide any indexes that should be created in addition to
+                the provider's default index on `id_field`. Defaults to None.
         Returns:
             A DAO specific to the provided DTO model.
 
@@ -334,17 +372,13 @@ class DaoFactoryProtocol(DaoFactoryBase, ABC):
             self.IdTypeNotSupportedError:
                 Raised when the id_field of the dto_model has an unexpected type.
         """
-        self._validate(
-            dto_model=dto_model,
-            id_field=id_field,
-            fields_to_index=fields_to_index,
-        )
+        self._validate(dto_model=dto_model, id_field=id_field, indexes=indexes)
 
         return await self._get_dao(
             name=name,
             dto_model=dto_model,
             id_field=id_field,
-            fields_to_index=fields_to_index,
+            indexes=indexes,
         )
 
     @abstractmethod
@@ -354,7 +388,7 @@ class DaoFactoryProtocol(DaoFactoryBase, ABC):
         name: str,
         dto_model: type[Dto],
         id_field: str,
-        fields_to_index: Collection[str] | None,
+        indexes: Collection[Index] | None,
     ) -> Dao[Dto]:
         """*To be implemented by the provider. Input validation is done outside of this
         method.*

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/daopub.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");
@@ -26,11 +26,7 @@ from abc import ABC, abstractmethod
 from collections.abc import Callable, Collection
 
 from hexkit.custom_types import JsonObject
-from hexkit.protocols.dao import (
-    Dao,
-    DaoFactoryBase,
-    Dto,
-)
+from hexkit.protocols.dao import Dao, DaoFactoryBase, Dto, Index
 
 
 class DaoPublisher(Dao[Dto], typing.Protocol[Dto]):
@@ -49,7 +45,7 @@ class DaoPublisher(Dao[Dto], typing.Protocol[Dto]):
         ...
 
 
-class DaoPublisherFactoryProtocol(DaoFactoryBase, ABC):
+class DaoPublisherFactoryProtocol(DaoFactoryBase, ABC, typing.Generic[Index]):
     """A protocol describing a factory to produce Data Access Objects (DAO) objects
     which automatically publish changes according to the outbox pattern.
     """
@@ -60,7 +56,7 @@ class DaoPublisherFactoryProtocol(DaoFactoryBase, ABC):
         name: str,
         dto_model: type[Dto],
         id_field: str,
-        fields_to_index: Collection[str] | None = None,
+        indexes: Collection[Index] | None = None,
         dto_to_event: Callable[[Dto], JsonObject | None],
         event_topic: str,
         autopublish: bool = True,
@@ -76,9 +72,9 @@ class DaoPublisherFactoryProtocol(DaoFactoryBase, ABC):
             id_field:
                 The name of the field of the `dto_model` that serves as resource ID.
                 (DAO implementation might use this field as primary key.)
-            fields_to_index:
-                Optionally, provide any fields that should be indexed in addition to the
-                `id_field`. Defaults to None.
+            indexes:
+                Optionally, provide any indexes that should be created in addition to
+                the provider's default index on `id_field`. Defaults to None.
             dto_to_event:
                 A function that takes a DTO and returns the payload for an event.
                 If the returned payload is None, the event will not be published.
@@ -97,17 +93,13 @@ class DaoPublisherFactoryProtocol(DaoFactoryBase, ABC):
             self.IdTypeNotSupportedError:
                 Raised when the id_field of the dto_model has an unexpected type.
         """
-        self._validate(
-            dto_model=dto_model,
-            id_field=id_field,
-            fields_to_index=fields_to_index,
-        )
+        self._validate(dto_model=dto_model, id_field=id_field, indexes=indexes)
 
         return await self._get_dao(
             name=name,
             dto_model=dto_model,
             id_field=id_field,
-            fields_to_index=fields_to_index,
+            indexes=indexes,
             dto_to_event=dto_to_event,
             event_topic=event_topic,
             autopublish=autopublish,
@@ -120,7 +112,7 @@ class DaoPublisherFactoryProtocol(DaoFactoryBase, ABC):
         name: str,
         dto_model: type[Dto],
         id_field: str,
-        fields_to_index: Collection[str] | None,
+        indexes: Collection[Index] | None,
         dto_to_event: Callable[[Dto], JsonObject | None],
         event_topic: str,
         autopublish: bool,

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/daosub.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/eventpub.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/eventsub.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/kvstore.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/protocols/objstorage.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");
@@ -182,6 +182,31 @@ class ObjectStorageProtocol(ABC):
             anticipated_part_size=anticipated_part_size,
         )
 
+    async def list_multipart_uploads_for_object(
+        self, *, bucket_id: str, object_id: str
+    ) -> list[str]:
+        """Lists all active multipart uploads for the given object ID.
+
+        Raises a `BucketNotFoundError` if the bucket does not exist.
+        """
+        self._validate_bucket_id(bucket_id)
+        self._validate_object_id(object_id)
+        return await self._list_multipart_uploads_for_object(
+            bucket_id=bucket_id, object_id=object_id
+        )
+
+    async def get_all_multipart_uploads(self, *, bucket_id: str) -> dict[str, str]:
+        """Gets all active multipart uploads for the given bucket ID.
+
+        Returns a dict where the keys are upload IDs and values are object IDs.
+        S3 allows multiple ongoing multi-part uploads, so it's possible for some upload
+        IDs to map to the same object ID.
+
+        Raises a `BucketNotFoundError` if the bucket does not exist.
+        """
+        self._validate_bucket_id(bucket_id)
+        return await self._get_all_multipart_uploads(bucket_id=bucket_id)
+
     async def get_object_download_url(
         self, *, bucket_id: str, object_id: str, expires_after: int = 86400
     ) -> str:
@@ -404,6 +429,29 @@ class ObjectStorageProtocol(ABC):
         """
         ...
 
+    @abstractmethod
+    async def _list_multipart_uploads_for_object(
+        self, *, bucket_id: str, object_id: str
+    ) -> list[str]:
+        """Lists all active multipart uploads for the given object ID.
+
+        *To be implemented by the provider. Input validation is done outside of this
+        method.*
+        """
+        ...
+
+    @abstractmethod
+    async def _get_all_multipart_uploads(self, *, bucket_id: str) -> dict[str, str]:
+        """Gets all active multipart uploads for the given bucket ID.
+
+        Returns a dict where the keys are upload IDs and values are object IDs.
+        S3 allows multiple ongoing multi-part uploads, so it's possible for some upload
+        IDs to map to the same object ID.
+
+        *To be implemented by the provider. Input validation is done outside of this
+        method.*
+        """
+
     @abstractmethod
     async def _get_object_download_url(
         self, *, bucket_id: str, object_id: str, expires_after: int = 86400

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/config.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/provider/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/provider/daosub.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/provider/eventpub.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/provider/eventsub.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/provider/utils.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/testcontainer.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");

{hexkit-7.3.0 → hexkit-8.1.0}/src/hexkit/providers/akafka/testutils.py

@@ -1,4 +1,4 @@
-# Copyright 2021 - 2025 Universität Tübingen, DKFZ, EMBL, and Universität zu Köln
+# Copyright 2021 - 2026 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");