Update docs and add test for new config key SESSION_SQLALCHEMY_CREATE_TABLE

Author: jlgoolsbee

docs/config_reference.rst

@@ -174,6 +174,12 @@ SqlAlchemy
 
    Default: ``'sessions'``
 
+.. py:data:: SESSION_SQLALCHEMY_CREATE_TABLE
+    
+   Whether (or not) Flask-Session should manage creation of the table for storing session data.
+   
+   Default: ``True``
+
 .. py:data:: SESSION_SQLALCHEMY_SEQUENCE
     
    The name of the sequence you want to use for the primary key.

tests/test_sqlalchemy.py

@@ -57,3 +57,22 @@ def test_use_signer(self, app_utils):
                 json.loads(byte_string.decode("utf-8")) if byte_string else {}
             )
             assert stored_session.get("value") == "44"
+
+    @pytest.mark.filterwarnings("ignore:No valid SQLAlchemy instance provided")
+    def test_database_not_created_automatically(self, app_utils):
+        app = app_utils.create_app(
+            {
+                "SESSION_TYPE": "sqlalchemy",
+                "SQLALCHEMY_DATABASE_URI": "sqlite:///",
+                "SESSION_SQLALCHEMY_CREATE_TABLE": False,
+            }
+        )
+        with app.app_context() and self.setup_sqlalchemy(
+            app
+        ) and app.test_request_context():
+            assert isinstance(
+                flask.session,
+                SqlAlchemySession,
+            )
+            with pytest.raises(AssertionError):
+                app_utils.test_session(app)