Prepared version 1.0rc1 of DBUtils.

Author: Cito

DBUtils/Docs/UsersGuide.de.html

@@ -16,7 +16,7 @@ <h1 class="title">Benutzeranleitung für DBUtils</h1>
 <tbody valign="top">
 <tr><th class="docinfo-name">Version:</th>
 <td>1.0pre</td></tr>
-<tr class="field"><th class="docinfo-name">Released:</th><td class="field-body">09/25/08</td>
+<tr class="field"><th class="docinfo-name">Released:</th><td class="field-body">10/12/08</td>
 </tr>
 <tr class="field"><th class="docinfo-name">Translations:</th><td class="field-body"><a class="reference" href="UsersGuide.html">English</a> German <a class="reference" href="UsersGuide.zh.html">Chinese</a></td>
 </tr>
@@ -316,6 +316,10 @@ <h2><a id="id1" name="id1">PersistentDB</a></h2>
 <li><p class="first"><tt class="docutils literal"><span class="pre">closeable</span></tt>: wenn dies auf <tt class="docutils literal"><span class="pre">True</span></tt> gesetzt wird, dann wird das Schließen
 von Verbindungen erlaubt, normalerweise wird es jedoch ignoriert</p>
 </li>
+<li><p class="first"><tt class="docutils literal"><span class="pre">threadlocal</span></tt>: eine optionale Klasse zur Speicherung thread-lokaler Daten,
+die anstelle unserer Python-Implementierung benutzt wird (threading.local
+ist schneller, kann aber nicht in allen Fällen verwendet werden)</p>
+</li>
 <li><p class="first">Die als <tt class="docutils literal"><span class="pre">creator</span></tt> angegebene Funktion oder die Funktion <tt class="docutils literal"><span class="pre">connect</span></tt>
 des DB-API-2-Datenbankadapter-Moduls erhalten alle weiteren Parameter,
 wie <tt class="docutils literal"><span class="pre">host</span></tt>, <tt class="docutils literal"><span class="pre">database</span></tt>, <tt class="docutils literal"><span class="pre">user</span></tt>, <tt class="docutils literal"><span class="pre">password</span></tt> usw. Sie können einige
@@ -345,6 +349,10 @@ <h2><a id="id1" name="id1">PersistentDB</a></h2>
 Stattdessen wird die Verbindung automatisch dann geschlossen, wenn der Thread
 endet. Sie können dieses Verhalten ändern, indem Sie den Parameter namens
 <tt class="docutils literal"><span class="pre">closeable</span></tt> setzen.</p>
+<p>Beachten Sie, dass das Holen einer Verbindung etwas beschleunigt werden kann,
+indem Sie den Parameter <tt class="docutils literal"><span class="pre">threadlocal</span></tt> auf <tt class="docutils literal"><span class="pre">threading.local</span></tt> setzen; dies
+könnte aber in einigen Umgebungen nicht funktionieren (es ist zum Beispiel
+bekannt, dass <tt class="docutils literal"><span class="pre">mod_wsgi</span></tt> hier Probleme bereitet, da es Daten, die mit <tt class="docutils literal"><span class="pre">threading.local</span></tt> gespeichert wurden, zwischen Requests löscht).</p>
 </div>
 <div class="section">
 <h2><a id="id2" name="id2">PooledDB</a></h2>

DBUtils/Docs/UsersGuide.de.txt

@@ -2,7 +2,7 @@
 +++++++++++++++++++++++++++++
 
 :Version: 1.0pre
-:Released: 09/25/08
+:Released: 10/12/08
 :Translations: English_ German Chinese_
 
 .. _English: UsersGuide.html

DBUtils/Docs/UsersGuide.html

@@ -16,7 +16,7 @@ <h1 class="title">DBUtils User's Guide</h1>
 <tbody valign="top">
 <tr><th class="docinfo-name">Version:</th>
 <td>1.0pre</td></tr>
-<tr class="field"><th class="docinfo-name">Released:</th><td class="field-body">09/25/08</td>
+<tr class="field"><th class="docinfo-name">Released:</th><td class="field-body">10/12/08</td>
 </tr>
 <tr class="field"><th class="docinfo-name">Translations:</th><td class="field-body">English <a class="reference" href="UsersGuide.de.html">German</a> <a class="reference" href="UsersGuide.zh.html">Chinese</a></td>
 </tr>
@@ -296,6 +296,10 @@ <h2><a id="id1" name="id1">PersistentDB</a></h2>
 <li><p class="first"><tt class="docutils literal"><span class="pre">closeable</span></tt>: if this is set to true, then closing connections will
 be allowed, but by default this will be silently ignored</p>
 </li>
+<li><p class="first"><tt class="docutils literal"><span class="pre">threadlocal</span></tt>: an optional class for representing thread-local data
+that will be used instead of our Python implementation
+(threading.local is faster, but cannot be used in all cases)</p>
+</li>
 <li><p class="first">The creator function or the connect function of the DB-API 2 compliant
 database module specified as the creator will receive any additional
 parameters such as the host, database, user, password etc. You may
@@ -323,6 +327,10 @@ <h2><a id="id1" name="id1">PersistentDB</a></h2>
 contrary to the intent of having persistent connections. Instead,
 the connection will be automatically closed when the thread dies.
 You can change this behavior be setting the <tt class="docutils literal"><span class="pre">closeable</span></tt> parameter.</p>
+<p>Note that by setting the <tt class="docutils literal"><span class="pre">threadlocal</span></tt> parameter to <tt class="docutils literal"><span class="pre">threading.local</span></tt>,
+getting connections may become a bit faster, but this may not work in
+all environments (for instance, <tt class="docutils literal"><span class="pre">mod_wsgi</span></tt> is known to cause problems
+here since it clears the <tt class="docutils literal"><span class="pre">threading.local</span></tt> data between requests).</p>
 </div>
 <div class="section">
 <h2><a id="id2" name="id2">PooledDB</a></h2>

DBUtils/Docs/UsersGuide.txt

@@ -2,7 +2,7 @@
 ++++++++++++++++++++
 
 :Version: 1.0pre
-:Released: 09/25/08
+:Released: 10/12/08
 :Translations: English German_ Chinese_
 
 .. _German: UsersGuide.de.html

DBUtils/PersistentDB.py

@@ -102,7 +102,7 @@
 
 """
 
-__version__ = '1.0pre'
+__version__ = '1.0rc1'
 __revision__ = "$Rev$"
 __date__ = "$Date$"
 

DBUtils/PersistentPg.py

@@ -97,7 +97,7 @@
 
 """
 
-__version__ = '1.0pre'
+__version__ = '1.0rc1'
 __revision__ = "$Rev$"
 __date__ = "$Date$"
 

DBUtils/PooledDB.py

@@ -121,7 +121,7 @@
 
 """
 
-__version__ = '1.0pre'
+__version__ = '1.0rc1'
 __revision__ = "$Rev$"
 __date__ = "$Date$"
 

DBUtils/PooledPg.py

@@ -98,7 +98,7 @@
 
 """
 
-__version__ = '1.0pre'
+__version__ = '1.0rc1'
 __revision__ = "$Rev$"
 __date__ = "$Date$"
 

DBUtils/Properties.py

@@ -1,6 +1,6 @@
 name = 'DBUtils'
 
-version = (1, 0, 0, 'pre')
+version = (1, 0, 0, 'rc1')
 
 docs = [
 	{'name': "User's Guide", 'file': 'UsersGuide.html'},

DBUtils/SimplePooledDB.py

@@ -73,7 +73,7 @@
 
 """
 
-__version__ = '1.0pre'
+__version__ = '1.0rc1'
 __revision__ = "$Rev$"
 __date__ = "$Date$"