From: Michael Trier Date: Thu, 23 Oct 2008 01:47:44 +0000 (+0000) Subject: Included documentation about the defaults for create_session() and how they differ... X-Git-Tag: rel_0_5rc3~54 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c4da034f7e7ea2d25cee357b11576c4531aed52f;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git Included documentation about the defaults for create_session() and how they differ from sessionmaker(). Closes #1197. --- 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}