sqlalchemy-foundation-kit 0.3.0__tar.gz → 0.5.0__tar.gz

sqlalchemy_foundation_kit-0.5.0/CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+## [0.5.0](https://github.com/bedrock-python/sqlalchemy-foundation-kit/compare/sqlalchemy-foundation-kit-v0.4.0...sqlalchemy-foundation-kit-v0.5.0) (2026-10-16)
+
+
+### ⚠ BREAKING CHANGES
+
+* BasePostgresConfig.use_orjson_serialization now defaults to False, matching AsyncSessionManager and the builder. A service that has orjson installed, kept the default, and writes values only orjson serializes (datetime, UUID, Decimal, non-str keys) into JSON columns now gets StatementError (TypeError: Object of type datetime is not JSON serializable). Set use_orjson_serialization=True to keep the old behaviour.
+* uow.query() now opens its transaction READ ONLY. A write inside it (INSERT, UPDATE, DELETE, DDL, nextval()) fails with SQLSTATE 25006 instead of being rolled back silently, or persisted when followed by an explicit session.commit(). Move writes to uow.transaction().
+
+### Bug Fixes
+
+* build null and static pools from PoolSettings, and stop recommending the sync queue pool ([#61](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/61)) ([608d327](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/608d32747361321895f6fc43f5e77da6937375ff))
+* count connect timeouts, not statement timeouts, in connection_timeouts_total ([#63](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/63)) ([961e0e8](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/961e0e862cb540525cda99b5ecc79ee12cbab2e4))
+* default use_orjson_serialization to False, so the [settings] quick start runs ([#66](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/66)) ([3addfdd](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/3addfdd50c98657966867b680121facd596b6810))
+* read the pool gauges when they are scraped, and never export a negative overflow ([#62](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/62)) ([e85ac96](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/e85ac96bd875ee47729f029c8046ea85be48f712))
+* run query() in a READ ONLY transaction, as documented ([#64](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/64)) ([cb77404](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/cb7740468cc86d1d7e9f7bda80d56b27b0300739))
+* stop logging a failed flush's parameters and row values ([#65](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/65)) ([6dd88ba](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/6dd88ba34de6f6fa3306f7e9002788ab57f7797c))
+
+## [0.4.0](https://github.com/bedrock-python/sqlalchemy-foundation-kit/compare/sqlalchemy-foundation-kit-v0.3.0...sqlalchemy-foundation-kit-v0.4.0) (2026-09-07)
+
+
+### Features
+
+* measure the wait for a pool connection, and count pool checkout timeouts ([#27](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/27)) ([78c9d7e](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/78c9d7e2c05052090276bce08219047849cd6dbb))
+
+## [0.3.0](https://github.com/bedrock-python/sqlalchemy-foundation-kit/compare/sqlalchemy-foundation-kit-v0.2.1...sqlalchemy-foundation-kit-v0.3.0) (2026-09-07)
+
+
+### Features
+
+* stop sending jit and search_path as startup parameters ([#24](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/24)) ([704c343](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/704c343b932b15f0c6ee434f2fc80ab4732b0f80))
+
+## [0.2.1](https://github.com/bedrock-python/sqlalchemy-foundation-kit/compare/sqlalchemy-foundation-kit-v0.2.0...sqlalchemy-foundation-kit-v0.2.1) (2026-09-06)
+
+
+### Bug Fixes
+
+* the defects the agents page turned up ([#21](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/21)) ([9548c72](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/9548c72670696dd68e0eeec1f0ae4ad896fa62d6))
+
+## [0.2.0](https://github.com/bedrock-python/sqlalchemy-foundation-kit/compare/sqlalchemy-foundation-kit-v0.1.0...sqlalchemy-foundation-kit-v0.2.0) (2026-08-28)
+
+
+### Features
+
+* **uow:** add savepoint() to AsyncSQLAlchemyUowTransaction ([#6](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/6)) ([c46d881](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/c46d881052b7476211c31f4adc6058d4f5500b6a)), closes [#5](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/5)
+
+
+### Bug Fixes
+
+* **ci:** add workflow_dispatch and created trigger to publish workflow ([142aef5](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/142aef5040777b31509e8d7b26f01774e8f22432))
+
+## 0.1.0 (2026-05-19)
+
+
+### Features
+
+* add managed_session method for manual transaction control and tracing ([776407b](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/776407b5dbe78d314e7525bd68ae8c9c772f78a7))
+* **contrib:** add dependency-injector support, rename di to dishka, add test suite ([3bbf3e4](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/3bbf3e46b8ecd0419652dc53d1cee7d1fdbf031b))
+* initial sqlalchemy-foundation-kit library ([738b4f1](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/738b4f126e03d0e7dc8852d30b0cf76b67bbbc57))
+
+
+### Bug Fixes
+
+* comprehensive code review improvements ([487c283](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/487c2835e77c93cd64f9f00c73b7ae7a84673548))
+
+
+### Documentation
+
+* **foundation-kit:** add comprehensive documentation for all features ([8d10f84](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/8d10f84179273a8cc40dc1fe326bddab84379d32))

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sqlalchemy-foundation-kit
-Version: 0.3.0
+Version: 0.5.0
 Summary: Foundation layer for SQLAlchemy-based services with UoW, session management, and observability
 Project-URL: Repository, https://github.com/bedrock-python/sqlalchemy-foundation-kit
 Project-URL: Documentation, https://bedrock-python.github.io/sqlalchemy-foundation-kit/
@@ -216,6 +216,8 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
@@ -397,7 +399,7 @@ class PostgresConfig:
     query: QuerySettingsProtocol = MyQuerySettings()
     application_name: str = "my-service"
     db_schema: str | None = None
-    use_orjson_serialization: bool = True
+    use_orjson_serialization: bool = False
     jit: str | None = None
     
     def to_dsn(self) -> str:
@@ -494,7 +496,7 @@ from sqlalchemy_foundation_kit.contrib.settings import (
 from sqlalchemy_foundation_kit.contrib.metrics import PostgresMetrics
 ```
 - `PostgresMetrics` — Prometheus metrics for connection pool
-- Tracks: pool size, checked out connections, checkout duration, errors
+- Tracks: pool size, checked out connections, checkout wait, held duration, timeouts, errors
 
 #### `contrib.di` (requires `[dishka]`)
 ```python

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/README.md

@@ -146,7 +146,7 @@ class PostgresConfig:
     query: QuerySettingsProtocol = MyQuerySettings()
     application_name: str = "my-service"
     db_schema: str | None = None
-    use_orjson_serialization: bool = True
+    use_orjson_serialization: bool = False
     jit: str | None = None
     
     def to_dsn(self) -> str:
@@ -243,7 +243,7 @@ from sqlalchemy_foundation_kit.contrib.settings import (
 from sqlalchemy_foundation_kit.contrib.metrics import PostgresMetrics
 ```
 - `PostgresMetrics` — Prometheus metrics for connection pool
-- Tracks: pool size, checked out connections, checkout duration, errors
+- Tracks: pool size, checked out connections, checkout wait, held duration, timeouts, errors
 
 #### `contrib.di` (requires `[dishka]`)
 ```python

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/pyproject.toml

@@ -25,6 +25,8 @@ classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed",
 ]

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/sqlalchemy_foundation_kit/__init__.py

@@ -31,7 +31,9 @@ from .config import (
 # Protocols
 from .protocols import (
     CheckoutRecorder,
+    CheckoutWaitRecorder,
     ErrorRecorder,
+    PoolStatsFunctionRecorder,
     PoolStatsRecorder,
     PostgresMetricsProtocol,
 )
@@ -64,7 +66,7 @@ from .uow import (
 try:
     __version__ = version("sqlalchemy-foundation-kit")
 except PackageNotFoundError:  # pragma: no cover
-    __version__ = "0.3.0"
+    __version__ = "0.5.0"
 
 __all__ = [  # noqa: RUF022
     # Base ORM
@@ -89,7 +91,9 @@ __all__ = [  # noqa: RUF022
     "QuerySettingsProtocol",
     # Protocols
     "CheckoutRecorder",
+    "CheckoutWaitRecorder",
     "ErrorRecorder",
+    "PoolStatsFunctionRecorder",
     "PoolStatsRecorder",
     "PostgresMetricsProtocol",
     # Session Management

sqlalchemy_foundation_kit-0.5.0/sqlalchemy_foundation_kit/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.5.0"

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/sqlalchemy_foundation_kit/base/engine.py

@@ -224,26 +224,25 @@ def _apply_pool_settings(
     Maps pool settings to SQLAlchemy's expected ``pool_*`` keyword arguments.
     Note: pool_pre_ping is already set in build_engine_kwargs, so not applied here.
 
-    Only applies pool size/overflow/recycle/timeout for pool classes that support them.
-    Checks if the pool class accepts these parameters via hasattr to avoid passing
-    unsupported kwargs to pools like NullPool or StaticPool.
+    ``pool_recycle`` applies to every pool class. ``pool_size``, ``max_overflow`` and
+    ``pool_timeout`` describe a queue of connections and exist only on ``QueuePool``
+    and its subclasses -- the async queue pools, a registered subclass, the class
+    ``instrument_pool_class`` builds. ``create_async_engine`` rejects them for any other
+    pool (``NullPool``, ``StaticPool``), so they are left out there.
 
     Args:
         engine_kwargs: Dictionary to update with pool configuration.
         poolclass: Pool class being configured.
         pool_settings: Pool configuration settings.
     """
-    # Build pool parameters dict
-    params = {
-        "pool_size": pool_settings.size,
-        "max_overflow": pool_settings.max_overflow,
-        "pool_recycle": pool_settings.recycle,
-        "pool_timeout": pool_settings.timeout,
-    }
+    params: dict[str, object] = {"pool_recycle": pool_settings.recycle}
+    if issubclass(poolclass, QueuePool):
+        params.update(
+            pool_size=pool_settings.size,
+            max_overflow=pool_settings.max_overflow,
+            pool_timeout=pool_settings.timeout,
+        )
 
-    # Apply only non-None parameters
-    # SQLAlchemy pool classes that don't support these params will ignore them
-    # or raise TypeError if passed, so we rely on the pool class itself to validate
     engine_kwargs.update({k: v for k, v in params.items() if v is not None})
 
 

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/sqlalchemy_foundation_kit/config/postgres.py

@@ -143,7 +143,7 @@ class PostgresSettingsProtocol(Protocol):
             ...     query: QuerySettingsProtocol
             ...     application_name: str = "my-app"
             ...     db_schema: str | None = None
-            ...     use_orjson_serialization: bool = True
+            ...     use_orjson_serialization: bool = False
             ...     jit: str | None = None
             ...
             ...     def to_dsn(self) -> str:

sqlalchemy_foundation_kit-0.5.0/sqlalchemy_foundation_kit/contrib/metrics/postgres.py

@@ -0,0 +1,226 @@
+"""Postgres metrics using prometheus-client."""
+
+from __future__ import annotations
+
+import re
+from collections.abc import Callable
+
+try:
+    from prometheus_client import Counter, Gauge, Histogram
+
+    HAS_PROMETHEUS = True
+except ImportError:
+    HAS_PROMETHEUS = False
+
+# Default buckets for how long a connection was held (seconds)
+CONNECTION_CHECKOUT_BUCKETS: tuple[float, ...] = (
+    0.001,
+    0.005,
+    0.01,
+    0.025,
+    0.05,
+    0.1,
+    0.25,
+    0.5,
+    1.0,
+    2.5,
+    5.0,
+)
+
+# Default buckets for the wait for a connection from the pool (seconds). The range runs to
+# 30 s, the default ``pool_timeout``, so a saturated pool fills the top buckets instead of
+# collapsing into +Inf just when the histogram is worth reading.
+CONNECTION_WAIT_BUCKETS: tuple[float, ...] = (
+    0.001,
+    0.005,
+    0.01,
+    0.025,
+    0.05,
+    0.1,
+    0.25,
+    0.5,
+    1.0,
+    2.5,
+    5.0,
+    10.0,
+    30.0,
+)
+
+
+def _check_prometheus() -> None:
+    """Check if prometheus-client is installed."""
+    if not HAS_PROMETHEUS:
+        raise ImportError(
+            "prometheus-client is required for PostgresMetrics. "
+            "Install it with: pip install 'sqlalchemy-foundation-kit[metrics]'"
+        )
+
+
+class PostgresMetrics:
+    """Postgres connection pool metrics.
+
+    Metrics:
+        - postgres_db_pool_size: Configured pool_size of the connection pool.
+        - postgres_db_pool_checked_out: Number of connections currently checked out.
+        - postgres_db_pool_overflow: Number of open connections over pool_size (within max_overflow).
+        - postgres_db_connection_checkout_wait_seconds: Time a caller waited for a connection.
+        - postgres_db_connection_held_duration_seconds: Time a connection was held by its caller.
+        - postgres_db_connection_checkout_duration_seconds: Deprecated alias of the held duration,
+          published unchanged for one more minor release.
+        - postgres_db_connection_timeouts_total: Number of times acquiring a connection timed out:
+          pool checkout timeouts and connect timeouts. Statement timeouts are not counted here.
+        - postgres_db_connection_errors_total: Number of connection errors.
+
+    Labels:
+        - error_type: Type of connection error (for errors_total).
+
+    The three pool gauges are read from the pool when the registry is collected, not
+    sampled from pool events, so an idle pool reports what it holds. One instance reports
+    one engine: attached to a second engine, the gauges follow the second.
+
+    The wait histogram and the timeout counter are fed by the instrumented pool class the
+    session manager builds, so they only move on an engine created by
+    ``AsyncSessionManager`` (or one whose pool went through ``instrument_pool_class``).
+    """
+
+    def __init__(self, prefix: str | None = None) -> None:
+        """Initialize postgres metrics.
+
+        Args:
+            prefix: Metric name prefix.
+
+        Raises:
+            ImportError: If prometheus-client is not installed.
+        """
+        _check_prometheus()
+
+        self.pool_size = Gauge(
+            _make_metric_name("postgres_db_pool_size", prefix),
+            "Configured pool_size of the database connection pool",
+        )
+        self.pool_checked_out = Gauge(
+            _make_metric_name("postgres_db_pool_checked_out", prefix),
+            "Number of database connections currently checked out",
+        )
+        self.pool_overflow = Gauge(
+            _make_metric_name("postgres_db_pool_overflow", prefix),
+            "Number of open connections over pool_size (within max_overflow)",
+        )
+        self.connection_checkout_wait = Histogram(
+            _make_metric_name("postgres_db_connection_checkout_wait_seconds", prefix),
+            "Time a caller waited to acquire a connection from the pool",
+            buckets=list(CONNECTION_WAIT_BUCKETS),
+        )
+        self.connection_held_duration = Histogram(
+            _make_metric_name("postgres_db_connection_held_duration_seconds", prefix),
+            "Time a connection was held by its caller, from checkout to checkin",
+            buckets=list(CONNECTION_CHECKOUT_BUCKETS),
+        )
+        self.connection_checkout_duration = Histogram(
+            _make_metric_name("postgres_db_connection_checkout_duration_seconds", prefix),
+            "Deprecated: held duration, published under its old name. Use postgres_db_connection_held_duration_seconds",
+            buckets=list(CONNECTION_CHECKOUT_BUCKETS),
+        )
+        self.connection_timeouts_total = Counter(
+            _make_metric_name("postgres_db_connection_timeouts_total", prefix),
+            "Number of times acquiring a connection timed out: pool checkout timeouts and connect timeouts",
+        )
+        self.connection_errors_total = Counter(
+            _make_metric_name("postgres_db_connection_errors_total", prefix),
+            "Number of connection errors",
+            ["error_type"],
+        )
+
+    def record_pool_stats(
+        self,
+        pool_size: int,
+        pool_checked_out: int,
+        pool_overflow: int,
+    ) -> None:
+        """Record database connection pool statistics."""
+        self.pool_size.set(float(pool_size))
+        self.pool_checked_out.set(float(pool_checked_out))
+        self.pool_overflow.set(float(pool_overflow))
+
+    def set_pool_stats_functions(
+        self,
+        pool_size: Callable[[], float],
+        pool_checked_out: Callable[[], float],
+        pool_overflow: Callable[[], float],
+    ) -> None:
+        """Read the pool gauges from these functions whenever the registry is collected."""
+        self.pool_size.set_function(pool_size)
+        self.pool_checked_out.set_function(pool_checked_out)
+        self.pool_overflow.set_function(pool_overflow)
+
+    def record_checkout(
+        self,
+        duration: float,
+    ) -> None:
+        """Record how long a connection was held, from checkout to checkin.
+
+        Observed into ``postgres_db_connection_held_duration_seconds`` and, until the
+        deprecated name is dropped, into ``postgres_db_connection_checkout_duration_seconds``
+        as well.
+        """
+        self.connection_held_duration.observe(duration)
+        self.connection_checkout_duration.observe(duration)
+
+    def record_checkout_wait(
+        self,
+        duration: float,
+        timed_out: bool = False,
+    ) -> None:
+        """Record the wait for a connection from the pool, and count a timeout acquiring it.
+
+        A pool checkout timeout and a connect timeout never reach the engine's
+        ``handle_error`` listener; this is the only place either is counted.
+        """
+        self.connection_checkout_wait.observe(duration)
+        if timed_out:
+            self.connection_timeouts_total.inc()
+
+    def record_error(
+        self,
+        error_type: str,
+        is_timeout: bool = False,
+    ) -> None:
+        """Record a database connection or execution error.
+
+        ``is_timeout`` is kept for compatibility and still counts a timeout when a custom
+        caller sets it; the library itself no longer does.
+        """
+        self.connection_errors_total.labels(error_type=error_type).inc()
+        if is_timeout:
+            self.connection_timeouts_total.inc()
+
+
+_PREFIX_PATTERN: re.Pattern[str] = re.compile(r"^[a-zA-Z_][a-zA-Z0-9_]*$")
+
+
+def _make_metric_name(name: str, prefix: str | None = None) -> str:
+    """Make metric name with optional prefix.
+
+    Prefix must follow Prometheus naming conventions (^[a-zA-Z_][a-zA-Z0-9_]*$).
+
+    Args:
+        name: Base metric name.
+        prefix: Optional prefix for the metric.
+
+    Returns:
+        The combined metric name.
+
+    Raises:
+        ValueError: If the prefix is invalid.
+    """
+    if prefix:
+        if not _PREFIX_PATTERN.match(prefix):
+            raise ValueError(
+                f"Invalid metric prefix: '{prefix}'. "
+                "Prefixes must start with a letter or underscore and contain only letters, numbers, or underscores."
+            )
+        return f"{prefix}_{name}"
+    return name
+
+
+__all__ = ["PostgresMetrics"]

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/sqlalchemy_foundation_kit/contrib/settings/postgres.py

@@ -47,8 +47,15 @@ class PoolSettings(BaseModel):
 
     Groups all connection pool-related parameters for SQLAlchemy engine.
 
+    ``size``, ``max_overflow`` and ``timeout`` apply to the queue pools
+    (``async_adapted_queue``, ``fallback_async_adapted_queue``) and are not passed to any
+    other pool. ``static`` is SQLAlchemy's ``StaticPool``: one connection shared by every
+    session, which concurrent sessions cannot use safely -- for tests, never as a
+    fixed-size pool. A fixed-size pool is ``async_adapted_queue`` with ``max_overflow=0``.
+
     Examples:
         >>> pool = PoolSettings(size=10, max_overflow=20)
+        >>> fixed = PoolSettings(size=10, max_overflow=0)
     """
 
     kind: PoolClassStr = Field(
@@ -68,8 +75,11 @@ class PoolSettings(BaseModel):
     @model_validator(mode="after")
     def _validate_pool_settings(self) -> PoolSettings:
         """Validate pool configuration constraints."""
-        if self.kind == "static" and self.max_overflow > 0:
-            raise ValueError(f"max_overflow must be 0 for static pool, got {self.max_overflow}")
+        if self.kind == "static" and self.size > 1:
+            raise ValueError(
+                f"size must be 1 for a static pool, got {self.size}: a static pool is one connection "
+                "shared by every session. For a fixed-size pool use kind='async_adapted_queue' with max_overflow=0"
+            )
         return self
 
 
@@ -100,7 +110,9 @@ class BasePostgresConfig(BaseSettings):
         application_name: Application name for connection identification.
         db_schema: Optional PostgreSQL ``search_path`` — a schema, or a comma-separated
             list — applied to every transaction with ``SET LOCAL`` semantics.
-        use_orjson_serialization: Use orjson for JSON serialization (requires orjson).
+        use_orjson_serialization: Serialize JSON / JSONB columns with orjson. Off by default:
+            it needs the ``orjson`` extra, and orjson serializes some values (``datetime``,
+            ``UUID``, ``Decimal``, non-``str`` keys) that ``json.dumps`` rejects.
         jit: JIT compilation setting (off/on), sent as a startup parameter only when set.
             ``None`` (the default) sends nothing and leaves the server's own setting; a
             transaction-mode PgBouncer rejects the parameter unless it tracks it.
@@ -133,8 +145,8 @@ class BasePostgresConfig(BaseSettings):
         description="PostgreSQL search_path (a schema or a comma-separated list), applied to every transaction",
     )
     use_orjson_serialization: bool = Field(
-        default=True,
-        description="Use orjson for JSON serialization (requires orjson installed)",
+        default=False,
+        description="Use orjson for JSON serialization (requires the orjson extra)",
     )
     jit: PostgresJit | None = Field(
         default=None,

{sqlalchemy_foundation_kit-0.3.0 → sqlalchemy_foundation_kit-0.5.0}/sqlalchemy_foundation_kit/protocols/__init__.py

@@ -8,14 +8,18 @@ from __future__ import annotations
 
 from .metrics import (
     CheckoutRecorder,
+    CheckoutWaitRecorder,
     ErrorRecorder,
+    PoolStatsFunctionRecorder,
     PoolStatsRecorder,
     PostgresMetricsProtocol,
 )
 
 __all__ = [
     "CheckoutRecorder",
+    "CheckoutWaitRecorder",
     "ErrorRecorder",
+    "PoolStatsFunctionRecorder",
     "PoolStatsRecorder",
     "PostgresMetricsProtocol",
 ]