lsst.pex.exceptions.wrappers Namespace Reference

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

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

Variables
dictionary	registry = {}

Function Documentation

declare()

def 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()

def 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()

def 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

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

Definition at line 33 of file wrappers.py.