ds_provider_mock_py_lib.errors
==============================

.. py:module:: ds_provider_mock_py_lib.errors

.. autoapi-nested-parse::

   **File:** ``errors.py``
   **Region:** ``ds_provider_mock_py_lib/errors``

   Mock backend exceptions and status-code helpers.

   .. rubric:: Example

   >>> from ds_provider_mock_py_lib.errors import MockBackendError, resolve_status_code
   >>> from ds_resource_plugin_py_lib.common.resource.linked_service.errors import LinkedServiceException
   >>> resolve_status_code(None, default=503)
   503
   >>> err = MockBackendError("boom", code="DS_LINKED_SERVICE_CONNECTION_ERROR", status_code=502)
   >>> err.status_code
   502
   >>> isinstance(err, LinkedServiceException)
   True



Exceptions
----------

.. autoapisummary::

   ds_provider_mock_py_lib.errors.MockBackendError


Functions
---------

.. autoapisummary::

   ds_provider_mock_py_lib.errors.resolve_status_code


Module Contents
---------------

.. py:exception:: MockBackendError(message: str = 'Mock backend operation failed', code: str = 'DS_LINKED_SERVICE_MOCK_ERROR', status_code: int = 500, details: dict[str, Any] | None = None)

   Bases: :py:obj:`ds_resource_plugin_py_lib.common.resource.linked_service.errors.LinkedServiceException`


   Failure raised by ``MockBackend.request()``.

   This is a linked-service contract error (``LinkedServiceException``).
   Dataset ``read()`` must wrap it as ``ReadError`` so it does not leak
   to dataset callers.


.. py:function:: resolve_status_code(status_code: int | None, default: int) -> int

   Return ``status_code`` when set, otherwise ``default``.

   :param status_code: Optional HTTP-style status code from settings.
   :param default: Fallback used when ``status_code`` is ``None``.

   :returns: A concrete integer status code.