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

Module _tagged

source code

Tagged connection creation.


Author: André Malo

Functions [hide private]
str
dbname(tag)
Determine dbname from tag
source code
module
driver(tag)
Determine driver module
source code
Connection
connect(tag, **kwargs)
Connect and create a connection
source code
callable
connection(tag, arg=None, translate_exceptions=True)
Create decorator to inject connection into function
source code
callable
transaction(arg=None)
Create decorator to wrap a connection into a transaction
source code
 
register_connection_tag(tag, dbname)
Register a connection tag
source code
Variables [hide private]
dict _connection_tags = {}
Global tag mapping
  __package__ = 'wtf.ext.db'
Function Details [hide private]

dbname(tag)

source code 
Determine dbname from tag
Parameters:
  • tag (str) - Connection tag
Returns: str
DB name

driver(tag)

source code 
Determine driver module
Parameters:
  • tag (str) - Connection tag
Returns: module
Driver module
Raises:
  • DBConfigurationError - DB not configured
  • KeyError - DB name not found
  • ImportError - Driver not found

connect(tag, **kwargs)

source code 
Connect and create a connection
Parameters:
  • tag (str) - Connection tag
Returns: Connection
connection

connection(tag, arg=None, translate_exceptions=True)

source code 
Create decorator to inject connection into function
Parameters:
  • tag (str) - Connection tag
  • arg (str) - Argument name. If omitted or None, 'db' is used.
  • translate_exceptions (bool) - Translate adapter exceptions to our ones?
Returns: callable
Decorator function

transaction(arg=None)

source code 
Create decorator to wrap a connection into a transaction
Parameters:
  • arg (str) - Argument name. If omitted or None, 'db' is used.
Returns: callable
Decorator function

register_connection_tag(tag, dbname)

source code 
Register a connection tag
Parameters:
  • tag (str) - Tag name
  • dbname (str) - DB name string
Raises:
  • ValueError - Tag already defined with a different value