db_pool: fix the doctests

This commit is contained in:
Denis Bilenko
2009-06-15 14:47:20 +07:00
parent 609bd2a071
commit 5eff030a7a

View File

@@ -27,6 +27,7 @@ The db_pool module is useful for managing database connections. It provides thr
A ConnectionPool object represents a pool of connections open to a particular database. The arguments to the constructor include the database-software-specific module, the host name, and the credentials required for authentication. After construction, the ConnectionPool object decides when to create and sever connections with the target database. A ConnectionPool object represents a pool of connections open to a particular database. The arguments to the constructor include the database-software-specific module, the host name, and the credentials required for authentication. After construction, the ConnectionPool object decides when to create and sever connections with the target database.
>>> import MySQLdb
>>> cp = ConnectionPool(MySQLdb, host='localhost', user='root', passwd='') >>> cp = ConnectionPool(MySQLdb, host='localhost', user='root', passwd='')
Once you have this pool object, you connect to the database by calling get() on it: Once you have this pool object, you connect to the database by calling get() on it:
@@ -37,20 +38,20 @@ This call may either create a new connection, or reuse an existing open connecti
>>> conn = cp.get() >>> conn = cp.get()
>>> try: >>> try:
>>> conn.cursor().execute('SELECT NOW()') ... result = conn.cursor().execute('SELECT NOW()')
>>> finally: ... finally:
>>> cp.put(conn) ... cp.put(conn)
or or
>>> conn = cp.get() >>> conn = cp.get()
>>> conn.cursor().execute('SELECT NOW()') >>> result = conn.cursor().execute('SELECT NOW()')
>>> conn.close() >>> conn.close()
or or
>>> conn = cp.get() >>> conn = cp.get()
>>> conn.cursor().execute('SELECT NOW()') >>> result = conn.cursor().execute('SELECT NOW()')
>>> del conn >>> del conn
Try/finally is the preferred method, because it has no reliance on __del__ being called by garbage collection. Try/finally is the preferred method, because it has no reliance on __del__ being called by garbage collection.
@@ -75,10 +76,8 @@ The constructor arguments:
* credentials : A dictionary, or dictionary-alike, mapping hostname to connection-argument-dictionary. This is used for the constructors of the ConnectionPool objects. Example: * credentials : A dictionary, or dictionary-alike, mapping hostname to connection-argument-dictionary. This is used for the constructors of the ConnectionPool objects. Example:
>>> dc = DatabaseConnector(MySQLdb, >>> dc = DatabaseConnector(MySQLdb,
{'db.internal.example.com': ... {'db.internal.example.com': {'user': 'internal', 'passwd': 's33kr1t'},
{'user':'internal', 'passwd':'s33kr1t'}, ... 'localhost': {'user': 'root', 'passwd': ''}})
'localhost':
{'user':'root', 'passwd':''})
If the credentials contain a host named 'default', then the value for 'default' is used whenever trying to connect to a host that has no explicit entry in the database. This is useful if there is some pool of hosts that share arguments. If the credentials contain a host named 'default', then the value for 'default' is used whenever trying to connect to a host that has no explicit entry in the database. This is useful if there is some pool of hosts that share arguments.