summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2015-04-30 17:35:52 -0400
committerMike Bayer <mike_mp@zzzcomputing.com>2015-04-30 17:43:53 -0400
commitd26c18bd9dcb78fb2689c47f127cced687af4d35 (patch)
tree7448ed6552fb73068a105d4e6a1a2d485e24051d
parent2d64bd39ea2ce79cc28a7b42ca5d57f68636c729 (diff)
downloadsqlalchemy-ticket_3355.tar.gz
- new features will be in 1.0.3ticket_3355
-rw-r--r--doc/build/changelog/changelog_10.rst60
-rw-r--r--lib/sqlalchemy/engine/interfaces.py6
-rw-r--r--lib/sqlalchemy/events.py4
-rw-r--r--lib/sqlalchemy/pool.py4
4 files changed, 37 insertions, 37 deletions
diff --git a/doc/build/changelog/changelog_10.rst b/doc/build/changelog/changelog_10.rst
index 5fe587681..fe5c7a744 100644
--- a/doc/build/changelog/changelog_10.rst
+++ b/doc/build/changelog/changelog_10.rst
@@ -19,6 +19,36 @@
:version: 1.0.3
.. change::
+ :tags: feature, engine
+ :tickets: 3379
+
+ New features added to support engine/pool plugins with advanced
+ functionality. Added a new "soft invalidate" feature to the
+ connection pool at the level of the checked out connection wrapper
+ as well as the :class:`._ConnectionRecord`. This works similarly
+ to a modern pool invalidation in that connections aren't actively
+ closed, but are recycled only on next checkout; this is essentially
+ a per-connection version of that feature. A new event
+ :class:`.PoolEvents.soft_invalidate` is added to complement it.
+
+ Also added new flag
+ :attr:`.ExceptionContext.invalidate_pool_on_disconnect`.
+ Allows an error handler within :meth:`.ConnectionEvents.handle_error`
+ to maintain a "disconnect" condition, but to handle calling invalidate
+ on individual connections in a specific manner within the event.
+
+ .. change::
+ :tags: feature, engine
+ :tickets: 3355
+
+ Added new event :class:`.DialectEvents.do_connect`, which allows
+ interception / replacement of when the :meth:`.Dialect.connect`
+ hook is called to create a DBAPI connection. Also added
+ dialect plugin hooks :meth:`.Dialect.get_dialect_cls` and
+ :meth:`.Dialect.engine_created` which allow external plugins to
+ add events to existing dialects using entry points.
+
+ .. change::
:tags: bug, orm
:tickets: 3403, 3320
@@ -305,36 +335,6 @@
.. change::
- :tags: feature, engine
- :tickets: 3379
-
- New features added to support engine/pool plugins with advanced
- functionality. Added a new "soft invalidate" feature to the
- connection pool at the level of the checked out connection wrapper
- as well as the :class:`._ConnectionRecord`. This works similarly
- to a modern pool invalidation in that connections aren't actively
- closed, but are recycled only on next checkout; this is essentially
- a per-connection version of that feature. A new event
- :class:`.PoolEvents.soft_invalidate` is added to complement it.
-
- Also added new flag
- :attr:`.ExceptionContext.invalidate_pool_on_disconnect`.
- Allows an error handler within :meth:`.ConnectionEvents.handle_error`
- to maintain a "disconnect" condition, but to handle calling invalidate
- on individual connections in a specific manner within the event.
-
- .. change::
- :tags: feature, engine
- :tickets: 3355
-
- Added new event :class:`.DialectEvents.do_connect`, which allows
- interception / replacement of when the :meth:`.Dialect.connect`
- hook is called to create a DBAPI connection. Also added
- dialect plugin hooks :meth:`.Dialect.get_dialect_cls` and
- :meth:`.Dialect.engine_created` which allow external plugins to
- add events to existing dialects using entry points.
-
- .. change::
:tags: bug, orm
:tickets: 3368
diff --git a/lib/sqlalchemy/engine/interfaces.py b/lib/sqlalchemy/engine/interfaces.py
index ee04a6974..2dd192162 100644
--- a/lib/sqlalchemy/engine/interfaces.py
+++ b/lib/sqlalchemy/engine/interfaces.py
@@ -744,7 +744,7 @@ class Dialect(object):
By default this just returns the cls.
- .. versionadded:: 1.0.1
+ .. versionadded:: 1.0.3
"""
return cls
@@ -763,7 +763,7 @@ class Dialect(object):
events to the engine or its components. In particular, it allows
a dialect-wrapping class to apply dialect-level events.
- .. versionadded:: 1.0.1
+ .. versionadded:: 1.0.3
"""
pass
@@ -1135,6 +1135,6 @@ class ExceptionContext(object):
the invalidation of other connections in the pool is to be performed
based on other conditions, or even on a per-connection basis.
- .. versionadded:: 1.0.1
+ .. versionadded:: 1.0.3
""" \ No newline at end of file
diff --git a/lib/sqlalchemy/events.py b/lib/sqlalchemy/events.py
index dcca9cdee..b2d4b54a9 100644
--- a/lib/sqlalchemy/events.py
+++ b/lib/sqlalchemy/events.py
@@ -405,7 +405,7 @@ class PoolEvents(event.Events):
is checked in. It does not actively close the dbapi_connection
at the point at which it is called.
- .. versionadded:: 1.0.1
+ .. versionadded:: 1.0.3
"""
@@ -1047,7 +1047,7 @@ class DialectEvents(event.Events):
to allow the dialect to connect normally, given the updated
arguments.
- .. versionadded:: 1.0.1
+ .. versionadded:: 1.0.3
"""
diff --git a/lib/sqlalchemy/pool.py b/lib/sqlalchemy/pool.py
index 7e023b992..902309d75 100644
--- a/lib/sqlalchemy/pool.py
+++ b/lib/sqlalchemy/pool.py
@@ -518,7 +518,7 @@ class _ConnectionRecord(object):
:param soft: if True, the connection isn't closed; instead, this
connection will be recycled on next checkout.
- .. versionadded:: 1.0.1
+ .. versionadded:: 1.0.3
.. seealso::
@@ -806,7 +806,7 @@ class _ConnectionFairy(object):
:param soft: if True, the connection isn't closed; instead, this
connection will be recycled on next checkout.
- .. versionadded:: 1.0.1
+ .. versionadded:: 1.0.3
.. seealso::