factor out session utility functions

src/cs50/_session.py

@@ -1,11 +1,14 @@
 """Wraps a SQLAlchemy scoped session"""
 
-import os
-import sqlite3
-
 import sqlalchemy
 import sqlalchemy.orm
 
+from ._session_util import (
+    _is_sqlite_url,
+    _assert_sqlite_file_exists,
+    _create_session,
+)
+
 
 class Session:
     """Wraps a SQLAlchemy scoped session"""
@@ -23,61 +26,3 @@ def execute(self, statement):
 
     def __getattr__(self, attr):
         return getattr(self._session, attr)
-
-
-def _is_sqlite_url(url):
-    return url.startswith("sqlite:///")
-
-
-def _assert_sqlite_file_exists(url):
-    path = url[len("sqlite:///"):]
-    if not os.path.exists(path):
-        raise RuntimeError(f"does not exist: {path}")
-    if not os.path.isfile(path):
-        raise RuntimeError(f"not a file: {path}")
-
-
-def _create_session(url, **engine_kwargs):
-    engine = _create_engine(url, **engine_kwargs)
-    _setup_on_connect(engine)
-    return _create_scoped_session(engine)
-
-
-def _create_engine(url, **kwargs):
-    try:
-        engine = sqlalchemy.create_engine(url, **kwargs)
-    except sqlalchemy.exc.ArgumentError:
-        raise RuntimeError(f"invalid URL: {url}") from None
-
-    engine.execution_options(autocommit=False)
-    return engine
-
-
-def _setup_on_connect(engine):
-    def connect(dbapi_connection, _):
-        _disable_auto_begin_commit(dbapi_connection)
-        if _is_sqlite_connection(dbapi_connection):
-            _enable_sqlite_foreign_key_constraints(dbapi_connection)
-
-    sqlalchemy.event.listen(engine, "connect", connect)
-
-
-def _create_scoped_session(engine):
-    session_factory = sqlalchemy.orm.sessionmaker(bind=engine)
-    return sqlalchemy.orm.scoping.scoped_session(session_factory)
-
-
-def _disable_auto_begin_commit(dbapi_connection):
-    # Disable underlying API's own emitting of BEGIN and COMMIT so we can ourselves
-    # https://docs.sqlalchemy.org/en/13/dialects/sqlite.html#serializable-isolation-savepoints-transactional-ddl
-    dbapi_connection.isolation_level = None
-
-
-def _is_sqlite_connection(dbapi_connection):
-    return isinstance(dbapi_connection, sqlite3.Connection)
-
-
-def _enable_sqlite_foreign_key_constraints(dbapi_connection):
-    cursor = dbapi_connection.cursor()
-    cursor.execute("PRAGMA foreign_keys=ON")
-    cursor.close()

src/cs50/_session_util.py

@@ -0,0 +1,63 @@
+"""Utility functions used by _session.py"""
+
+import os
+import sqlite3
+
+import sqlalchemy
+
+def _is_sqlite_url(url):
+    return url.startswith("sqlite:///")
+
+
+def _assert_sqlite_file_exists(url):
+    path = url[len("sqlite:///"):]
+    if not os.path.exists(path):
+        raise RuntimeError(f"does not exist: {path}")
+    if not os.path.isfile(path):
+        raise RuntimeError(f"not a file: {path}")
+
+
+def _create_session(url, **engine_kwargs):
+    engine = _create_engine(url, **engine_kwargs)
+    _setup_on_connect(engine)
+    return _create_scoped_session(engine)
+
+
+def _create_engine(url, **kwargs):
+    try:
+        engine = sqlalchemy.create_engine(url, **kwargs)
+    except sqlalchemy.exc.ArgumentError:
+        raise RuntimeError(f"invalid URL: {url}") from None
+
+    engine.execution_options(autocommit=False)
+    return engine
+
+
+def _setup_on_connect(engine):
+    def connect(dbapi_connection, _):
+        _disable_auto_begin_commit(dbapi_connection)
+        if _is_sqlite_connection(dbapi_connection):
+            _enable_sqlite_foreign_key_constraints(dbapi_connection)
+
+    sqlalchemy.event.listen(engine, "connect", connect)
+
+
+def _create_scoped_session(engine):
+    session_factory = sqlalchemy.orm.sessionmaker(bind=engine)
+    return sqlalchemy.orm.scoping.scoped_session(session_factory)
+
+
+def _disable_auto_begin_commit(dbapi_connection):
+    # Disable underlying API's own emitting of BEGIN and COMMIT so we can ourselves
+    # https://docs.sqlalchemy.org/en/13/dialects/sqlite.html#serializable-isolation-savepoints-transactional-ddl
+    dbapi_connection.isolation_level = None
+
+
+def _is_sqlite_connection(dbapi_connection):
+    return isinstance(dbapi_connection, sqlite3.Connection)
+
+
+def _enable_sqlite_foreign_key_constraints(dbapi_connection):
+    cursor = dbapi_connection.cursor()
+    cursor.execute("PRAGMA foreign_keys=ON")
+    cursor.close()