enumerific 1.0.8__tar.gz → 1.1.0__tar.gz

{enumerific-1.0.8/source/enumerific.egg-info → enumerific-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: enumerific
-Version: 1.0.8
+Version: 1.1.0
 Summary: Simplifies working with Python enums.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -19,7 +19,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Provides-Extra: development
-Requires-Dist: black==24.10.*; extra == "development"
+Requires-Dist: black==26.1.*; extra == "development"
 Requires-Dist: pytest==8.3.*; extra == "development"
 Requires-Dist: pytest-codeblocks==0.17.0; extra == "development"
 Provides-Extra: distribution
@@ -49,7 +49,7 @@ The Enumerific library's `Enumeration` class offers the following features:
  * Simple one-line reconciliation of `Enumeration` class options to the corresponding `enums.Enum` class instance that represents the corresponding option; reconciliation by enumeration option name, value and enumeration class instance reference are all supported through the `.reconcile()` class method;
  * Simple one-line validation of `Enumeration` class options; validation by enumeration option name, value and enumeration class instance reference are all supported through the `.validate()` class method;
  * Simple access to all of the options provided by an `Enumeration` class instance through the `.options()` class method;
- * Access to all of the names of the `Enumeration` class options via the `.names()` method;
+ * Access to all of the names of the `Enumeration` class options via the `.names()` method, which also takes the optional `uppercase` (`bool`) or `lowercase` (`bool`) keyword arguments which can be used to optionally obtain the names in their uppercase or lowercase forms respectively;
  * Access to all of the names/keys of the `Enumeration` class options via the `.keys()` method;
  * Access to all of the values of the `Enumeration` class options via the `.values()` method;
  * Access to all of the key-value pairs of the `Enumeration` class options via the `.items()` method;
@@ -900,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.8 → enumerific-1.1.0}/README.md

@@ -19,7 +19,7 @@ The Enumerific library's `Enumeration` class offers the following features:
  * Simple one-line reconciliation of `Enumeration` class options to the corresponding `enums.Enum` class instance that represents the corresponding option; reconciliation by enumeration option name, value and enumeration class instance reference are all supported through the `.reconcile()` class method;
  * Simple one-line validation of `Enumeration` class options; validation by enumeration option name, value and enumeration class instance reference are all supported through the `.validate()` class method;
  * Simple access to all of the options provided by an `Enumeration` class instance through the `.options()` class method;
- * Access to all of the names of the `Enumeration` class options via the `.names()` method;
+ * Access to all of the names of the `Enumeration` class options via the `.names()` method, which also takes the optional `uppercase` (`bool`) or `lowercase` (`bool`) keyword arguments which can be used to optionally obtain the names in their uppercase or lowercase forms respectively;
  * Access to all of the names/keys of the `Enumeration` class options via the `.keys()` method;
  * Access to all of the values of the `Enumeration` class options via the `.values()` method;
  * Access to all of the key-value pairs of the `Enumeration` class options via the `.items()` method;
@@ -870,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.8 → enumerific-1.1.0}/requirements.development.txt

@@ -1,4 +1,4 @@
 # Enumerific Library: Development & Test Dependencies
-black==24.10.*
+black==26.1.*
 pytest==8.3.*
 pytest-codeblocks==0.17.0

{enumerific-1.0.8 → enumerific-1.1.0}/source/enumerific/extensible.py

@@ -15,7 +15,6 @@ from enumerific.exceptions import (
 
 from types import MappingProxyType
 
-
 logger = logger.getChild(__name__)
 
 
@@ -90,6 +89,7 @@ class auto(int, anno):
 
     start: int = 0
     steps: int = 1
+    times: int = 0
     power: int = 0
     value: int = 0
 
@@ -749,7 +749,7 @@ class EnumerationMetaClass(type):
             typecast=typecast,
         )
 
-        (name, bases, attributes) = args  # Unpack the arguments passed to the metaclass
+        name, bases, attributes = args  # Unpack the arguments passed to the metaclass
 
         logger.debug(" >>> name          => %s", name)
         logger.debug(" >>> bases         => %s", [base for base in bases])
@@ -1106,7 +1106,7 @@ class EnumerationMetaClass(type):
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
-        (name, bases, attributes) = args
+        name, bases, attributes = args
 
         logger.debug(
             "[EnumerationMetaClass] %s.__init__(args: %s, kwargs: %s) => name => %s => bases => %s",
@@ -1340,12 +1340,25 @@ class EnumerationMetaClass(type):
 
         return types.pop() if len(types) == 1 else EnumerationType.MIXED
 
-    def names(self) -> list[str]:
+    def names(self, uppercase: bool = False, lowercase: bool = False) -> list[str]:
         """The 'names' method returns a list of the enumeration option names."""
 
         logger.debug("%s(%s).names()", self.__class__.__name__, type(self))
 
-        return [name for name in self._enumerations]
+        if not isinstance(uppercase, bool):
+            raise TypeError("The 'uppercase' argument must have a boolean value!")
+
+        if not isinstance(lowercase, bool):
+            raise TypeError("The 'lowercase' argument must have a boolean value!")
+
+        names: list[str] = [name for name in self._enumerations]
+
+        if uppercase is True:
+            names = [name.upper() for name in names]
+        elif lowercase is True:
+            names = [name.lower() for name in names]
+
+        return names
 
     def keys(self) -> list[str]:
         """The 'keys' method is an alias of 'names' method; the both return the same."""
@@ -1378,7 +1391,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

{enumerific-1.0.8 → enumerific-1.1.0}/source/enumerific/standard.py

@@ -6,7 +6,6 @@ from enumerific.logging import logger
 
 from enumerific.exceptions import EnumValueError
 
-
 logger = logger.getChild(__name__)
 
 

enumerific-1.1.0/source/enumerific/version.txt

@@ -0,0 +1 @@
+1.1.0

{enumerific-1.0.8 → enumerific-1.1.0/source/enumerific.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: enumerific
-Version: 1.0.8
+Version: 1.1.0
 Summary: Simplifies working with Python enums.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -19,7 +19,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Provides-Extra: development
-Requires-Dist: black==24.10.*; extra == "development"
+Requires-Dist: black==26.1.*; extra == "development"
 Requires-Dist: pytest==8.3.*; extra == "development"
 Requires-Dist: pytest-codeblocks==0.17.0; extra == "development"
 Provides-Extra: distribution
@@ -49,7 +49,7 @@ The Enumerific library's `Enumeration` class offers the following features:
  * Simple one-line reconciliation of `Enumeration` class options to the corresponding `enums.Enum` class instance that represents the corresponding option; reconciliation by enumeration option name, value and enumeration class instance reference are all supported through the `.reconcile()` class method;
  * Simple one-line validation of `Enumeration` class options; validation by enumeration option name, value and enumeration class instance reference are all supported through the `.validate()` class method;
  * Simple access to all of the options provided by an `Enumeration` class instance through the `.options()` class method;
- * Access to all of the names of the `Enumeration` class options via the `.names()` method;
+ * Access to all of the names of the `Enumeration` class options via the `.names()` method, which also takes the optional `uppercase` (`bool`) or `lowercase` (`bool`) keyword arguments which can be used to optionally obtain the names in their uppercase or lowercase forms respectively;
  * Access to all of the names/keys of the `Enumeration` class options via the `.keys()` method;
  * Access to all of the values of the `Enumeration` class options via the `.values()` method;
  * Access to all of the key-value pairs of the `Enumeration` class options via the `.items()` method;
@@ -900,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.8 → enumerific-1.1.0}/source/enumerific.egg-info/requires.txt

@@ -1,6 +1,6 @@
 
 [development]
-black==24.10.*
+black==26.1.*
 pytest==8.3.*
 pytest-codeblocks==0.17.0
 

{enumerific-1.0.8 → enumerific-1.1.0}/tests/test_extensible_enums.py

@@ -24,7 +24,6 @@ from enumerific import (
     anno,
 )
 
-
 logger = logging.getLogger(__name__)
 
 
@@ -1631,7 +1630,7 @@ def test_annotation_access():
             """Convert the RGB color code into its HLS equivalent."""
 
             # Normalize the RGB values into a 0-255 range first
-            (h, l, s) = colorsys.rgb_to_hls(
+            h, l, s = colorsys.rgb_to_hls(
                 self.RGB[0] / 255.0,
                 self.RGB[1] / 255.0,
                 self.RGB[2] / 255.0,
@@ -1643,7 +1642,7 @@ def test_annotation_access():
         def isWarm(self):
             """Roughly (just for test purposes) determine in the color is 'warm'"""
 
-            (hue, lightness, saturation) = self.HLS
+            hue, lightness, saturation = self.HLS
 
             return (
                 (0 <= hue < 115) and (0 < lightness <= 80) and (10 <= saturation <= 100)
@@ -1652,7 +1651,7 @@ def test_annotation_access():
         def isCool(self):
             """Roughly (just for test purposes) determine in the color is 'cool'"""
 
-            (hue, lightness, saturation) = self.HLS
+            hue, lightness, saturation = self.HLS
 
             return (
                 (115 <= hue <= 360) and (lightness <= 100) and (saturation <= 100)

enumerific-1.0.8/source/enumerific/version.txt

@@ -1 +0,0 @@
-1.0.8