taucmdr.error module

TAU Commander error handling.

Only error base classes should be defined here. Error classes should be defined in their appropriate modules.

exception taucmdr.error.ConfigurationError(value, *hints)

Bases: Error

Indicates that TAU Commander cannot succeed with the given parameters.

This is most commonly caused by user error, e.g the user specifies measurement settings that are incompatible with the application.

message_fmt = '%(value)s\n\n%(hints)s\nTAU cannot proceed with the given inputs.\nPlease check the configuration for errors or contact %(contact)s for assistance.'

Format string for the error message.

exception taucmdr.error.Error(value, *hints)

Bases: Exception

Base class for all errors in TAU Commander.

value

Some value attached to the error, typically a string but could be anything with a __str__ method.

hints

String hints for the user to help resolve the error.

Type:

list

handle(etype, value, tb)

property message: str

Format the error message by combining the message template with hints and context fields.

message_fmt = "An unexpected %(typename)s exception was raised:\n\n%(value)s\n\n%(backtrace)s\nThis is a bug in TAU Commander.\nPlease send '%(logfile)s' to %(contact)s for assistance."

Format string for the error message.

show_backtrace = False

Set to True to include a backtrace in the error message.

exception taucmdr.error.ExperimentSelectionError(value, *hints)

Bases: ConfigurationError

Indicates an error while selecting an experiment.

exception taucmdr.error.ImmutableRecordError(value, *hints)

Bases: ConfigurationError

Indicates that a data record cannot be modified.

exception taucmdr.error.IncompatibleRecordError(value, *hints)

Bases: ConfigurationError

Indicates that a pair of data records are incompatible.

exception taucmdr.error.InternalError(value, *hints)

Bases: Error

Indicates that an internal error has occurred, i.e. a bug in TAU.

These are bad and really shouldn’t happen.

show_backtrace = True

Set to True to include a backtrace in the error message.

exception taucmdr.error.ModelError(model, value)

Bases: InternalError

Indicates an error in model data or the model itself.

exception taucmdr.error.ProjectSelectionError(value, *hints)

Bases: ConfigurationError

Indicates an error while selecting a project.

exception taucmdr.error.UniqueAttributeError(model, unique)

Bases: ModelError

Indicates that duplicate values were given for a unique attribute.

taucmdr.error.excepthook(etype, value, tb)

Exception handler for any uncaught exception (except SystemExit).

Replaces sys.excepthook.

Parameters:

• etype – Exception class.

• value – Exception instance.

• tb – Traceback object.