Source code for pcapkit.const.http.setting

# -*- coding: utf-8 -*-
# pylint: disable=line-too-long,consider-using-f-string
"""HTTP/2 Settings
=====================

.. module:: pcapkit.const.http.setting

This module contains the constant enumeration for **HTTP/2 Settings**,
which is automatically generated from :class:`pcapkit.vendor.http.setting.Setting`.

"""

from typing import TYPE_CHECKING

from aenum import IntEnum

from pcapkit.corekit.enum import EnumRegistry
from pcapkit.utilities.exceptions import EnumValueError

if TYPE_CHECKING:
    from typing import Any

__all__ = ['Setting']




class Setting(EnumRegistry, IntEnum):
    """[Setting] HTTP/2 Settings"""

    #: ``Reserved`` [:rfc:`9113`]
    Reserved_0x0000 = 0x0000

    #: ``HEADER_TABLE_SIZE`` [:rfc:`9113#section-6.5.2`] (Initial Value: 4096)
    HEADER_TABLE_SIZE = 0x0001

    #: ``ENABLE_PUSH`` [:rfc:`9113#section-6.5.2`] (Initial Value: 1)
    ENABLE_PUSH = 0x0002

    #: ``MAX_CONCURRENT_STREAMS`` [:rfc:`9113#section-6.5.2`] (Initial Value:
    #: infinite)
    MAX_CONCURRENT_STREAMS = 0x0003

    #: ``INITIAL_WINDOW_SIZE`` [:rfc:`9113#section-6.5.2`] (Initial Value: 65535)
    INITIAL_WINDOW_SIZE = 0x0004

    #: ``MAX_FRAME_SIZE`` [:rfc:`9113#section-6.5.2`] (Initial Value: 16384)
    MAX_FRAME_SIZE = 0x0005

    #: ``MAX_HEADER_LIST_SIZE`` [:rfc:`9113#section-6.5.2`] (Initial Value:
    #: infinite)
    MAX_HEADER_LIST_SIZE = 0x0006

    #: ``Unassigned``
    Unassigned_0x0007 = 0x0007

    #: ``SETTINGS_ENABLE_CONNECT_PROTOCOL`` [:rfc:`8441`] (Initial Value: 0)
    SETTINGS_ENABLE_CONNECT_PROTOCOL = 0x0008

    #: ``SETTINGS_NO_RFC7540_PRIORITIES`` [:rfc:`9218`] (Initial Value: 0)
    SETTINGS_NO_RFC7540_PRIORITIES = 0x0009

    #: ``TLS_RENEG_PERMITTED`` [MS-HTTP2E][Gabriel Montenegro] (Initial Value:
    #: 0x00)
    TLS_RENEG_PERMITTED = 0x0010

    #: ``SETTINGS_ENABLE_METADATA`` [draft-beky-httpbis-metadata-02] (Initial
    #: Value: 0)
    SETTINGS_ENABLE_METADATA = 0x4D44



    @classmethod
    def _validate_value(cls, value: 'Any') -> 'None':
        """Reject ``value`` unless it passes the range check :meth:`_missing_` makes.

        Overrides :meth:`~pcapkit.corekit.enum.EnumLookup._validate_value`
        with that check and the message it raises, so
        :meth:`~pcapkit.corekit.enum.EnumRegistry.register` refuses exactly the
        values :meth:`~pcapkit.corekit.enum.EnumLookup.get` refuses, in the
        same words (:issue:`1816`).

        Args:
            value: Value about to be looked up or minted.

        Raises:
            EnumValueError: If ``value`` fails that check. A
                :exc:`ValueError`, so an ``except ValueError`` caller is
                unaffected.

        """
        if not (isinstance(value, int) and 0x0000 <= value <= 0xFFFF):
            raise EnumValueError('%r is not a valid %s' % (value, cls.__name__))




    @classmethod
    def _missing_(cls, value: 'int') -> 'Setting':
        """Lookup function used when value is not found.

        Args:
            value: Value to get enum item.

        """
        if not (isinstance(value, int) and 0x0000 <= value <= 0xFFFF):
            raise ValueError('%r is not a valid %s' % (value, cls.__name__))
        if 0x000A <= value <= 0x000F:
            #: ``Unassigned``
            return cls._unregistered_member(value, 'Unassigned')
        if 0x0011 <= value <= 0x4D43:
            #: ``Unassigned``
            return cls._unregistered_member(value, 'Unassigned')
        if 0x4D45 <= value <= 0xFFFF:
            #: ``Unassigned``
            return cls._unregistered_member(value, 'Unassigned')
        return super()._missing_(value)