Package gavo :: Package utils :: Module excs

Module excs

Global exceptions for the GAVO data center software.

All exceptions escaping modules should inherit from Error in some way. Exceptions orginating in only one module should usually be defined there, exceptions should only be defined here if they are raised by more than one module.

Of course, for certain errors, built-in exceptions (e.g., NotImplemented or so) may be raised and propagated as well, but these should always signify internal bugs, never things a user should be confronted with under normal circumstances.

And then there's stuff like fancyconfig that's supposed to live independently of the rest. It's ok if those raise other Exceptions, but clearly there shouldn't be many of those, or error reporting will become an even worse nightmare than it already is.

Classes
	Error The base class for all exceptions that can be expected to escape a module.
	StructureError is raised if an error occurs during the construction of structures.
	LiteralParseError is raised if an attribute literal is somehow bad.
	RestrictedElement is raised when elements forbidden in restricted RDs are encountered when restricted parsing is in effect.
	BadCode is raised when some code could not be compiled.
	ValidationError is raised when the validation of a field fails.
	MultiplicityError is raised when a singleton is passed in multiple times or vice versa.
	SourceParseError is raised when some syntax error occurs during a source parse.
	DataError is raised when something is wrong with a data set.
	ReportableError is raised when something decides it can come up with an error message that should be presented to the user as-is.
	NotFoundError is raised when something is asked for something that does not exist.
	EmptyData is raised within certain protocols to signify a request was successful but yielded no data.
	RDNotFound is raised when an RD cannot be located.
	ExecutiveAction is a base class for exceptions that are supposed to break out of deep things and trigger actions higher up.
	SkipThis is caught in rsc.makeData.

Variables
	__package__ = `'gavo.utils'`