revised const/vendor for _missing_ & type hints

Author: JarryShaw

.vscode/settings.json

@@ -128,6 +128,7 @@
         "httpv",
         "htype",
         "hwty",
+        "Iaddr",
         "iden",
         "idnm",
         "ifdrop",

pcapkit/const/arp/hardware.py

@@ -159,7 +159,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'Hardware':
         if isinstance(key, int):
             return Hardware(key)
         if key not in Hardware._member_map_:  # pylint: disable=no-member
-            extend_enum(Hardware, key, default)
+            return extend_enum(Hardware, key, default)
         return Hardware[key]  # type: ignore[misc]
 
     @classmethod
@@ -174,10 +174,8 @@ def _missing_(cls, value: 'int') -> 'Hardware':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 39 <= value <= 255:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         if 258 <= value <= 65534:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/arp/operation.py

@@ -112,7 +112,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'Operation':
         if isinstance(key, int):
             return Operation(key)
         if key not in Operation._member_map_:  # pylint: disable=no-member
-            extend_enum(Operation, key, default)
+            return extend_enum(Operation, key, default)
         return Operation[key]  # type: ignore[misc]
 
     @classmethod
@@ -127,6 +127,5 @@ def _missing_(cls, value: 'int') -> 'Operation':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 26 <= value <= 65534:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/ftp/command.py

@@ -23,21 +23,28 @@
 class Command(StrEnum):
     """[Command] FTP Command"""
 
+    if TYPE_CHECKING:
+        #: Feature of command.
+        feat: 'Optional[str]'
+        #: Description of command.
+        desc: 'Optional[str]'
+        #: Type of command.
+        type: 'Optional[tuple[str, ...]]'
+        #: Conformance of command.
+        conf: 'Optional[str]'
+        #: Note of command.
+        note: 'Optional[tuple[str, ...]]'
+
     def __new__(cls, name: 'str', feat: 'Optional[str]' = None, desc: 'Optional[str]' = None,
                 type: 'Optional[tuple[str, ...]]' = None, conf: 'Optional[str]' = None,
                 note: 'Optional[tuple[str, ...]]' = None) -> 'Type[Command]':
         obj = str.__new__(cls, name)
         obj._value_ = name
 
-        #: Feature of command.
         obj.feat = feat
-        #: Description of command.
         obj.desc = desc
-        #: Type of command.
         obj.type = type
-        #: Conformance of command.
         obj.conf = conf
-        #: Note of command.
         obj.note = note
 
         return obj
@@ -236,7 +243,7 @@ def get(key: 'str', default: 'Optional[str]' = None) -> 'Command':
         :meta private:
         """
         if key not in Command._member_map_:  # pylint: disable=no-member
-            extend_enum(Command, key.upper(), default if default is not None else key)
+            return extend_enum(Command, key.upper(), default if default is not None else key)
         return Command[key]  # type: ignore[misc]
 
     @classmethod
@@ -247,5 +254,4 @@ def _missing_(cls, value: 'str') -> 'Command':
             value: Value to get enum item.
 
         """
-        extend_enum(cls, value.upper(), value)
-        return cls(value)
+        return extend_enum(cls, value.upper(), value)

pcapkit/const/ftp/return_code.py

@@ -43,16 +43,21 @@
 class ReturnCode(IntEnum):
     """[ReturnCode] FTP Server Return Code"""
 
+    if TYPE_CHECKING:
+        #: Description of the return code.
+        description: 'Optional[str]'
+        #: Response kind.
+        kind: 'str'
+        #: Grouping information.
+        group: 'str'
+
     def __new__(cls, value: 'int', description: 'Optional[str]' = None) -> 'Type[ReturnCode]':
         obj = int.__new__(cls, value)
         obj._value_ = value
 
         code = str(value)
-        #: Description of the return code.
         obj.description = description
-        #: Response kind.
         obj.kind = KIND.get(str(value)[0], 'Reserved')
-        #: Grouping information.
         obj.group = INFO.get(str(value)[1], 'Reserved')
 
         return obj
@@ -255,7 +260,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'ReturnCode':
         if isinstance(key, int):
             return ReturnCode(key)
         if key not in ReturnCode._member_map_:  # pylint: disable=no-member
-            extend_enum(ReturnCode, key, default)
+            return extend_enum(ReturnCode, key, default)
         return ReturnCode[key]  # type: ignore[misc]
 
     @classmethod
@@ -268,5 +273,4 @@ def _missing_(cls, value: 'int') -> 'ReturnCode':
         """
         if not (isinstance(value, int) and 100 <= value <= 659):
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
-        extend_enum(cls, 'CODE_%s' % value, value)
-        return cls(value)
+        return extend_enum(cls, 'CODE_%s' % value, value)

pcapkit/const/hip/certificate.py

@@ -58,7 +58,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'Certificate':
         if isinstance(key, int):
             return Certificate(key)
         if key not in Certificate._member_map_:  # pylint: disable=no-member
-            extend_enum(Certificate, key, default)
+            return extend_enum(Certificate, key, default)
         return Certificate[key]  # type: ignore[misc]
 
     @classmethod
@@ -73,6 +73,5 @@ def _missing_(cls, value: 'int') -> 'Certificate':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 9 <= value <= 255:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/cipher.py

@@ -46,7 +46,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'Cipher':
         if isinstance(key, int):
             return Cipher(key)
         if key not in Cipher._member_map_:  # pylint: disable=no-member
-            extend_enum(Cipher, key, default)
+            return extend_enum(Cipher, key, default)
         return Cipher[key]  # type: ignore[misc]
 
     @classmethod
@@ -61,6 +61,5 @@ def _missing_(cls, value: 'int') -> 'Cipher':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 5 <= value <= 65535:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/di.py

@@ -40,7 +40,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'DITypes':
         if isinstance(key, int):
             return DITypes(key)
         if key not in DITypes._member_map_:  # pylint: disable=no-member
-            extend_enum(DITypes, key, default)
+            return extend_enum(DITypes, key, default)
         return DITypes[key]  # type: ignore[misc]
 
     @classmethod
@@ -55,6 +55,5 @@ def _missing_(cls, value: 'int') -> 'DITypes':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 3 <= value <= 15:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/ecdsa_curve.py

@@ -40,7 +40,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'ECDSACurve':
         if isinstance(key, int):
             return ECDSACurve(key)
         if key not in ECDSACurve._member_map_:  # pylint: disable=no-member
-            extend_enum(ECDSACurve, key, default)
+            return extend_enum(ECDSACurve, key, default)
         return ECDSACurve[key]  # type: ignore[misc]
 
     @classmethod
@@ -55,6 +55,5 @@ def _missing_(cls, value: 'int') -> 'ECDSACurve':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 3 <= value <= 65535:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/ecdsa_low_curve.py

@@ -37,7 +37,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'ECDSALowCurve':
         if isinstance(key, int):
             return ECDSALowCurve(key)
         if key not in ECDSALowCurve._member_map_:  # pylint: disable=no-member
-            extend_enum(ECDSALowCurve, key, default)
+            return extend_enum(ECDSALowCurve, key, default)
         return ECDSALowCurve[key]  # type: ignore[misc]
 
     @classmethod
@@ -52,6 +52,5 @@ def _missing_(cls, value: 'int') -> 'ECDSALowCurve':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 2 <= value <= 65535:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/eddsa_curve.py

@@ -46,7 +46,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'EdDSACurve':
         if isinstance(key, int):
             return EdDSACurve(key)
         if key not in EdDSACurve._member_map_:  # pylint: disable=no-member
-            extend_enum(EdDSACurve, key, default)
+            return extend_enum(EdDSACurve, key, default)
         return EdDSACurve[key]  # type: ignore[misc]
 
     @classmethod
@@ -61,6 +61,5 @@ def _missing_(cls, value: 'int') -> 'EdDSACurve':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 5 <= value <= 65535:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/esp_transform_suite.py

@@ -79,7 +79,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'ESPTransformSuite':
         if isinstance(key, int):
             return ESPTransformSuite(key)
         if key not in ESPTransformSuite._member_map_:  # pylint: disable=no-member
-            extend_enum(ESPTransformSuite, key, default)
+            return extend_enum(ESPTransformSuite, key, default)
         return ESPTransformSuite[key]  # type: ignore[misc]
 
     @classmethod
@@ -94,6 +94,5 @@ def _missing_(cls, value: 'int') -> 'ESPTransformSuite':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 16 <= value <= 65535:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/group.py

@@ -67,7 +67,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'Group':
         if isinstance(key, int):
             return Group(key)
         if key not in Group._member_map_:  # pylint: disable=no-member
-            extend_enum(Group, key, default)
+            return extend_enum(Group, key, default)
         return Group[key]  # type: ignore[misc]
 
     @classmethod
@@ -82,6 +82,5 @@ def _missing_(cls, value: 'int') -> 'Group':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 12 <= value <= 255:
             # Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/hi_algorithm.py

@@ -64,7 +64,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'HIAlgorithm':
         if isinstance(key, int):
             return HIAlgorithm(key)
         if key not in HIAlgorithm._member_map_:  # pylint: disable=no-member
-            extend_enum(HIAlgorithm, key, default)
+            return extend_enum(HIAlgorithm, key, default)
         return HIAlgorithm[key]  # type: ignore[misc]
 
     @classmethod
@@ -79,10 +79,8 @@ def _missing_(cls, value: 'int') -> 'HIAlgorithm':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 10 <= value <= 12:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         if 14 <= value <= 65535:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/hit_suite.py

@@ -49,7 +49,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'HITSuite':
         if isinstance(key, int):
             return HITSuite(key)
         if key not in HITSuite._member_map_:  # pylint: disable=no-member
-            extend_enum(HITSuite, key, default)
+            return extend_enum(HITSuite, key, default)
         return HITSuite[key]  # type: ignore[misc]
 
     @classmethod
@@ -64,6 +64,5 @@ def _missing_(cls, value: 'int') -> 'HITSuite':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 6 <= value <= 15:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)

pcapkit/const/hip/nat_traversal.py

@@ -43,7 +43,7 @@ def get(key: 'int | str', default: 'int' = -1) -> 'NATTraversal':
         if isinstance(key, int):
             return NATTraversal(key)
         if key not in NATTraversal._member_map_:  # pylint: disable=no-member
-            extend_enum(NATTraversal, key, default)
+            return extend_enum(NATTraversal, key, default)
         return NATTraversal[key]  # type: ignore[misc]
 
     @classmethod
@@ -58,6 +58,5 @@ def _missing_(cls, value: 'int') -> 'NATTraversal':
             raise ValueError('%r is not a valid %s' % (value, cls.__name__))
         if 4 <= value <= 65535:
             #: Unassigned
-            extend_enum(cls, 'Unassigned_%d' % value, value)
-            return cls(value)
+            return extend_enum(cls, 'Unassigned_%d' % value, value)
         return super()._missing_(value)