Package wtf :: Package ext :: Package db :: Module _tagged

[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

Parameters:

tag (str) - Tag name
dbname (str) - DB name string

Raises:

ValueError - Tag already defined with a different value