Warning: This document is for the development version of molten.

Source code for molten.errors

# This file is a part of molten.
#
# Copyright (C) 2018 CLEARTYPE SRL <bogdan@cleartype.io>
#
# molten is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or (at
# your option) any later version.
#
# molten 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 Lesser General Public
# License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.

from typing import Any, Dict


[docs]class MoltenError(Exception): """Base class for all Molten exceptions. """ __slots__ = ["status"] def __init__(self, message: str) -> None: self.message = message def __str__(self) -> str: return self.message
[docs]class DIError(MoltenError): """Raised when a dependency cannot be resolved. """
[docs]class HTTPError(MoltenError): """Base class for HTTP errors. Handlers and middleware can raise these to short-circuit execution. """ __slots__ = ["status", "response", "headers"] def __init__(self, status: str, response: Any, headers: Any = None) -> None: self.status = status self.response = response self.headers = headers or {} def __str__(self) -> str: # pragma: no cover return self.status
[docs]class RouteNotFound(MoltenError): """Raised when trying to reverse route to a route that doesn't exist. """
[docs]class RouteParamMissing(MoltenError): """Raised when a param is missing while reversing a route. """
class RequestHandled(MoltenError): """Signals to the WSGI implementation that start_response was already called within a request handler. This is useful when implementing connection upgrades. """
[docs]class RequestParserNotAvailable(MoltenError): """Raised when no request parser can handle the incoming request. """
[docs]class ParseError(MoltenError): """Raised by parsers when the input data cannot be parsed. """
[docs]class FieldTooLarge(ParseError): """Raised by MultiPartParser when a field exceeds the maximum field size limit. """
[docs]class FileTooLarge(ParseError): """Raised by MultiPartParser when a file exceeds the maximum file size limit. """
[docs]class TooManyFields(ParseError): """Raised by MultiPartParser when the input contains too many fields. """
[docs]class HeaderMissing(MoltenError): """Raised by Headers.__getitem__ when a header does not exist. """
[docs]class ParamMissing(MoltenError): """Raised by QueryParams.__getitem__ when a param is missing. """
[docs]class ValidationError(MoltenError): """Raised by validator.load when the input data is invalid. """ def __init__(self, reasons: Dict[str, Any]) -> None: self.reasons = reasons def __str__(self) -> str: # pragma: no cover return str(self.reasons)
[docs]class FieldValidationError(MoltenError): """Raised by Field.validate when a given value is invalid. """