pypcapkit 1.3.3.post1__cp313-none-any.whl

pcapkit/vendor/mh/handoff_type.py

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+"""Handoff Indicator Option Type Values
+===============================================
+
+.. module:: pcapkit.vendor.mh.handoff_type
+
+This module contains the vendor crawler for **Handoff Indicator Option Type Values**,
+which is automatically generating :class:`pcapkit.const.mh.handoff_type.HandoffType`.
+
+"""
+
+import csv
+import re
+import sys
+
+from pcapkit.vendor.default import Vendor
+
+__all__ = ['HandoffType']
+
+
+class HandoffType(Vendor):
+    """Handoff Indicator Option Type Values"""
+
+    #: Value limit checker.
+    FLAG = 'isinstance(value, int) and 0 <= value <= 255'
+    #: Link to registry.
+    LINK = 'https://www.iana.org/assignments/mobility-parameters/mobility-parameters-9.csv'
+
+    def process(self, data: 'list[str]') -> 'tuple[list[str], list[str]]':
+        """Process CSV data.
+
+        Args:
+            data: CSV data.
+
+        Returns:
+            Enumeration fields and missing fields.
+
+        """
+        reader = csv.reader(data)
+        next(reader)  # header
+
+        enum = []  # type: list[str]
+        miss = []  # type: list[str]
+        for item in reader:
+            long = item[1]
+            rfcs = item[2]
+
+            temp = []  # type: list[str]
+            for rfc in filter(None, re.split(r'\[|\]', rfcs)):
+                if 'RFC' in rfc and re.match(r'\d+', rfc[3:]):
+                    # temp.append(f'[{rfc[:3]} {rfc[3:]}]')
+                    temp.append(f'[:rfc:`{rfc[3:]}`]')
+                else:
+                    temp.append(f'[{rfc}]'.replace('_', ' '))
+            tmp1 = f" {''.join(temp)}" if rfcs else ''
+
+            split = long.split(' (', 1)
+            if len(split) == 2:
+                name = split[0]
+                cmmt = f" ({split[1]}"
+            else:
+                name, cmmt = long, ''
+            desc = self.wrap_comment(f'{name}{cmmt}{tmp1}')
+
+            try:
+                code, _ = item[0], int(item[0])
+                renm = self.rename(name, code, original=long)
+
+                pres = f"{renm} = {code}"
+                sufs = f'#: {desc}'
+
+                # if len(pres) > 74:
+                #     sufs = f"\n{' '*80}{sufs}"
+
+                # enum.append(f'{pres.ljust(76)}{sufs}')
+                enum.append(f'{sufs}\n    {pres}')
+            except ValueError:
+                start, stop = item[0].split('-')
+
+                miss.append(f'if {start} <= value <= {stop}:')
+                miss.append(f'    #: {desc}')
+                miss.append(f"    return extend_enum(cls, '{self.safe_name(name)}_%d' % value, value)")
+        return enum, miss
+
+
+if __name__ == '__main__':
+    sys.exit(HandoffType())  # type: ignore[arg-type]

pcapkit/vendor/mh/handover_ack_flag.py

@@ -0,0 +1,143 @@
+# -*- coding: utf-8 -*-
+"""Handover Acknowledge Flags
+================================
+
+.. module:: pcapkit.vendor.mh.handover_ack_flag
+
+This module contains the vendor crawler for **Handover Acknowledge Flags**,
+which is automatically generating :class:`pcapkit.const.mh.handover_ack_flag.HandoverACKFlag`.
+
+"""
+
+import csv
+import re
+import sys
+from typing import TYPE_CHECKING
+
+from pcapkit.vendor.default import Vendor
+
+__all__ = ['HandoverACKFlag']
+
+if TYPE_CHECKING:
+    from typing import Callable
+
+
+LINE = lambda NAME, DOCS, FLAG, ENUM, MODL: f'''\
+# -*- coding: utf-8 -*-
+# pylint: disable=line-too-long,consider-using-f-string
+"""{(name := DOCS.split(' [', maxsplit=1)[0])}
+{'=' * (len(name) + 6)}
+
+.. module:: {MODL.replace('vendor', 'const')}
+
+This module contains the constant enumeration for **{name}**,
+which is automatically generated from :class:`{MODL}.{NAME}`.
+
+"""
+
+from aenum import IntFlag
+
+__all__ = ['{NAME}']
+
+
+class {NAME}(IntFlag):
+    """[{NAME}] {DOCS}"""
+
+    {ENUM}
+
+    @staticmethod
+    def get(key: 'int | str', default: 'int' = -1) -> '{NAME}':
+        """Backport support for original codes.
+
+        Args:
+            key: Key to get enum item.
+            default: Default value if not found.
+
+        :meta private:
+        """
+        if isinstance(key, int):
+            return {NAME}(key)
+        return {NAME}[key]  # type: ignore[misc]
+
+    @classmethod
+    def _missing_(cls, value: 'int') -> '{NAME}':
+        """Lookup function used when value is not found.
+
+        Args:
+            value: Value to get enum item.
+
+        """
+        if not ({FLAG}):
+            raise ValueError('%r is not a valid %s' % (value, cls.__name__))
+        return cls(value)
+'''  # type: Callable[[str, str, str, str, str], str]
+
+
+class HandoverACKFlag(Vendor):
+    """Handover Acknowledge Flags"""
+
+    #: Value limit checker.
+    FLAG = 'isinstance(value, int) and 0 <= value <= 0xFF'
+    #: Link to registry.
+    LINK = 'https://www.iana.org/assignments/mobility-parameters/handover-acknowledge-flags.csv'
+
+    def process(self, data: 'list[str]') -> 'list[str]':  # type: ignore[override] # pylint: disable=arguments-differ,arguments-renamed
+        """Process CSV data.
+
+        Args:
+            data: CSV data.
+
+        Returns:
+            Enumeration fields and missing fields.
+
+        """
+        reader = csv.reader(data)
+        next(reader)  # header
+
+        enum = []  # type: list[str]
+        for item in reader:
+            name = item[0]
+            dscp = item[2]
+            rfcs = item[3]
+
+            temp = []  # type: list[str]
+            for rfc in filter(None, re.split(r'\[|\]', rfcs)):
+                if 'RFC' in rfc and re.match(r'\d+', rfc[3:]):
+                    # temp.append(f'[{rfc[:3]} {rfc[3:]}]')
+                    temp.append(f'[:rfc:`{rfc[3:]}`]')
+                else:
+                    temp.append(f'[{rfc}]'.replace('_', ' '))
+            tmp1 = f" {''.join(temp)}" if rfcs else ''
+
+            desc = self.wrap_comment(f'{dscp}{tmp1}')
+
+            code, code_val = item[1], int(item[1], base=16)
+            renm = self.rename(name, code)
+
+            pres = f"{renm} = 0x{code_val:02x}"
+            sufs = f'#: {desc}'
+
+            # if len(pres) > 74:
+            #     sufs = f"\n{' '*80}{sufs}"
+
+            # enum.append(f'{pres.ljust(76)}{sufs}')
+            enum.append(f'{sufs}\n    {pres}')
+        return enum
+
+    def context(self, data: 'list[str]') -> 'str':  # pylint: disable=arguments-differ,arguments-renamed
+        """Generate constant context.
+
+        Args:
+            soup: Parsed HTML source.
+
+        Returns:
+            Constant context.
+
+        """
+        enum = self.process(data)
+        ENUM = '\n\n    '.join(map(lambda s: s.rstrip(), enum))
+        return LINE(self.NAME, self.DOCS, self.FLAG, ENUM, self.__module__)
+
+
+if __name__ == '__main__':
+    sys.exit(HandoverACKFlag())  # type: ignore[arg-type]

pcapkit/vendor/mh/handover_ack_status.py

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+"""Handover Acknowledge Status Codes
+=======================================
+
+.. module:: pcapkit.vendor.mh.handover_ack_status
+
+This module contains the vendor crawler for **Handover Acknowledge Status Codes**,
+which is automatically generating :class:`pcapkit.const.mh.handover_ack_status.HandoverACKStatus`.
+
+"""
+
+import csv
+import re
+import sys
+
+from pcapkit.vendor.default import Vendor
+
+__all__ = ['HandoverACKStatus']
+
+
+class HandoverACKStatus(Vendor):
+    """Handover Acknowledge Status Codes"""
+
+    #: Value limit checker.
+    FLAG = 'isinstance(value, int) and 0 <= value <= 255'
+    #: Link to registry.
+    LINK = 'https://www.iana.org/assignments/mobility-parameters/handover-acknowledge-status.csv'
+
+    def process(self, data: 'list[str]') -> 'tuple[list[str], list[str]]':
+        """Process CSV data.
+
+        Args:
+            data: CSV data.
+
+        Returns:
+            Enumeration fields and missing fields.
+
+        """
+        reader = csv.reader(data)
+        next(reader)  # header
+
+        enum = []  # type: list[str]
+        miss = []  # type: list[str]
+        for item in reader:
+            long = item[1]
+            rfcs = item[2]
+
+            temp = []  # type: list[str]
+            for rfc in filter(None, re.split(r'\[|\]', rfcs)):
+                if 'RFC' in rfc and re.match(r'\d+', rfc[3:]):
+                    # temp.append(f'[{rfc[:3]} {rfc[3:]}]')
+                    temp.append(f'[:rfc:`{rfc[3:]}`]')
+                else:
+                    temp.append(f'[{rfc}]'.replace('_', ' '))
+            tmp1 = f" {''.join(temp)}" if rfcs else ''
+
+            split = long.split(' (', 1)
+            if len(split) == 2:
+                name = split[0]
+                cmmt = f" ({split[1]}"
+            else:
+                name, cmmt = long, ''
+            desc = self.wrap_comment(f'{name}{cmmt}{tmp1}')
+
+            try:
+                code, _ = item[0], int(item[0])
+                renm = self.rename(name, code, original=long)
+
+                pres = f"{renm} = {code}"
+                sufs = f'#: {desc}'
+
+                # if len(pres) > 74:
+                #     sufs = f"\n{' '*80}{sufs}"
+
+                # enum.append(f'{pres.ljust(76)}{sufs}')
+                enum.append(f'{sufs}\n    {pres}')
+            except ValueError:
+                start, stop = item[0].split('-')
+
+                miss.append(f'if {start} <= value <= {stop}:')
+                miss.append(f'    #: {desc}')
+                miss.append(f"    return extend_enum(cls, '{self.safe_name(name)}_%d' % value, value)")
+        return enum, miss
+
+
+if __name__ == '__main__':
+    sys.exit(HandoverACKStatus())  # type: ignore[arg-type]

pcapkit/vendor/mh/handover_initiate_flag.py

@@ -0,0 +1,143 @@
+# -*- coding: utf-8 -*-
+"""Handover Initiate Flags
+=============================
+
+.. module:: pcapkit.vendor.mh.handover_initiate_flag
+
+This module contains the vendor crawler for **Handover Initiate Flags**,
+which is automatically generating :class:`pcapkit.const.mh.handover_initiate_flag.HandoverInitiateFlag`.
+
+"""
+
+import csv
+import re
+import sys
+from typing import TYPE_CHECKING
+
+from pcapkit.vendor.default import Vendor
+
+__all__ = ['HandoverInitiateFlag']
+
+if TYPE_CHECKING:
+    from typing import Callable
+
+
+LINE = lambda NAME, DOCS, FLAG, ENUM, MODL: f'''\
+# -*- coding: utf-8 -*-
+# pylint: disable=line-too-long,consider-using-f-string
+"""{(name := DOCS.split(' [', maxsplit=1)[0])}
+{'=' * (len(name) + 6)}
+
+.. module:: {MODL.replace('vendor', 'const')}
+
+This module contains the constant enumeration for **{name}**,
+which is automatically generated from :class:`{MODL}.{NAME}`.
+
+"""
+
+from aenum import IntFlag
+
+__all__ = ['{NAME}']
+
+
+class {NAME}(IntFlag):
+    """[{NAME}] {DOCS}"""
+
+    {ENUM}
+
+    @staticmethod
+    def get(key: 'int | str', default: 'int' = -1) -> '{NAME}':
+        """Backport support for original codes.
+
+        Args:
+            key: Key to get enum item.
+            default: Default value if not found.
+
+        :meta private:
+        """
+        if isinstance(key, int):
+            return {NAME}(key)
+        return {NAME}[key]  # type: ignore[misc]
+
+    @classmethod
+    def _missing_(cls, value: 'int') -> '{NAME}':
+        """Lookup function used when value is not found.
+
+        Args:
+            value: Value to get enum item.
+
+        """
+        if not ({FLAG}):
+            raise ValueError('%r is not a valid %s' % (value, cls.__name__))
+        return cls(value)
+'''  # type: Callable[[str, str, str, str, str], str]
+
+
+class HandoverInitiateFlag(Vendor):
+    """Handover Initiate Flags"""
+
+    #: Value limit checker.
+    FLAG = 'isinstance(value, int) and 0 <= value <= 0xFF'
+    #: Link to registry.
+    LINK = 'https://www.iana.org/assignments/mobility-parameters/handover-initiate-flags.csv'
+
+    def process(self, data: 'list[str]') -> 'list[str]':  # type: ignore[override] # pylint: disable=arguments-differ,arguments-renamed
+        """Process CSV data.
+
+        Args:
+            data: CSV data.
+
+        Returns:
+            Enumeration fields and missing fields.
+
+        """
+        reader = csv.reader(data)
+        next(reader)  # header
+
+        enum = []  # type: list[str]
+        for item in reader:
+            name = item[0]
+            dscp = item[2]
+            rfcs = item[3]
+
+            temp = []  # type: list[str]
+            for rfc in filter(None, re.split(r'\[|\]', rfcs)):
+                if 'RFC' in rfc and re.match(r'\d+', rfc[3:]):
+                    # temp.append(f'[{rfc[:3]} {rfc[3:]}]')
+                    temp.append(f'[:rfc:`{rfc[3:]}`]')
+                else:
+                    temp.append(f'[{rfc}]'.replace('_', ' '))
+            tmp1 = f" {''.join(temp)}" if rfcs else ''
+
+            desc = self.wrap_comment(f'{dscp}{tmp1}')
+
+            code, code_val = item[1], int(item[1], base=16)
+            renm = self.rename(name, code)
+
+            pres = f"{renm} = 0x{code_val:02x}"
+            sufs = f'#: {desc}'
+
+            # if len(pres) > 74:
+            #     sufs = f"\n{' '*80}{sufs}"
+
+            # enum.append(f'{pres.ljust(76)}{sufs}')
+            enum.append(f'{sufs}\n    {pres}')
+        return enum
+
+    def context(self, data: 'list[str]') -> 'str':  # pylint: disable=arguments-differ,arguments-renamed
+        """Generate constant context.
+
+        Args:
+            soup: Parsed HTML source.
+
+        Returns:
+            Constant context.
+
+        """
+        enum = self.process(data)
+        ENUM = '\n\n    '.join(map(lambda s: s.rstrip(), enum))
+        return LINE(self.NAME, self.DOCS, self.FLAG, ENUM, self.__module__)
+
+
+if __name__ == '__main__':
+    sys.exit(HandoverInitiateFlag())  # type: ignore[arg-type]

pcapkit/vendor/mh/handover_initiate_status.py

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+"""Handover Initiate Status Codes
+====================================
+
+.. module:: pcapkit.vendor.mh.handover_initiate_status
+
+This module contains the vendor crawler for **Handover Initiate Status Codes**,
+which is automatically generating :class:`pcapkit.const.mh.handover_initiate_status.HandoverInitiateStatus`.
+
+"""
+
+import csv
+import re
+import sys
+
+from pcapkit.vendor.default import Vendor
+
+__all__ = ['HandoverInitiateStatus']
+
+
+class HandoverInitiateStatus(Vendor):
+    """Handover Initiate Status Codes"""
+
+    #: Value limit checker.
+    FLAG = 'isinstance(value, int) and 0 <= value <= 255'
+    #: Link to registry.
+    LINK = 'https://www.iana.org/assignments/mobility-parameters/handover-initiate-status.csv'
+
+    def process(self, data: 'list[str]') -> 'tuple[list[str], list[str]]':
+        """Process CSV data.
+
+        Args:
+            data: CSV data.
+
+        Returns:
+            Enumeration fields and missing fields.
+
+        """
+        reader = csv.reader(data)
+        next(reader)  # header
+
+        enum = []  # type: list[str]
+        miss = []  # type: list[str]
+        for item in reader:
+            long = item[1]
+            rfcs = item[2]
+
+            temp = []  # type: list[str]
+            for rfc in filter(None, re.split(r'\[|\]', rfcs)):
+                if 'RFC' in rfc and re.match(r'\d+', rfc[3:]):
+                    # temp.append(f'[{rfc[:3]} {rfc[3:]}]')
+                    temp.append(f'[:rfc:`{rfc[3:]}`]')
+                else:
+                    temp.append(f'[{rfc}]'.replace('_', ' '))
+            tmp1 = f" {''.join(temp)}" if rfcs else ''
+
+            split = long.split(' (', 1)
+            if len(split) == 2:
+                name = split[0]
+                cmmt = f" ({split[1]}"
+            else:
+                name, cmmt = long, ''
+            desc = self.wrap_comment(f'{name}{cmmt}{tmp1}')
+
+            try:
+                code, _ = item[0], int(item[0])
+                renm = self.rename(name, code, original=long)
+
+                pres = f"{renm} = {code}"
+                sufs = f'#: {desc}'
+
+                # if len(pres) > 74:
+                #     sufs = f"\n{' '*80}{sufs}"
+
+                # enum.append(f'{pres.ljust(76)}{sufs}')
+                enum.append(f'{sufs}\n    {pres}')
+            except ValueError:
+                start, stop = item[0].split('-')
+
+                miss.append(f'if {start} <= value <= {stop}:')
+                miss.append(f'    #: {desc}')
+                miss.append(f"    return extend_enum(cls, '{self.safe_name(name)}_%d' % value, value)")
+        return enum, miss
+
+
+if __name__ == '__main__':
+    sys.exit(HandoverInitiateStatus())  # type: ignore[arg-type]

pcapkit/vendor/mh/home_address_reply.py

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+"""IPv4 Home Address Reply Status Codes
+==========================================
+
+.. module:: pcapkit.vendor.mh.home_address_reply
+
+This module contains the vendor crawler for **IPv4 Home Address Reply Status Codes**,
+which is automatically generating :class:`pcapkit.const.mh.home_address_reply.HomeAddressReply`.
+
+"""
+
+import csv
+import re
+import sys
+
+from pcapkit.vendor.default import Vendor
+
+__all__ = ['HomeAddressReply']
+
+
+class HomeAddressReply(Vendor):
+    """IPv4 Home Address Reply Status Codes"""
+
+    #: Value limit checker.
+    FLAG = 'isinstance(value, int) and 0 <= value <= 255'
+    #: Link to registry.
+    LINK = 'https://www.iana.org/assignments/mobility-parameters/home-address-reply.csv'
+
+    def process(self, data: 'list[str]') -> 'tuple[list[str], list[str]]':
+        """Process CSV data.
+
+        Args:
+            data: CSV data.
+
+        Returns:
+            Enumeration fields and missing fields.
+
+        """
+        reader = csv.reader(data)
+        next(reader)  # header
+
+        enum = []  # type: list[str]
+        miss = []  # type: list[str]
+        for item in reader:
+            long = item[1]
+            rfcs = item[2]
+
+            temp = []  # type: list[str]
+            for rfc in filter(None, re.split(r'\[|\]', rfcs)):
+                if 'RFC' in rfc and re.match(r'\d+', rfc[3:]):
+                    # temp.append(f'[{rfc[:3]} {rfc[3:]}]')
+                    temp.append(f'[:rfc:`{rfc[3:]}`]')
+                else:
+                    temp.append(f'[{rfc}]'.replace('_', ' '))
+            tmp1 = f" {''.join(temp)}" if rfcs else ''
+
+            split = long.split(' (', 1)
+            if len(split) == 2:
+                name = split[0]
+                cmmt = f" ({split[1]}"
+            else:
+                name, cmmt = long, ''
+            desc = self.wrap_comment(f'{name}{cmmt}{tmp1}')
+
+            try:
+                code, _ = item[0], int(item[0])
+                renm = self.rename(name, code, original=long)
+
+                pres = f"{renm} = {code}"
+                sufs = f'#: {desc}'
+
+                # if len(pres) > 74:
+                #     sufs = f"\n{' '*80}{sufs}"
+
+                # enum.append(f'{pres.ljust(76)}{sufs}')
+                enum.append(f'{sufs}\n    {pres}')
+            except ValueError:
+                start, stop = item[0].split('-')
+
+                miss.append(f'if {start} <= value <= {stop}:')
+                miss.append(f'    #: {desc}')
+                miss.append(f"    return extend_enum(cls, '{self.safe_name(name)}_%d' % value, value)")
+        return enum, miss
+
+
+if __name__ == '__main__':
+    sys.exit(HomeAddressReply())  # type: ignore[arg-type]