# ==================================================================================================================== #
# #
# _____ _ _ _____ _ _ #
# _ __ _ |_ _|__ ___ | (_)_ __ __ _ | ____|_ _____ ___ _ __ | |_(_) ___ _ __ ___ #
# | '_ \| | | || |/ _ \ / _ \| | | '_ \ / _` | | _| \ \/ / __/ _ \ '_ \| __| |/ _ \| '_ \/ __| #
# | |_) | |_| || | (_) | (_) | | | | | | (_| |_| |___ > < (_| __/ |_) | |_| | (_) | | | \__ \ #
# | .__/ \__, ||_|\___/ \___/|_|_|_| |_|\__, (_)_____/_/\_\___\___| .__/ \__|_|\___/|_| |_|___/ #
# |_| |___/ |___/ |_| #
# ==================================================================================================================== #
# Authors: #
# Patrick Lehmann #
# #
# License: #
# ==================================================================================================================== #
# Copyright 2017-2024 Patrick Lehmann - Bötzingen, Germany #
# #
# Licensed under the Apache License, Version 2.0 (the "License"); #
# you may not use this file except in compliance with the License. #
# You may obtain a copy of the License at #
# #
# http://www.apache.org/licenses/LICENSE-2.0 #
# #
# Unless required by applicable law or agreed to in writing, software #
# distributed under the License is distributed on an "AS IS" BASIS, #
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. #
# See the License for the specific language governing permissions and #
# limitations under the License. #
# #
# SPDX-License-Identifier: Apache-2.0 #
# ==================================================================================================================== #
#
"""
A common set of missing exceptions in Python.
.. hint:: See :ref:`high-level help <EXECPTION>` for explanations and usage examples.
"""
from sys import version_info
from typing import List
try:
from pyTooling.Decorators import export
except (ImportError, ModuleNotFoundError): # pragma: no cover
print("[pyTooling.Exceptions] Could not import from 'pyTooling.*'!")
try:
from Decorators import export
except (ImportError, ModuleNotFoundError) as ex: # pragma: no cover
print("[pyTooling.Exceptions] Could not import from 'Decorators' directly!")
raise ex
[docs]
@export
class OverloadResolutionError(Exception):
"""
The exception is raised, when no matching overloaded method was found.
.. seealso::
:func:`@overloadable <pyTooling.MetaClasses.overloadable>`
|rarr| Mark a method as *overloadable*.
"""
# WORKAROUND: for Python <3.11
# Implementing a dummy method for Python versions before
__notes__: List[str]
if version_info < (3, 11): # pragma: no cover
def add_note(self, message: str):
try:
self.__notes__.append(message)
except AttributeError:
self.__notes__ = [message]
[docs]
@export
class ExceptionBase(Exception):
"""Base exception derived from :exc:`Exception <python:Exception>` for all custom exceptions."""
def __init__(self, message: str = "") -> None:
"""
ExceptionBase initializer.
:param message: The exception message.
"""
super().__init__()
self.message = message
# WORKAROUND: for Python <3.11
# Implementing a dummy method for Python versions before
__notes__: List[str]
if version_info < (3, 11): # pragma: no cover
def add_note(self, message: str):
try:
self.__notes__.append(message)
except AttributeError:
self.__notes__ = [message]
def __str__(self) -> str:
"""Returns the exception's message text."""
return self.message
def with_traceback(self, tb) -> None:
super().with_traceback(tb)
# @DocumentMemberAttribute(False)
# @MethodAlias(pyExceptions.with_traceback)
# def with_traceback(self): pass
[docs]
@export
class EnvironmentException(ExceptionBase):
"""The exception is raised when an expected environment variable is missing."""