Source code for pcapkit.const.hip.cipher
# -*- coding: utf-8 -*-
# pylint: disable=line-too-long,consider-using-f-string
"""Cipher IDs
================
.. module:: pcapkit.const.hip.cipher
This module contains the constant enumeration for **Cipher IDs**,
which is automatically generated from :class:`pcapkit.vendor.hip.cipher.Cipher`.
"""
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__ = ['Cipher']
[docs]
class Cipher(EnumRegistry, IntEnum):
"""[Cipher] Cipher IDs"""
#: RESERVED [:rfc:`7401`]
RESERVED_0 = 0
#: NULL-ENCRYPT [:rfc:`7401`]
NULL_ENCRYPT = 1
#: AES-128-CBC [:rfc:`7401`]
AES_128_CBC = 2
#: RESERVED [:rfc:`7401`]
RESERVED_3 = 3
#: AES-256-CBC [:rfc:`7401`]
AES_256_CBC = 4
[docs]
@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 0 <= value <= 65535):
raise EnumValueError('%r is not a valid %s' % (value, cls.__name__))
[docs]
@classmethod
def _missing_(cls, value: 'int') -> 'Cipher':
"""Lookup function used when value is not found.
Args:
value: Value to get enum item.
"""
if not (isinstance(value, int) and 0 <= value <= 65535):
raise ValueError('%r is not a valid %s' % (value, cls.__name__))
if 5 <= value <= 65535:
#: Unassigned
return cls._unregistered_member(value, 'Unassigned')
return super()._missing_(value)