some refactoring of core and help to expose external api

more development of Structor with some unit tests
make consistent exception class for Serdering and Structing

src/keri/core/__init__.py

@@ -7,7 +7,7 @@
 #__all__ = ["coring", "eventing", "parsing", "scheming"]
 
 # Matter class and its subclasses
-from .coring import (Matter, MtrDex, Number, NumDex, Dater,Texter,
+from .coring import (Matter, MtrDex, Number, NumDex, Dater, Texter,
                     Bexter, Pather, Verfer, Cigar, Signer, Salter,
                     Cipher, Encrypter, Decrypter, Diger, DigDex,
                     Prefixer, PreDex, )

src/keri/core/counting.py

@@ -77,6 +77,8 @@ class MapCodex:
     Adds support for dunder methods for map syntax dc[name].
     Converts exceptions from attribute syntax to raise map syntax when using
     map syntax.
+
+    Enables Mapping item syntas for dataclasses
     """
 
     def __getitem__(self, name):
@@ -107,6 +109,9 @@ class CounterCodex_1_0(MapCodex):
     CounterCodex is codex hard (stable) part of all counter derivation codes.
     Only provide defined codes.
     Undefined are left out so that inclusion(exclusion) via 'in' operator works.
+
+    As subclass of MapCodex can get codes with item syntax using tag variables.
+    Example: codex[tag]
     """
     ControllerIdxSigs: str = '-A'  # Qualified Base64 Indexed Signature.
     WitnessIdxSigs: str = '-B'  # Qualified Base64 Indexed Signature.
@@ -136,6 +141,9 @@ class CounterCodex_2_0(MapCodex):
     CounterCodex is codex hard (stable) part of all counter derivation codes.
     Only provide defined codes.
     Undefined are left out so that inclusion(exclusion) via 'in' operator works.
+
+    As subclass of MapCodex can get codes with item syntax using tag variables.
+    Example: codex[tag]
     """
     GenericGroup: str = '-A'  # Generic Group (Universal with Override).
     BigGenericGroup: str = '-0A'  # Big Generic Group (Universal with Override).
@@ -189,8 +197,6 @@ class CounterCodex_2_0(MapCodex):
     BigESSRPayloadGroup: str = '-0Z'  # Big ESSR Payload Group.
     KERIACDCGenusVersion: str = '--AAA'  # KERI ACDC Stack CESR Protocol Genus Version (Universal)
 
-
-
     def __iter__(self):
         return iter(astuple(self))  # enables value not key inclusion test with "in"
 

src/keri/core/serdering.py

@@ -19,7 +19,7 @@
 
 from .. import kering
 from ..kering import (ValidationError,  MissingFieldError, ExtraFieldError,
-                      AlternateFieldError,
+                      AlternateFieldError, InvalidValueError,
                       ShortageError, VersionError, ProtocolError, KindError,
                       DeserializeError, FieldError, SerializeError)
 from ..kering import (Versionage, Version, Vrsn_1_0, Vrsn_2_0,
@@ -642,7 +642,8 @@ def __init__(self, *, raw=b'', sad=None, strip=False, smellage=None,
                                               f"{self._sad}.") from ex
 
         else:
-            raise ValueError("Improper initialization need raw or sad or makify.")
+            raise InvalidValueError("Improper initialization need raw or sad "
+                                    f"or makify.")
 
 
 
@@ -840,7 +841,7 @@ def makify(self, sad, *, proto=None, vrsn=None, kind=None,
         if sad and 'v' in sad:  # attempt to get from vs in sad
             try:  # extract version string elements as defaults if provided
                 sproto, svrsn, skind, _, _ = deversify(sad["v"])
-            except ValueError as ex:
+            except VersionError as ex:
                 pass
             else:
                 silk = sad.get('t')  # if 't' not in sad .get returns None which may be valid