ats_utilities.factory_context_error module

Module

factory_context_error.py

Copyright

Copyright (C) 2017 - 2026 Vladimir Roncevic <elektron.ronca@gmail.com> ats_utilities is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. ats_utilities is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

Info

Defines factory context error utility functions.

ats_utilities.factory_context_error.raise_context_error(fallback_prefix: str, fallback_msg: str, exc_message_path: str | None = None, exception_class: type[Exception] = <class 'ats_utilities.exceptions.ats_value_error.ATSValueError'>, depth: int = 2) → None[source]

Raises a contextual exception using caller context from the specified stack depth.

Parameters:

  • fallback_prefix (<str>) – Prefix to use in the exception message if no path is provided.

  • fallback_msg (<str>) – Message to include in the exception message if no path is provided.

  • exc_message_path (<str | None>) – Path and details to include in the exception message.

  • exception_class (<type[Exception]>) – The exception class to raise.

  • depth (<int>) – Stack depth to inspect.

Exceptions:
Dynamically raises the provided exception_class (e.g., ATSValueError).