enumerific 1.0.7__tar.gz → 1.0.9__tar.gz

{enumerific-1.0.7/source/enumerific.egg-info → enumerific-1.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: enumerific
-Version: 1.0.7
+Version: 1.0.9
 Summary: Simplifies working with Python enums.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -690,8 +690,8 @@ class Colors(Enumeration):
 # Ensure that the Colors enumeration subclass is of the expected types
 assert issubclass(Colors, Enumeration)
 
-# Attempt to reconcile a Color against one of its annotations
-color = Colors.reconcile(value=(255, 0, 0), annotation="RGB")
+# Attempt to reconcile a Color against one of its annotations (via annotation keyword)
+color = Colors.reconcile(RGB=(255, 0, 0))
 
 assert isinstance(color, Colors)
 assert isinstance(color, Enumeration)
@@ -699,6 +699,16 @@ assert isinstance(color, Enumeration)
 assert color.name == "RED"
 assert color.value == 1
 assert color.RGB == (255, 0, 0)
+
+# Attempt to reconcile a Color against one of its annotations (via annotation argument)
+color = Colors.reconcile(value=(0, 255, 0), annotation="RGB")
+
+assert isinstance(color, Colors)
+assert isinstance(color, Enumeration)
+
+assert color.name == "GREEN"
+assert color.value == 2
+assert color.RGB == (0, 255, 0)
 ```
 
 # Enumerific Library Enumerations: Classes & Methods
@@ -890,4 +900,4 @@ See the documentation for [PyTest](https://docs.pytest.org/en/latest/) regarding
 
 ### Copyright & License Information
 
-Copyright © 2024–2025 Daniel Sissman; licensed under the MIT License.
+Copyright © 2024–2026 Daniel Sissman; licensed under the MIT License.

{enumerific-1.0.7 → enumerific-1.0.9}/README.md

@@ -660,8 +660,8 @@ class Colors(Enumeration):
 # Ensure that the Colors enumeration subclass is of the expected types
 assert issubclass(Colors, Enumeration)
 
-# Attempt to reconcile a Color against one of its annotations
-color = Colors.reconcile(value=(255, 0, 0), annotation="RGB")
+# Attempt to reconcile a Color against one of its annotations (via annotation keyword)
+color = Colors.reconcile(RGB=(255, 0, 0))
 
 assert isinstance(color, Colors)
 assert isinstance(color, Enumeration)
@@ -669,6 +669,16 @@ assert isinstance(color, Enumeration)
 assert color.name == "RED"
 assert color.value == 1
 assert color.RGB == (255, 0, 0)
+
+# Attempt to reconcile a Color against one of its annotations (via annotation argument)
+color = Colors.reconcile(value=(0, 255, 0), annotation="RGB")
+
+assert isinstance(color, Colors)
+assert isinstance(color, Enumeration)
+
+assert color.name == "GREEN"
+assert color.value == 2
+assert color.RGB == (0, 255, 0)
 ```
 
 # Enumerific Library Enumerations: Classes & Methods
@@ -860,4 +870,4 @@ See the documentation for [PyTest](https://docs.pytest.org/en/latest/) regarding
 
 ### Copyright & License Information
 
-Copyright © 2024–2025 Daniel Sissman; licensed under the MIT License.
+Copyright © 2024–2026 Daniel Sissman; licensed under the MIT License.

{enumerific-1.0.7 → enumerific-1.0.9}/source/enumerific/extensible.py

@@ -90,6 +90,7 @@ class auto(int, anno):
 
     start: int = 0
     steps: int = 1
+    times: int = 0
     power: int = 0
     value: int = 0
 
@@ -1378,7 +1379,7 @@ class EnumerationMetaClass(type):
 
         return self._instance.__name__
 
-    def register(self, name: str, value: object) -> Enumeration:
+    def register(self, name: str, value: object = auto()) -> Enumeration:
         """The 'register' method supports registering additional enumeration options for
         an existing enumeration class. The method accepts the name of the enumeration
         option and its corresponding value; these are then mapped into a new enumeration
@@ -1459,44 +1460,59 @@ class EnumerationMetaClass(type):
         name: str = None,
         caselessly: bool = False,
         annotation: str = None,
+        **annotations: dict[str, object],
     ) -> Enumeration | None:
         """The 'reconcile' method can be used to reconcile Enumeration type, enumeration
         values, or enumeration names to their matching Enumeration type instances. If a
         match is found the Enumeration type instance will be returned otherwise None will
         be returned, unless the class is configured to raise an error for mismatches."""
 
-        if name is None and value is None:
+        if isinstance(annotation, str):
+            annotations[annotation] = value
+
+        if name is None and value is None and len(annotations) == 0:
             raise ValueError(
-                "Either the 'value' or 'name' argument must be specified when calling the 'reconcile' function!"
+                "Either a 'value', 'name' or annotation keyword argument must be specified when calling the 'reconcile' function!"
             )
 
         if not value is None and not isinstance(value, (Enumeration, object)):
             raise TypeError(
-                "The 'value' argument must reference an Enumeration type or have an enumeration value!"
+                "The 'value' argument, if specified, must reference an Enumeration type or have an enumeration value!"
             )
 
         if not name is None and not isinstance(name, str):
-            raise TypeError("The 'name' argument must have a string value!")
+            raise TypeError(
+                "The 'name' argument, if specified, must have a string value!"
+            )
 
         reconciled: Enumeration = None
 
         for attribute, enumeration in self._enumerations.items():
-            if isinstance(annotation, str):
-                if annotation in enumeration._annotations:
-                    if enumeration._annotations[annotation] is value:
-                        reconciled = enumeration
-                        break
-                    elif enumeration._annotations[annotation] == value:
-                        reconciled = enumeration
-                        break
-                else:
-                    raise EnumerationOptionError(
-                        "The enumeration option, %s, has no '%s' annotation!"
-                        % (
-                            enumeration,
-                            annotation,
+            if len(annotations) > 0:
+                comparisons: list[bool] = []
+
+                for annotation, value in annotations.items():
+                    if annotation in enumeration._annotations:
+                        if enumeration._annotations[annotation] is value:
+                            comparisons.append(True)
+                        elif enumeration._annotations[annotation] == value:
+                            comparisons.append(True)
+                        else:
+                            comparisons.append(False)
+                    else:
+                        comparisons.append(False)
+
+                        logger.debug(
+                            "The enumeration option, %s, has no '%s' annotation!"
+                            % (
+                                enumeration,
+                                annotation,
+                            )
                         )
-                    )
+
+                if len(comparisons) == len(annotations) and False not in comparisons:
+                    reconciled = enumeration
+                    break
             elif isinstance(value, Enumeration):
                 if enumeration is value:
                     reconciled = enumeration

enumerific-1.0.9/source/enumerific/version.txt

@@ -0,0 +1 @@
+1.0.9

{enumerific-1.0.7 → enumerific-1.0.9/source/enumerific.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: enumerific
-Version: 1.0.7
+Version: 1.0.9
 Summary: Simplifies working with Python enums.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -690,8 +690,8 @@ class Colors(Enumeration):
 # Ensure that the Colors enumeration subclass is of the expected types
 assert issubclass(Colors, Enumeration)
 
-# Attempt to reconcile a Color against one of its annotations
-color = Colors.reconcile(value=(255, 0, 0), annotation="RGB")
+# Attempt to reconcile a Color against one of its annotations (via annotation keyword)
+color = Colors.reconcile(RGB=(255, 0, 0))
 
 assert isinstance(color, Colors)
 assert isinstance(color, Enumeration)
@@ -699,6 +699,16 @@ assert isinstance(color, Enumeration)
 assert color.name == "RED"
 assert color.value == 1
 assert color.RGB == (255, 0, 0)
+
+# Attempt to reconcile a Color against one of its annotations (via annotation argument)
+color = Colors.reconcile(value=(0, 255, 0), annotation="RGB")
+
+assert isinstance(color, Colors)
+assert isinstance(color, Enumeration)
+
+assert color.name == "GREEN"
+assert color.value == 2
+assert color.RGB == (0, 255, 0)
 ```
 
 # Enumerific Library Enumerations: Classes & Methods
@@ -890,4 +900,4 @@ See the documentation for [PyTest](https://docs.pytest.org/en/latest/) regarding
 
 ### Copyright & License Information
 
-Copyright © 2024–2025 Daniel Sissman; licensed under the MIT License.
+Copyright © 2024–2026 Daniel Sissman; licensed under the MIT License.

{enumerific-1.0.7 → enumerific-1.0.9}/tests/test_extensible_enums.py

@@ -1820,24 +1820,49 @@ def test_annotation_reconciliation():
     class Colors(Enumeration):
         """Create a test Color enumeration based on the Enumeration class"""
 
-        RED = auto(RGB=(255, 0, 0))
+        RED = auto(RGB=(255, 0, 0), primary=True)
         ORANGE = auto(RGB=(255, 165, 0))
-        YELLOW = auto(RGB=(255, 255, 0))
+        YELLOW = auto(RGB=(255, 255, 0), primary=True)
         GREEN = auto(RGB=(0, 255, 0))
-        BLUE = auto(RGB=(0, 0, 255))
+        BLUE = auto(RGB=(0, 0, 255), primary=True)
         VIOLET = auto(RGB=(255, 0, 255))
 
     # Ensure that the Colors enumeration subclass is of the expected types
     assert issubclass(Colors, Enumeration)
     assert issubclass(Colors, EnumerationInteger)
 
-    # Attempt to reconcile a Color against one of its annotations
-    color = Colors.reconcile(value=(255, 0, 0), annotation="RGB")
+    # Attempt to reconcile a Color against one of its annotations (via annotation keyword)
+    color = Colors.reconcile(RGB=(255, 0, 0))
 
     assert isinstance(color, Colors)
     assert isinstance(color, Enumeration)
-    assert isinstance(color, EnumerationInteger)
 
     assert color.name == "RED"
     assert color.value == 1
     assert color.RGB == (255, 0, 0)
+
+    # Attempt to reconcile a Color against two of its annotations (via annotation keywords)
+    color = Colors.reconcile(RGB=(255, 255, 0), primary=True)
+
+    assert isinstance(color, Colors)
+    assert isinstance(color, Enumeration)
+
+    assert color.name == "YELLOW"
+    assert color.value == 3
+    assert color.RGB == (255, 255, 0)
+
+    # Attempt to reconcile a Color against one of its annotations (via annotation argument)
+    color = Colors.reconcile(value=(0, 255, 0), annotation="RGB")
+
+    assert isinstance(color, Colors)
+    assert isinstance(color, Enumeration)
+
+    assert color.name == "GREEN"
+    assert color.value == 4
+    assert color.RGB == (0, 255, 0)
+
+    # Test reconciliation against a non-existent option
+    color = Colors.reconcile(RGB=(125, 125, 125))
+
+    # Ensure the return value is None when a matching enumeration option cannot be found
+    assert color is None

enumerific-1.0.7/source/enumerific/version.txt

@@ -1 +0,0 @@
-1.0.7