diff options
author | Mike Bayer <mike_mp@zzzcomputing.com> | 2011-07-04 16:31:58 -0400 |
---|---|---|
committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2011-07-04 16:31:58 -0400 |
commit | 7c21b81cf8ec508c1b6ecc5f488960346ffac11f (patch) | |
tree | fc56c6bcc061b5e9df8d226492d0e597f0b12f4f /lib/sqlalchemy/orm/scoping.py | |
parent | 3daae3e5b6e54163452ed2aca15b300544daf455 (diff) | |
download | sqlalchemy-7c21b81cf8ec508c1b6ecc5f488960346ffac11f.tar.gz |
- fix pypostgresql typo, [ticket:2185]
- rewrite "getting a session" docs to delineate
all sessionmaker() use cases distinctly
- rewrite "Managing Transactions" doc to spell out
each specific step completely, [ticket:2204]
- add to create_engine() and main "engine" doc
an unambiguous statement that the create_engine()
does not create a connection
- other link fixes
- rewrite "deleting" section so that "deleting from collections"
is separate, well-described, [ticket:2202]
- rephrase "autocommit mode" into its own section, move it down,
put some bold text that you shouldn't be using it.
- simplify the "subtransactions" section and make it local to
"autocommit" since it is utterly unneeded by anybody.
- oracle is not doing 2-phase anytime soon
Diffstat (limited to 'lib/sqlalchemy/orm/scoping.py')
-rw-r--r-- | lib/sqlalchemy/orm/scoping.py | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/lib/sqlalchemy/orm/scoping.py b/lib/sqlalchemy/orm/scoping.py index 53e5e5d1f..815bda185 100644 --- a/lib/sqlalchemy/orm/scoping.py +++ b/lib/sqlalchemy/orm/scoping.py @@ -16,16 +16,16 @@ __all__ = ['ScopedSession'] class ScopedSession(object): """Provides thread-local management of Sessions. - - Usage:: - + + Typical invocation is via the :func:`.scoped_session` + function:: + Session = scoped_session(sessionmaker()) - ... use Session normally. - - The internal registry is accessible as well, + The internal registry is accessible, and by default is an instance of :class:`.ThreadLocalRegistry`. + See also: :ref:`unitofwork_contextual`. """ |