turbogears.errorhandling

Module errorhandling

Functions

dispatch_error(controller, tg_source, tg_errors, tg_exceptions, *args, **kw)
Dispatch error.

_register_implicit_errh(controller, tg_source, tg_errors, tg_exceptions, *args, **kw)
Register implicitly declared error handler and re-dispatch.

source code

_register_implicit_exch(controller, tg_source, tg_errors, tg_exceptions, *args, **kw)
Register implicitly declared exception handler and re-dispatch.

source code

dispatch_error_adaptor(func)
Construct a signature isomorphic to dispatch_error.

source code

try_call(func, self, *args, **kw)
Call function, catch and dispatch any resulting exception.

source code

run_with_errors(errors, func, self, *args, **kw)
Branch execution depending on presence of errors.

source code

register_handler(handler=None, rules=None)
Register handler as an error handler for decorated method.

source code

bind_rules(pre_rules)
Prepend rules to error handler specialisation.

source code

error_handler(handler=None, rules=None)

source code

exception_handler(handler=None, rules=None)

source code

dispatch_failsafe(schema, values, errors, source, kw)
Dispatch fail-safe mechanism for failed inputs.

_failsafe_none(schema, values, errors, source, kw)
No fail-safe values.

source code

_failsafe_values_dict(schema, values, errors, source, kw)
Map erroneous inputs to values.

source code

_failsafe_values_atom(schema, values, errors, source, kw)
Map all erroneous inputs to a single value.

source code

_failsafe_map_errors(schema, values, errors, source, kw)
Map erroneous inputs to corresponding exceptions.

source code

_failsafe_defaults(schema, values, errors, source, kw)
Map erroneous inputs to method defaults.

source code

Variables

[hide private]

default = Signature()

FailsafeSchema = Enum('none', 'values', 'map_errors', 'defaults')

Function Details

[hide private]

dispatch_error(controller, tg_source, tg_errors, tg_exceptions, *args, **kw)

Dispatch error.

Error handler is a function registered via register_handler or if no such decorator was applied, the method triggering the error.

_register_implicit_errh(controller, tg_source, tg_errors, tg_exceptions, *args, **kw)

source code

Any method declaring tg_errors parameter is considered an implicitly declared error handler.

_register_implicit_exch(controller, tg_source, tg_errors, tg_exceptions, *args, **kw)

source code

Any method declaring tg_exceptions parameter is considered an implicitly declared exception handler.

dispatch_error_adaptor(func)

source code

Construct a signature isomorphic to dispatch_error.

The actual handler will receive only arguments explicitly declared.

register_handler(handler=None, rules=None)

source code

If handler is not given, method is considered it's own error handler.

rules can be a string containing an arbitrary logical Python expression to be used as dispatch rule allowing multiple error handlers for a single method.

register_handler decorator is an invariant.