eventsourcing 9.3.5__py3-none-any.whl → 9.4.0__py3-none-any.whl

eventsourcing/tests/postgres_utils.py

@@ -1,16 +1,17 @@
 import psycopg
+from psycopg.sql import SQL, Identifier
 
 from eventsourcing.persistence import PersistenceError
 from eventsourcing.postgres import PostgresDatastore
 
 
 def pg_close_all_connections(
-    name="eventsourcing",
-    host="127.0.0.1",
-    port="5432",
-    user="postgres",
-    password="postgres",  # noqa: S107
-):
+    name: str = "eventsourcing",
+    host: str = "127.0.0.1",
+    port: str = "5432",
+    user: str = "postgres",
+    password: str = "postgres",  # noqa: S107
+) -> None:
     try:
         # For local development... probably.
         pg_conn = psycopg.connect(
@@ -40,11 +41,13 @@ def pg_close_all_connections(
     """
     pg_conn_cursor = pg_conn.cursor()
     pg_conn_cursor.execute(close_all_connections)
-    return close_all_connections, pg_conn_cursor
 
 
-def drop_postgres_table(datastore: PostgresDatastore, table_name):
-    statement = f"DROP TABLE {table_name}"
+def drop_postgres_table(datastore: PostgresDatastore, table_name: str) -> None:
+    statement = SQL("DROP TABLE {0}.{1}").format(
+        Identifier(datastore.schema), Identifier(table_name)
+    )
+    # print(f"Dropping table {datastore.schema}.{table_name}")
     try:
         with datastore.transaction(commit=True) as curs:
             curs.execute(statement, prepare=False)

eventsourcing/utils.py

@@ -2,60 +2,47 @@ from __future__ import annotations
 
 import importlib
 import sys
+from collections.abc import Iterator, Mapping
 from functools import wraps
 from inspect import isfunction
 from random import random
 from threading import Lock
 from time import sleep
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Dict,
-    Iterator,
-    List,
-    Mapping,
-    Sequence,
-    Type,
-    TypeVar,
-    no_type_check,
-    overload,
-)
-
-if TYPE_CHECKING:  # pragma: nocover
+from types import ModuleType
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, no_type_check, overload
+
+if TYPE_CHECKING:
     from types import FunctionType, WrapperDescriptorType
 
 
 class TopicError(Exception):
-    """
-    Raised when topic doesn't resolve.
-    """
+    """Raised when topic doesn't resolve."""
 
 
-_type_cache: Dict[type, str] = {}
-_topic_cache: Dict[str, Any] = {}
+SupportsTopic = Union[type, Callable[..., Any], ModuleType]
+
+_type_cache: dict[SupportsTopic, str] = {}
+_topic_cache: dict[str, SupportsTopic] = {}
 _topic_cache_lock = Lock()
 
 
-def get_topic(cls: type) -> str:
-    """
-    Returns a "topic string" that locates the given class
+def get_topic(obj: SupportsTopic, /) -> str:
+    """Returns a "topic string" that locates the given class
     in its module. The string is formed by joining the
     module name and the class qualname separated by the
     colon character.
     """
     try:
-        return _type_cache[cls]
+        return _type_cache[obj]
     except KeyError:
-        topic = f"{cls.__module__}:{cls.__qualname__}"
-        register_topic(topic, cls)
-        _type_cache[cls] = topic
+        topic = f"{obj.__module__}:{obj.__qualname__}"
+        register_topic(topic, obj)
+        _type_cache[obj] = topic
         return topic
 
 
 def resolve_topic(topic: str) -> Any:
-    """
-    Returns an object located by the given topic.
+    """Returns an object located by the given topic.
 
     This function can be (is) used to locate domain
     event classes and aggregate classes from the
@@ -109,9 +96,8 @@ def resolve_topic(topic: str) -> Any:
     return obj
 
 
-def register_topic(topic: str, obj: Any) -> None:
-    """
-    Registers a topic with an object, so the object will be
+def register_topic(topic: str, obj: SupportsTopic) -> None:
+    """Registers a topic with an object, so the object will be
     returned whenever the topic is resolved.
 
     This function can be used to cache the topic of a class, so
@@ -138,13 +124,12 @@ def clear_topic_cache() -> None:
 
 
 def retry(
-    exc: Type[Exception] | Sequence[Type[Exception]] = Exception,
+    exc: type[Exception] | tuple[type[Exception], ...] = Exception,
     max_attempts: int = 1,
     wait: float = 0,
     stall: float = 0,
 ) -> Callable[[Any], Any]:
-    """
-    Retry decorator.
+    """Retry decorator.
 
     :param exc: List of exceptions that will cause the call to be retried if raised.
     :param max_attempts: Maximum number of attempts to try.
@@ -154,9 +139,9 @@ def retry(
     """
 
     @no_type_check
-    def _retry(func):
+    def _retry(func: Callable) -> Callable:
         @wraps(func)
-        def retry_decorator(*args, **kwargs):
+        def retry_decorator(*args: Any, **kwargs: Any) -> Any:
             if stall:
                 sleep(stall)
             attempts = 0
@@ -223,11 +208,13 @@ def strtobool(val: str) -> bool:
     raise ValueError(msg)
 
 
-def reversed_keys(d: Dict[Any, Any]) -> Iterator[Any]:
+def reversed_keys(d: dict[Any, Any]) -> Iterator[Any]:
     return reversed(d.keys())
 
 
-def get_method_name(method: FunctionType | WrapperDescriptorType) -> str:
+def get_method_name(
+    method: Callable[..., Any] | FunctionType | WrapperDescriptorType,
+) -> str:
     if sys.version_info >= (3, 10):  # pragma: no cover
         return method.__qualname__
     return method.__name__  # pragma: no cover
@@ -237,25 +224,30 @@ EnvType = Mapping[str, str]
 T = TypeVar("T")
 
 
-class Environment(Dict[str, str]):
+class Environment(dict[str, str]):
     def __init__(self, name: str = "", env: EnvType | None = None):
         super().__init__(env or {})
         self.name = name
 
+    @overload  # type: ignore[override]
+    def get(self, __key: str, /) -> str | None: ...  # pragma: no cover
+
     @overload
-    def get(self, key: str) -> str | None: ...  # pragma: no cover
+    def get(self, __key: str, /, __default: str) -> str: ...  # pragma: no cover
 
     @overload
-    def get(self, key: str, default: str | T) -> str | T: ...  # pragma: no cover
+    def get(self, __key: str, /, __default: T) -> str | T: ...  # pragma: no cover
 
-    def get(self, key: str, default: str | T | None = None) -> str | T | None:
-        for _key in self.create_keys(key):
+    def get(  # pyright: ignore [reportIncompatibleMethodOverride]
+        self, __key: str, /, __default: str | T | None = None
+    ) -> str | T | None:
+        for _key in self.create_keys(__key):
             value = super().get(_key, None)
             if value is not None:
                 return value
-        return default
+        return __default
 
-    def create_keys(self, key: str) -> List[str]:
+    def create_keys(self, key: str) -> list[str]:
         keys = []
         if self.name:
             keys.append(self.name.upper() + "_" + key)

{eventsourcing-9.3.5.dist-info → eventsourcing-9.4.0.dist-info}/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2023, John Bywater
+Copyright (c) 2025, John Bywater
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

{eventsourcing-9.3.5.dist-info → eventsourcing-9.4.0.dist-info}/METADATA

@@ -1,13 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: eventsourcing
-Version: 9.3.5
+Version: 9.4.0
 Summary: Event sourcing in Python
-Home-page: https://github.com/pyeventsourcing/eventsourcing
 License: BSD 3-Clause
 Keywords: event sourcing,event store,domain driven design,domain-driven design,ddd,cqrs,cqs
 Author: John Bywater
 Author-email: john.bywater@appropriatesoftware.net
-Requires-Python: >=3.8,<4.0
+Requires-Python: >=3.9, !=2.7.*, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*, !=3.7.*, !=3.8.*
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
@@ -17,23 +16,24 @@ Classifier: License :: Other/Proprietary License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Provides-Extra: crypto
+Provides-Extra: cryptography
 Provides-Extra: postgres
-Requires-Dist: backports.zoneinfo ; python_version < "3.9"
-Requires-Dist: psycopg[c,pool] (<=3.2.99999) ; extra == "postgres"
-Requires-Dist: pycryptodome (>=3.21,<3.22) ; extra == "crypto"
+Requires-Dist: cryptography (>=44.0,<44.1) ; extra == "cryptography"
+Requires-Dist: psycopg[pool] (<=3.2.99999) ; extra == "postgres"
+Requires-Dist: pycryptodome (>=3.22,<3.23) ; extra == "crypto"
 Requires-Dist: typing_extensions
+Project-URL: Homepage, https://github.com/pyeventsourcing/eventsourcing
 Project-URL: Repository, https://github.com/pyeventsourcing/eventsourcing
 Description-Content-Type: text/markdown
 
-[![Build Status](https://github.com/pyeventsourcing/eventsourcing/actions/workflows/runtests.yaml/badge.svg?branch=main)](https://github.com/pyeventsourcing/eventsourcing/tree/main)
+[![Build Status](https://github.com/pyeventsourcing/eventsourcing/actions/workflows/runtests.yaml/badge.svg?branch=9.4)](https://github.com/pyeventsourcing/eventsourcing)
 [![Coverage Status](https://coveralls.io/repos/github/pyeventsourcing/eventsourcing/badge.svg?branch=main)](https://coveralls.io/github/pyeventsourcing/eventsourcing?branch=main)
 [![Documentation Status](https://readthedocs.org/projects/eventsourcing/badge/?version=stable)](https://eventsourcing.readthedocs.io/en/stable/)
 [![Latest Release](https://badge.fury.io/py/eventsourcing.svg)](https://pypi.org/project/eventsourcing/)
@@ -43,7 +43,10 @@ Description-Content-Type: text/markdown
 
 # Event Sourcing in Python
 
-A library for event sourcing in Python.
+This project is a comprehensive Python library for implementing event sourcing, a design pattern where all
+changes to application state are stored as a sequence of events. This library provides a solid foundation
+for building event-sourced applications in Python, with a focus on reliability, performance, and developer
+experience. Please [read the docs](https://eventsourcing.readthedocs.io/). See also [extension projects](https://github.com/pyeventsourcing).
 
 *"totally amazing and a pleasure to use"*
 
@@ -51,8 +54,6 @@ A library for event sourcing in Python.
 
 *"a huge help and time saver"*
 
-Please [read the docs](https://eventsourcing.readthedocs.io/). See also [extension projects](https://github.com/pyeventsourcing).
-
 
 ## Installation
 

eventsourcing-9.4.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+eventsourcing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eventsourcing/application.py,sha256=K3M9_Rh2jaYzBDPMvmyemLXHQ4GsGfGsxmMfUeVSqXw,35507
+eventsourcing/cipher.py,sha256=ulTBtX5K9ejRAkdUaUbdIaj4H7anYwDOi7JxOolj2uo,3295
+eventsourcing/compressor.py,sha256=qEYWvsUXFLyhKgfuv-HGNJ6VF4sRw4z0IxbNW9ukOfc,385
+eventsourcing/cryptography.py,sha256=aFZLlJxxSb5seVbh94-T8FA_RIGOe-VFu5SJrbOnwUU,2969
+eventsourcing/dispatch.py,sha256=j03cIVPziq6LFEgJxvQMMIPlixuZ4bB8ynXXdd_Tj8Q,2740
+eventsourcing/domain.py,sha256=bIELG5g8O4KhBBJMa9A0YeUe9EIuHul4LvCvGBuUhls,62962
+eventsourcing/interface.py,sha256=-VLoqcd9a0PXpD_Bv0LjCiG21xLREG6tXK6phgtShOw,5035
+eventsourcing/persistence.py,sha256=y_1o3LNi9tkOTqkvjgsGF4un4XPXEgxzt0Iwhk7UzEI,46340
+eventsourcing/popo.py,sha256=xZD6mig7bVwAoHe-UdraXvuu2iL5a8b2b41cEcBHlBU,9642
+eventsourcing/postgres.py,sha256=LGEsfAN_cUOL6xX0NT4gxVcu2Btma95WLqtYcEzdPSA,37757
+eventsourcing/projection.py,sha256=2qkagy2o1sts22LqndYZzsDV7AJK28oGkPrFH1ECnYM,15069
+eventsourcing/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eventsourcing/sqlite.py,sha256=1DRQgDE1S7lz7Mnz9QH6WZ4luMjI9tof1YpH5qrK9u8,22076
+eventsourcing/system.py,sha256=WCfuSc45A9A1fFO7zpDum_ddh4pU7x-vEcpVZ_ycAyE,44358
+eventsourcing/tests/__init__.py,sha256=FtOyuj-L-oSisYeByTIrnUw-XzsctSbq76XmjPy5fMc,102
+eventsourcing/tests/application.py,sha256=pAn9Cugp_1rjOtj_nruGhh7PxdrQWibDlrnOAlOKXwo,20614
+eventsourcing/tests/domain.py,sha256=yN-F6gMRumeX6nIXIcZGxAR3RrUslzmEMM8JksnkI8Q,3227
+eventsourcing/tests/persistence.py,sha256=jy_aMQwRGKQKohw8Ji7oBf1aFIdcHLHiSrHxH6yHvzw,58654
+eventsourcing/tests/postgres_utils.py,sha256=0ywklGp6cXZ5PmV8ANVkwSHsZZCl5zTmOk7iG-RmrCE,1548
+eventsourcing/utils.py,sha256=pOnczXzaE5q7UbQbPmgcpWaP660fsmfiDJs6Gmo8QCM,8558
+eventsourcing-9.4.0.dist-info/AUTHORS,sha256=8aHOM4UbNZcKlD-cHpFRcM6RWyCqtwtxRev6DeUgVRs,137
+eventsourcing-9.4.0.dist-info/LICENSE,sha256=CQEQzcZO8AWXL5i3hIo4yVKrYjh2FBz6hCM7kpXWpw4,1512
+eventsourcing-9.4.0.dist-info/METADATA,sha256=NOe7UGOwfegOvMY0n4DOfcOGVEof3hxeJVTLbZpZnX8,10098
+eventsourcing-9.4.0.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+eventsourcing-9.4.0.dist-info/RECORD,,

{eventsourcing-9.3.5.dist-info → eventsourcing-9.4.0.dist-info}/WHEEL

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

eventsourcing-9.3.5.dist-info/RECORD

@@ -1,24 +0,0 @@
-eventsourcing/__init__.py,sha256=st2H3shrhTk5rqoUeZHUW8XD9iOX9tGGtQFWr2HGYmo,26
-eventsourcing/application.py,sha256=AwTpzqByZT4b6tS6HIFQkH3m9Xx2tchBN-j7jAq63wc,35868
-eventsourcing/cipher.py,sha256=NJcVfZdSlCER6xryM4zVoY3cmKstF-iSSniB4jmpaKg,3200
-eventsourcing/compressor.py,sha256=IdvrJUB9B2td871oifInv4lGXmHwYL9d69MbHHCr7uI,421
-eventsourcing/dispatch.py,sha256=yYSpT-jqc6l_wTdqEnfPJJfvsZN2Ta8g2anrVPWIcqQ,1412
-eventsourcing/domain.py,sha256=rvm4Sv2MmLcha8_5wqJ13AjmqyWvuzkquYsexUaePIg,57264
-eventsourcing/interface.py,sha256=KzDWLeIkREf-TAFl5AFHtKJwJFA-IthqMKClFkUFqdc,4676
-eventsourcing/persistence.py,sha256=TJseAtsWwdC33XLvcoyHdgwTv6s6KsvQS8XLKIq472s,37672
-eventsourcing/popo.py,sha256=AApSGneHuXa8yHOWdDfsFTMVDI-9ivEpuKTX1BSOXr8,6547
-eventsourcing/postgres.py,sha256=NatfdA-YQQPB1qWsQg23Uhyy6R-hcGNOJHJ1bKmFuKQ,29772
-eventsourcing/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-eventsourcing/sqlite.py,sha256=jz7SZk26Gcsjw88KL1xnr4-1tStTW16f1NR6TjMsZnQ,18466
-eventsourcing/system.py,sha256=tRn-KpSxcrpJ3x8BtpD9hxYSvk8IHBIPSfTMKPLVT60,46307
-eventsourcing/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-eventsourcing/tests/application.py,sha256=wBanhWzAZvL3fYxCFe5cloN-Up7uLw6KcdRQ2dhKVAg,17586
-eventsourcing/tests/domain.py,sha256=lHSlY6jIoSeqlcPSbrrozEPUJGvJ8bgPrznlmzTxn2w,3254
-eventsourcing/tests/persistence.py,sha256=giLWEZDdViXY8_SHCJerJ0sYVbJUP3UkLKaEbel9sqs,45777
-eventsourcing/tests/postgres_utils.py,sha256=xymcGYasUXeZTBenkHz-ykD8HtrFjVM1Z7-qRrH6OQk,1364
-eventsourcing/utils.py,sha256=PIWDvoGiKCXsNbR5DirkoJ_svopg80SoH37bqxOcjkU,8247
-eventsourcing-9.3.5.dist-info/AUTHORS,sha256=8aHOM4UbNZcKlD-cHpFRcM6RWyCqtwtxRev6DeUgVRs,137
-eventsourcing-9.3.5.dist-info/LICENSE,sha256=bSE_F-T6cQPmMY5LuJC27km_pGB1XCVuUFx1uY0Nueg,1512
-eventsourcing-9.3.5.dist-info/METADATA,sha256=yLNXm5rtENkOWB7kK63T2ohN1w7FuraebWFlk-Nxfho,9734
-eventsourcing-9.3.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-eventsourcing-9.3.5.dist-info/RECORD,,