Package wtf :: Package ext :: Package db :: Module _connection
[hide private]
[frames] | no frames]

Module _connection

source code

DB stuff.


Author: André Malo

Functions [hide private]
module
driver(dbname)
Determine driver module
source code
connection object (DBAPI 2)
connect(dbname, **kwargs)
Connect to database
source code
 
configure(dbconf=None, unpack_password=None)
Configure the databases
source code
Variables [hide private]
  __package__ = 'wtf.ext.db'
Function Details [hide private]

driver(dbname)

source code 
Determine driver module
Parameters:
  • dbname (str) - DB name (section token in db.conf)
Returns: module
Driver module
Raises:
  • DBConfigurationError - DB not configured
  • KeyError - DB name not found
  • ImportError - Driver not found

connect(dbname, **kwargs)

source code 
Connect to database
Parameters:
  • dbname (str) - DB name (section token in db.conf)
  • kwargs (dict) - Additional parameters for adapter connect() call
Returns: connection object (DBAPI 2)
new connection
Raises:
  • DBConfigurationError - DB not configured
  • KeyError - DB name not found
  • ImportError - Driver not found

configure(dbconf=None, unpack_password=None)

source code 
Configure the databases
Parameters:
  • dbconf (str) - Config file name. If omitted or None, the environment variable WTF_EXT_DB_CONF is queried. If that's unset, too, it defaults to '/etc/wtf/ext/db.conf'.
  • unpack_password (callable) - Password unpacker. If omitted or None, no password unpacker is applied.
Raises: