refactor(corekit)!: Info.to_dict() returns an OrderedMultiDict; add MultiInfo and OrderedMultiInfo (#1484)

- corekit/infoclass: add MultiInfo and OrderedMultiInfo, Info subclasses
  that also derive from MultiDict/OrderedMultiDict. They inherit from_dict
  and Info's finalisation, keep the multi-mapping protocol, refuse every
  mutation, read keys as attributes and keep every value of a repeated key.
  Info stores every MultiDict value as one of them, so a finalised Info
  holds no mutable multi-mapping.
- Info.to_dict() returns an OrderedMultiDict at every level, and a
  MultiInfo/OrderedMultiInfo exports its plain multi-mapping; from_dict()
  restores them, including an annotated subclass (HTTP/2 Settings, now an
  OrderedMultiInfo). The OrderedMultiDict exports are a private subclass
  whose != negates ==, as OrderedMultiInfo's does, so two equal exports or
  option lists no longer compare unequal.
- corekit/multidict: drop InfoDict; the module is Werkzeug's classes only.
- dumpkit: write an Info's fields with every value of a repeated field, as a
  list; the PCAP and PCAP-NG engines hand the writers the Info itself.
- protocols/data: retype the attribute annotations to OrderedMultiInfo and
  MultiInfo; PCAP-NG freezes the entries it holds in a tuple or dict.
- tests: move the to_dict() assertions to the OrderedMultiDict contract.

Every test directory and top-level test module passes, run one at a time.

Author: JarryShaw

docs/source/pcapkit/corekit/infoclass.rst

@@ -5,7 +5,10 @@ Info Class
 
 :mod:`pcapkit.corekit.infoclass` contains the :obj:`dict`-like class
 :class:`~pcapkit.corekit.infoclass.Info`, modelled on
-:func:`dataclasses.dataclass` (:pep:`557`).
+:func:`dataclasses.dataclass` (:pep:`557`), and the immutable multi-mapping
+classes :class:`~pcapkit.corekit.infoclass.MultiInfo` and
+:class:`~pcapkit.corekit.infoclass.OrderedMultiInfo` that a finalised
+:class:`~pcapkit.corekit.infoclass.Info` holds its option lists in.
 
 .. autoclass:: pcapkit.corekit.infoclass.Info
    :members:
@@ -24,16 +27,35 @@ Info Class
 
 .. autodecorator:: pcapkit.corekit.infoclass.info_final
 
+.. autoclass:: pcapkit.corekit.infoclass.MultiInfo
+   :no-members:
+   :show-inheritance:
+
+.. autoclass:: pcapkit.corekit.infoclass.OrderedMultiInfo
+   :no-members:
+   :show-inheritance:
+
 Internal Definitions
 --------------------
 
 .. autoclass:: pcapkit.corekit.infoclass.InfoMeta
    :no-members:
    :show-inheritance:
 
+.. autoclass:: pcapkit.corekit.infoclass._MultiInfo
+   :no-members:
+   :show-inheritance:
+
+.. autoclass:: pcapkit.corekit.infoclass._OrderedMultiDict
+   :no-members:
+   :show-inheritance:
+
 Type Variables
 --------------
 
+.. data:: pcapkit.corekit.infoclass.KT
+   :type: typing.Any
+
 .. data:: pcapkit.corekit.infoclass.VT
    :type: typing.Any
 

docs/source/pcapkit/corekit/multidict.rst

@@ -35,15 +35,6 @@ values per key, based on the `Werkzeug`_ project.
    :no-special-members: __init__
    :show-inheritance:
 
-.. autoclass:: pcapkit.corekit.multidict.InfoDict
-   :no-members:
-   :no-special-members: __init__
-   :show-inheritance:
-
-   .. automethod:: keys
-   .. automethod:: values
-   .. automethod:: items
-
 Type Variables
 --------------
 

pcapkit/all.py

@@ -53,6 +53,7 @@
     # pcapkit.corekit
     'EnumRegistry',                                         # Enum Registry
     'Info', 'info_final',                                   # Info Class
+    'MultiInfo', 'OrderedMultiInfo',
     'ProtoChain',                                           # ProtoChain
     'VersionInfo',                                          # Version
     'NumberField', 'Int32Field', 'UInt32Field',             # numeric protocol fields

pcapkit/corekit/__init__.py

@@ -19,7 +19,7 @@ class :class:`~pcapkit.corekit.infoclass.Info`,
 from pcapkit.corekit.io import SeekableReader
 from pcapkit.corekit.enum import EnumRegistry
 from pcapkit.corekit.fields import *
-from pcapkit.corekit.infoclass import Info, info_final
+from pcapkit.corekit.infoclass import Info, MultiInfo, OrderedMultiInfo, info_final
 from pcapkit.corekit.module import ModuleDescriptor
 from pcapkit.corekit.multidict import MultiDict, OrderedMultiDict
 from pcapkit.corekit.protochain import ProtoChain
@@ -29,6 +29,7 @@ class :class:`~pcapkit.corekit.infoclass.Info`,
     'EnumRegistry',
 
     'Info', 'info_final',
+    'MultiInfo', 'OrderedMultiInfo',
 
     'ProtoChain',