icat.exception — Exception handling

Helper

icat.exception.stripCause(e)

Try to suppress misleading context from an exception.

Exception Chaining and Embedded Tracebacks has been introduced with Python 3. Unfortunately the result is completely misleading most of the times. Try to suppress the context from the exception traceback. This works with Python 3.3 and newer, but has no effect with Python 3.1 and 3.2.

Exceptions thrown by the ICAT or IDS server

exception icat.exception.ServerError(error, status)

Bases: exceptions.Exception

Errors raised by either the ICAT or the IDS server.

This is the common base class for icat.exception.ICATError and icat.exception.IDSError, it is not intented to be raised directly.

exception icat.exception.ICATError(error, status)

Bases: icat.exception.ServerError

Base class for the errors raised by the ICAT server.

exception icat.exception.ICATParameterError(error, status)

Bases: icat.exception.ICATError

Generally indicates a problem with the arguments made to a call.

exception icat.exception.ICATInternalError(error, status)

Bases: icat.exception.ICATError

May be caused by network problems, database problems, GlassFish problems or bugs in ICAT.

exception icat.exception.ICATPrivilegesError(error, status)

Bases: icat.exception.ICATError

Indicates that the authorization rules have not matched your request.

exception icat.exception.ICATNoObjectError(error, status)

Bases: icat.exception.ICATError

Is thrown when something is not found.

exception icat.exception.ICATObjectExistsError(error, status)

Bases: icat.exception.ICATError

Is thrown when trying to create something but there is already one with the same values of the constraint fields.

exception icat.exception.ICATSessionError(error, status)

Bases: icat.exception.ICATError

Is used when the sessionId you have passed into a call is not valid or if you are unable to authenticate.

exception icat.exception.ICATValidationError(error, status)

Bases: icat.exception.ICATError

Marks an exception which was thrown instead of placing the database in an invalid state.

exception icat.exception.ICATNotImplementedError(error, status)

Bases: icat.exception.ICATError

exception icat.exception.IDSError(error, status)

Bases: icat.exception.ServerError

Base class for the errors raised by the IDS server.

exception icat.exception.IDSBadRequestError(error, status)

Bases: icat.exception.IDSError

Any kind of bad input parameter.

exception icat.exception.IDSDataNotOnlineError(error, status)

Bases: icat.exception.IDSError

The requested data are not on line.

exception icat.exception.IDSInsufficientPrivilegesError(error, status)

Bases: icat.exception.IDSError

You are denied access to the data.

exception icat.exception.IDSInsufficientStorageError(error, status)

Bases: icat.exception.IDSError

There is not sufficient physical storage or you have exceeded some quota.

exception icat.exception.IDSInternalError(error, status)

Bases: icat.exception.IDSError

Some kind of failure in the server or in communicating with the server.

exception icat.exception.IDSNotFoundError(error, status)

Bases: icat.exception.IDSError

The requested data do not exist.

exception icat.exception.IDSNotImplementedError(error, status)

Bases: icat.exception.IDSError

Use of some functionality that is not supported by the implementation.

icat.exception.translateError(error, status=None, server='ICAT')

Translate an error from ICAT or IDS to the corresponding exception.

Exceptions thrown by python-icat

exception icat.exception.InternalError

Bases: exceptions.Exception

An error that reveals a bug in python-icat.

exception icat.exception.ConfigError

Bases: exceptions.Exception

Error getting configuration options.

exception icat.exception.QueryNullableOrderWarning(attr)

Bases: exceptions.Warning

Warn about using a nullable relation for ordering.

exception icat.exception.ClientVersionWarning(version=None, comment=None)

Bases: exceptions.Warning

Warn that the version of the ICAT server is not supported by the client.

exception icat.exception.ICATDeprecationWarning(feature, version=None)

Bases: exceptions.DeprecationWarning

Warn about using an API feature that may get removed in future ICAT server versions.

exception icat.exception.VersionMethodError(method, version=None, service='ICAT')

Bases: exceptions.Exception

Call of an API method that is not supported in the version of the server.

exception icat.exception.SearchResultError

Bases: exceptions.Exception

A search result does not conform to what should have been expected.

exception icat.exception.SearchAssertionError(query, assertmin, assertmax, num)

Bases: icat.exception.SearchResultError

A search result does not conform to an assertion.

This exception is thrown when the number of objects found on a search does not lie within the bounds of an assertion, see icat.client.Client.assertedSearch().

exception icat.exception.DataConsistencyError

Bases: exceptions.Exception

Some data is not consistent with rules or constraints.

exception icat.exception.IDSResponseError

Bases: exceptions.Exception

The response from the IDS was not what should have been expected.

exception icat.exception.GenealogyError

Bases: exceptions.Exception

Error in the genealogy of entity types.

Exception hierarchy

The class hierarchy for the exceptions is:

Exception
 +-- ServerError
 |    +-- ICATError
 |    |    +-- ICATParameterError
 |    |    +-- ICATInternalError
 |    |    +-- ICATPrivilegesError
 |    |    +-- ICATNoObjectError
 |    |    +-- ICATObjectExistsError
 |    |    +-- ICATSessionError
 |    |    +-- ICATValidationError
 |    |    +-- ICATNotImplementedError
 |    +-- IDSError
 |    |    +-- IDSBadRequestError
 |    |    +-- IDSDataNotOnlineError
 |    |    +-- IDSInsufficientPrivilegesError
 |    |    +-- IDSInsufficientStorageError
 |    |    +-- IDSInternalError
 |    |    +-- IDSNotFoundError
 |    |    +-- IDSNotImplementedError
 +-- InternalError
 +-- ConfigError
 +-- VersionMethodError
 +-- SearchResultError
 |    +-- SearchAssertionError
 +-- DataConsistencyError
 +-- IDSResponseError
 +-- GenealogyError
 +-- Warning
      +-- QueryNullableOrderWarning
      +-- ClientVersionWarning
      +-- DeprecationWarning
           +-- ICATDeprecationWarning

Here, Exception, Warning, and DeprecationWarning are build-in exceptions from the Python standard library.