Author: cito
Date: Tue Feb 9 14:03:23 2016
New Revision: 850
Log:
Add note regarding SQLAlchemy
Modified:
trunk/docs/conf.py
trunk/docs/contents/changelog.rst
trunk/docs/contents/general.rst
Modified: trunk/docs/conf.py
==============================================================================
--- trunk/docs/conf.py Tue Feb 9 08:14:26 2016 (r849)
+++ trunk/docs/conf.py Tue Feb 9 14:03:23 2016 (r850)
@@ -95,6 +95,8 @@
'community/mailinglist.rst', 'community/source.rst',
'community/bugtracker.rst', 'community/support.rst',
'community/homes.rst']
+if use_cloud_theme:
+ exclude_patterns += ['about.rst']
# The reST default role (used for this markup: `text`) for all documents.
#default_role = None
Modified: trunk/docs/contents/changelog.rst
==============================================================================
--- trunk/docs/contents/changelog.rst Tue Feb 9 08:14:26 2016 (r849)
+++ trunk/docs/contents/changelog.rst Tue Feb 9 14:03:23 2016 (r850)
@@ -97,6 +97,7 @@
- SQL commands are always handled as if they include parameters, i.e.
literal percent signs must always be doubled. This consistent behavior
is necessary for using pgdb with wrappers like SQLAlchemy.
+ - PyGreSQL 5.0 will be supported as a database driver by SQLAlchemy 1.1.
- Changes concerning both modules:
- PyGreSQL now tries to raise more specific and appropriate subclasses of
DatabaseError than just ProgrammingError. Particularly, when database
Modified: trunk/docs/contents/general.rst
==============================================================================
--- trunk/docs/contents/general.rst Tue Feb 9 08:14:26 2016 (r849)
+++ trunk/docs/contents/general.rst Tue Feb 9 14:03:23 2016 (r850)
@@ -33,3 +33,11 @@
Note that PyGreSQL is not thread-safe on the connection level. Therefore
we recommend using `DBUtils <http://www.webwareforpython.org/DBUtils>`_
for multi-threaded environments, which supports both PyGreSQL interfaces.
+
+Another option is using PyGreSQL indirectly as a database driver for the
+high-level `SQLAlchemy <http://www.sqlalchemy.org/>`_ SQL toolkit and ORM,
+which supports PyGreSQL starting with SQLAlchemy 1.1 and which provides a
+way to use PyGreSQL in a multi-threaded environment using the concept of
+"thread local storage". Database URLs for PyGreSQL take this form::
+
+ postgresql+pygresql://username:password@host:port/database
_______________________________________________
PyGreSQL mailing list
[email protected]
https://mail.vex.net/mailman/listinfo.cgi/pygresql
