lsst.pex.exceptions.wrappers Namespace Reference

Classes
class	DomainError
class	Exception
class	ExceptionMeta
class	InvalidParameterError
class	IoError
class	LengthError
class	LogicError
class	NotFoundError
class	OutOfRangeError
class	OverflowError
class	RangeError
class	RuntimeError
class	TypeError
class	UnderflowError

Functions
	register (cls)
	translate (cpp)
	declare (module, exception_name, base, wrapped_class)

Variables
dict	registry = {}

Function Documentation

declare()

lsst.pex.exceptions.wrappers.declare	(		module,
			exception_name,
			base,
			wrapped_class )

Declare a new exception.

Definition at line 153 of file wrappers.py.

def declare(module, exception_name, base, wrapped_class):
    """Declare a new exception."""
    setattr(module, exception_name, register(ExceptionMeta(exception_name, (base, ),
                                                           dict(WrappedClass=wrapped_class))))

register()

lsst.pex.exceptions.wrappers.register

(

cls

)

A Python decorator that adds a Python exception wrapper to the registry that maps C++ Exceptions
to their Python wrapper classes.

Definition at line 36 of file wrappers.py.

def register(cls):
    """A Python decorator that adds a Python exception wrapper to the registry that maps C++ Exceptions
    to their Python wrapper classes.
    """
    registry[cls.WrappedClass] = cls
    return cls
 
 

translate()

lsst.pex.exceptions.wrappers.translate

(

cpp

)

Translate a C++ Exception instance to Python and return it.

Definition at line 144 of file wrappers.py.

def translate(cpp):
    """Translate a C++ Exception instance to Python and return it."""
    PyType = registry.get(type(cpp), None)
    if PyType is None:
        warnings.warn("Could not find appropriate Python type for C++ Exception")
        PyType = Exception
    return PyType(cpp)
 
 

Variable Documentation

registry

dict lsst.pex.exceptions.wrappers.registry = {}

Definition at line 33 of file wrappers.py.