Exceptions

Exception Classes

Module:

pydplus.errors.exceptions

Synopsis:

Collection of exception classes relating to the pydplus library

Created By:

Jeff Shurtliff

Last Modified:

Jeff Shurtliff

Modified Date:

30 Mar 2026

exception pydplus.errors.exceptions.APIConnectionError(*args, **kwargs)

Bases: PyDPlusError

Exception used when the API query could not be completed due to connection aborts and/or timeouts.

exception pydplus.errors.exceptions.APIMethodError(*args, **kwargs)

Bases: PyDPlusError, ValueError

Exception used when an invalid API call method is used when performing an API call.

exception pydplus.errors.exceptions.APIRequestError(*args, **kwargs)

Bases: PyDPlusError

Exception used for generic API request errors when there is not a more specific exception.

exception pydplus.errors.exceptions.APIResponseConversionError(*args, **kwargs)

Bases: PyDPlusError

Exception used for errors when attempting to convert an API response to another data format. (e.g. JSON)

exception pydplus.errors.exceptions.CurrentlyUnsupportedError(*args, **kwargs)

Bases: PyDPlusError

Exception used when a feature or functionality being used is currently unsupported.

exception pydplus.errors.exceptions.DELETERequestError(*args, **kwargs)

Bases: PyDPlusError

Exception used for generic DELETE request errors when there is not a more specific exception.

exception pydplus.errors.exceptions.DataMismatchError(*args, **kwargs)

Bases: PyDPlusError

Exception used when there is a mismatch between two data sources.

exception pydplus.errors.exceptions.FeatureNotConfiguredError(*args, **kwargs)

Bases: PyDPlusError

Exception used when an API request fails because a feature is not configured.

exception pydplus.errors.exceptions.GETRequestError(*args, **kwargs)

Bases: PyDPlusError

Exception used for generic GET request errors when there is not a more specific exception.

exception pydplus.errors.exceptions.HelperFunctionNotFoundError(*args, **kwargs)

Bases: PyDPlusError

Exception used when a function referenced in the helper config file does not exist.

exception pydplus.errors.exceptions.IDPlusCredentialError(*args, **kwargs)

Bases: PyDPlusError

Exception used for RSA ID Plus legacy credential parsing and persistence errors.

exception pydplus.errors.exceptions.InvalidEndpointError(*args, **kwargs)

Bases: PyDPlusError

Exception used when an invalid API endpoint or service is provided.

exception pydplus.errors.exceptions.InvalidFieldError(*args, **kwargs)

Bases: PyDPlusError

Exception used when an invalid field is provided.

exception pydplus.errors.exceptions.InvalidHelperArgumentsError(*args, **kwargs)

Bases: PyDPlusError

Exception used when the helper function was called with arguments instead of keyword arguments.

exception pydplus.errors.exceptions.InvalidHelperFileTypeError(*args, **kwargs)

Bases: PyDPlusError, ValueError

Exception used when an invalid file type is provided for the helper file.

exception pydplus.errors.exceptions.InvalidLookupTypeError(*args, **kwargs)

Bases: PyDPlusError, ValueError

Exception used when an invalid API lookup type is provided.

exception pydplus.errors.exceptions.InvalidParameterError(*args, **kwargs)

Bases: PyDPlusError

Exception used when an invalid parameter is provided.

exception pydplus.errors.exceptions.InvalidPayloadValueError(*args, **kwargs)

Bases: PyDPlusError

Exception used when an invalid value is provided for a payload field.

exception pydplus.errors.exceptions.InvalidRequestTypeError(*args, **kwargs)

Bases: PyDPlusError, ValueError

Exception used when an invalid API request type is provided.

exception pydplus.errors.exceptions.InvalidURLError(*args, **kwargs)

Bases: PyDPlusError

Exception used when a provided URL is invalid.

exception pydplus.errors.exceptions.LookupMismatchError(*args, **kwargs)

Bases: PyDPlusError

Exception used when a lookup value does not match the supplied lookup type.

exception pydplus.errors.exceptions.MissingRequiredDataError(*args, **kwargs)

Bases: PyDPlusError

Exception used when a function or method is missing one or more required arguments.

exception pydplus.errors.exceptions.NotFoundResponseError(*args, **kwargs)

Bases: PyDPlusError

Exception used when an API query returns a 404 response and there is not a more specific class.

exception pydplus.errors.exceptions.PATCHRequestError(*args, **kwargs)

Bases: PyDPlusError

This exception is used for generic PATCH request errors when there is not a more specific exception.

exception pydplus.errors.exceptions.POSTRequestError(*args, **kwargs)

Bases: PyDPlusError

Exception used for generic POST request errors when there is not a more specific exception.

exception pydplus.errors.exceptions.PUTRequestError(*args, **kwargs)

Bases: PyDPlusError

Exception used for generic PUT request errors when there is not a more specific exception.

exception pydplus.errors.exceptions.PayloadMismatchError(*args, **kwargs)

Bases: PyDPlusError

Exception used when more than one payload is supplied for an API request.

exception pydplus.errors.exceptions.PyDPlusError

Bases: Exception

This is the base class for PyDPlus exceptions.

exception pydplus.errors.exceptions.UnknownFileTypeError(*args, **kwargs)

Bases: PyDPlusError

Exception used when a file type for a given file cannot be identified.

Handlers

Module:

pydplus.errors.handlers

Synopsis:

Functions that handle various error situations within the namespace

Created By:

Jeff Shurtliff

Last Modified:

Jeff Shurtliff

Modified Date:

22 Mar 2026

pydplus.errors.handlers.display_warning(message: str, *, category: ~typing.Type[Warning] = <class 'UserWarning'>, stacklevel: int = 2, log_warning: bool = False) → None

Emit a warning that points to the caller by default.

Parameters:

• message (str) – Warning message to emit

• category (type[Warning]) – Warning category class (default: UserWarning)

• stacklevel (int) – How far up the call stack to attribute the warning (2 by default - caller of this helper)

• log_warning (bool) – Also logs the warning using logger.warning() (False by default)

Returns:

None

pydplus.errors.handlers.get_exception_type(exc) → str

Return the exception type (e.g. RuntimeError, TypeError, etc.) for a given exception.

Returns:

The exception type as a string