From c4da034f7e7ea2d25cee357b11576c4531aed52f Mon Sep 17 00:00:00 2001 From: Michael Trier Date: Thu, 23 Oct 2008 01:47:44 +0000 Subject: [PATCH] Included documentation about the defaults for create_session() and how they differ from sessionmaker(). Closes #1197. --- doc/build/content/session.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/build/content/session.txt b/doc/build/content/session.txt index 7f8d06f906..4081aa8d72 100644 --- a/doc/build/content/session.txt +++ b/doc/build/content/session.txt @@ -90,6 +90,8 @@ As an alternative to `sessionmaker()`, `create_session()` is a function which ca Configurational arguments accepted by `sessionmaker()` and `create_session()` are the same as that of the `Session` class itself, and are described at [docstrings_sqlalchemy.orm_modfunc_sessionmaker](rel:docstrings_sqlalchemy.orm_modfunc_sessionmaker). +Note that the defaults of `create_session()` are the opposite of that of `sessionmaker()`: autoflush and expire_on_commit are False, autocommit is True. It is recommended to use the `sessionmaker()` function instead of `create_session()`. `create_session()` is used to get a session with no automation turned on and is useful for testing. + ## Using the Session ### Quickie Intro to Object States {@name=states} -- 2.47.3