sqlalchemy-boltons 1.0.1__tar.gz → 1.1.0__tar.gz

{sqlalchemy_boltons-1.0.1 → sqlalchemy_boltons-1.1.0}/CHANGELOG.md

@@ -4,6 +4,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Unreleased]
 
+## [1.1.0] - 2025-03-11
+
+### Changed
+
+- `sqlite`: Use an unlimited-size QueuePool by default.
+
 ## [1.0.1] - 2025-02-22
 
 ### Changed

{sqlalchemy_boltons-1.0.1 → sqlalchemy_boltons-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sqlalchemy_boltons
-Version: 1.0.1
+Version: 1.1.0
 Summary: Utilities that should've been inside SQLAlchemy but aren't
 Author-email: Eduard Christian Dumitrescu <eduard.c.dumitrescu@gmail.com>
 Maintainer-email: Eduard Christian Dumitrescu <eduard.c.dumitrescu@gmail.com>

{sqlalchemy_boltons-1.0.1 → sqlalchemy_boltons-1.1.0}/pyproject.toml

@@ -3,7 +3,7 @@ line-length = 120
 
 [project]
 name = "sqlalchemy_boltons"
-version = "1.0.1"
+version = "1.1.0"
 description = "Utilities that should've been inside SQLAlchemy but aren't"
 readme = "README.md"
 license = { text = "MIT" }

{sqlalchemy_boltons-1.0.1 → sqlalchemy_boltons-1.1.0}/src/sqlalchemy_boltons/sqlite.py

@@ -54,6 +54,16 @@ class SQLAlchemySqliteTransactionFix:
     This class exists because sqlalchemy doesn't automatically fix pysqlite's stupid default behaviour. Additionally,
     we implement support for foreign keys.
 
+    The execution options we look for are as follows:
+
+    - `x_sqlite_begin_mode`: The type of transaction to be started, such as "BEGIN" or
+      "[BEGIN IMMEDIATE](https://www.sqlite.org/lang_transaction.html)" (or
+      "[BEGIN CONCURRENT](https://www.sqlite.org/cgi/src/doc/begin-concurrent/doc/begin_concurrent.md)" someday maybe).
+    - `x_sqlite_foreign_keys`: The [foreign-key enforcement setting](https://www.sqlite.org/foreignkeys.html). Must be
+      `True`, `False`, or `"defer"`.
+    - `x_sqlite_journal_mode`: The [journal mode](https://www.sqlite.org/pragma.html#pragma_journal_mode) such as
+      `"DELETE"` or `"WAL"`. Optional.
+
     https://docs.sqlalchemy.org/en/20/dialects/sqlite.html#serializable-isolation-savepoints-transactional-ddl
     """
 
@@ -188,6 +198,9 @@ def create_engine_sqlite(
     # always default to QueuePool
     if (k := "poolclass") not in create_engine_args:
         create_engine_args[k] = sap.QueuePool
+        if (k := "max_overflow") not in create_engine_args:
+            # for SQLite it doesn't make sense to restrict the number of concurrent (read-only) connections
+            create_engine_args["max_overflow"] = -1
 
     if (v := create_engine_args.get(k := "connect_args")) is None:
         create_engine_args[k] = v = {}

{sqlalchemy_boltons-1.0.1 → sqlalchemy_boltons-1.1.0}/src/sqlalchemy_boltons.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sqlalchemy-boltons
-Version: 1.0.1
+Version: 1.1.0
 Summary: Utilities that should've been inside SQLAlchemy but aren't
 Author-email: Eduard Christian Dumitrescu <eduard.c.dumitrescu@gmail.com>
 Maintainer-email: Eduard Christian Dumitrescu <eduard.c.dumitrescu@gmail.com>

{sqlalchemy_boltons-1.0.1 → sqlalchemy_boltons-1.1.0}/tests/test_sqlite.py

@@ -54,7 +54,9 @@ def simple_sqlite_engine(tmp_path, database_type):
     else:
         raise AssertionError
 
-    return _sq.create_engine_sqlite(path, journal_mode="WAL", timeout=0.5, create_engine_args={"echo": True})
+    return _sq.create_engine_sqlite(
+        path, journal_mode="WAL", timeout=0.5, create_engine_args={"echo": True, "pool_timeout": 2}
+    )
 
 
 @pytest.mark.parametrize("database_type", ["file", "memory"])
@@ -117,6 +119,12 @@ def test_transaction(simple_sqlite_engine, database_type):
         assert len(s.execute(sa.select(Example)).all()) == 2
         s.commit()
 
+    with contextlib.ExitStack() as exit_stack:
+        # concurrent connection count
+        for i in range(30):
+            exit_stack.enter_context(s := SessionR())
+            assert len(s.execute(sa.select(Example)).all()) == 2
+
 
 @pytest.mark.parametrize("path_type", ["str", "Path"])
 def test_create_engine_path(tmp_path, path_type):