Source code for h2.exceptions

# -*- coding: utf-8 -*-
"""
h2/exceptions
~~~~~~~~~~~~~

Exceptions for the HTTP/2 module.
"""
import h2.errors


[docs]class H2Error(Exception): """ The base class for all exceptions for the HTTP/2 module. """
[docs]class ProtocolError(H2Error): """ An action was attempted in violation of the HTTP/2 protocol. """ #: The error code corresponds to this kind of Protocol Error. error_code = h2.errors.ErrorCodes.PROTOCOL_ERROR
[docs]class FrameTooLargeError(ProtocolError): """ The frame that we tried to send or that we received was too large. """ #: The error code corresponds to this kind of Protocol Error. error_code = h2.errors.ErrorCodes.FRAME_SIZE_ERROR
[docs]class FrameDataMissingError(ProtocolError): """ The frame that we received is missing some data. .. versionadded:: 2.0.0 """ #: The error code corresponds to this kind of Protocol Error. error_code = h2.errors.ErrorCodes.FRAME_SIZE_ERROR
[docs]class TooManyStreamsError(ProtocolError): """ An attempt was made to open a stream that would lead to too many concurrent streams. """ pass
[docs]class FlowControlError(ProtocolError): """ An attempted action violates flow control constraints. """ #: The error code corresponds to this kind of Protocol Error. error_code = h2.errors.ErrorCodes.FLOW_CONTROL_ERROR
[docs]class StreamIDTooLowError(ProtocolError): """ An attempt was made to open a stream that had an ID that is lower than the highest ID we have seen on this connection. """ def __init__(self, stream_id, max_stream_id): #: The ID of the stream that we attempted to open. self.stream_id = stream_id #: The current highest-seen stream ID. self.max_stream_id = max_stream_id def __str__(self): return "StreamIDTooLowError: %d is lower than %d" % ( self.stream_id, self.max_stream_id )
[docs]class NoAvailableStreamIDError(ProtocolError): """ There are no available stream IDs left to the connection. All stream IDs have been exhausted. .. versionadded:: 2.0.0 """ pass
[docs]class NoSuchStreamError(ProtocolError): """ A stream-specific action referenced a stream that does not exist. .. versionchanged:: 2.0.0 Became a subclass of :class:`ProtocolError <h2.exceptions.ProtocolError>` """ def __init__(self, stream_id): #: The stream ID corresponds to the non-existent stream. self.stream_id = stream_id
[docs]class StreamClosedError(NoSuchStreamError): """ A more specific form of :class:`NoSuchStreamError <h2.exceptions.NoSuchStreamError>`. Indicates that the stream has since been closed, and that all state relating to that stream has been removed. """ def __init__(self, stream_id): #: The stream ID corresponds to the nonexistent stream. self.stream_id = stream_id #: The relevant HTTP/2 error code. self.error_code = h2.errors.ErrorCodes.STREAM_CLOSED # Any events that internal code may need to fire. Not relevant to # external users that may receive a StreamClosedError. self._events = []
[docs]class InvalidSettingsValueError(ProtocolError, ValueError): """ An attempt was made to set an invalid Settings value. .. versionadded:: 2.0.0 """ def __init__(self, msg, error_code): super(InvalidSettingsValueError, self).__init__(msg) self.error_code = error_code
[docs]class InvalidBodyLengthError(ProtocolError): """ The remote peer sent more or less data that the Content-Length header indicated. .. versionadded:: 2.0.0 """ def __init__(self, expected, actual): self.expected_length = expected self.actual_length = actual def __str__(self): return "InvalidBodyLengthError: Expected %d bytes, received %d" % ( self.expected_length, self.actual_length )
[docs]class UnsupportedFrameError(ProtocolError): """ The remote peer sent a frame that is unsupported in this context. .. versionadded:: 2.1.0 .. versionchanged:: 4.0.0 Removed deprecated KeyError parent class. """ pass
[docs]class RFC1122Error(H2Error): """ Emitted when users attempt to do something that is literally allowed by the relevant RFC, but is sufficiently ill-defined that it's unwise to allow users to actually do it. While there is some disagreement about whether or not we should be liberal in what accept, it is a truth universally acknowledged that we should be conservative in what emit. .. versionadded:: 2.4.0 """ # shazow says I'm going to regret naming the exception this way. If that # turns out to be true, TELL HIM NOTHING. pass
[docs]class DenialOfServiceError(ProtocolError): """ Emitted when the remote peer exhibits a behaviour that is likely to be an attempt to perform a Denial of Service attack on the implementation. This is a form of ProtocolError that carries a different error code, and allows more easy detection of this kind of behaviour. .. versionadded:: 2.5.0 """ #: The error code corresponds to this kind of #: :class:`ProtocolError <h2.exceptions.ProtocolError>` error_code = h2.errors.ErrorCodes.ENHANCE_YOUR_CALM