enumerific 1.0.9__py3-none-any.whl → 1.1.0__py3-none-any.whl

enumerific/extensible.py

@@ -15,7 +15,6 @@ from enumerific.exceptions import (
 
 from types import MappingProxyType
 
-
 logger = logger.getChild(__name__)
 
 
@@ -750,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])
@@ -1107,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",
@@ -1341,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."""

enumerific/standard.py

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

enumerific/version.txt

@@ -1 +1 @@
-1.0.9
+1.1.0

{enumerific-1.0.9.dist-info → enumerific-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: enumerific
-Version: 1.0.9
+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;

enumerific-1.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+enumerific/__init__.py,sha256=K9iFirgxSkrHgXfhocOvgRkskGe0VfWRgxEvppnVWBM,587
+enumerific/exceptions.py,sha256=lvfcH1cz43hDjzSUpgm1-OZjKzxo--fyZ8UsBS-GiZA,359
+enumerific/extensible.py,sha256=Jisn5pPLl8UoeC-akg5wasoFOCJjwNXTNAWs-oGD94E,87640
+enumerific/logging.py,sha256=zz1Phnot1BFWMoxwvZ0FlZDsiYZZYhz-_S4IzgPYc40,97
+enumerific/standard.py,sha256=lQqEwXRrQtRYsyfZmCUmNUh7wDvNaP_w_E6okPV_QMA,3253
+enumerific/version.txt,sha256=f70hDr7BH2WpcZDvkAeVxLjaOAWvP1objR0nJVaykso,5
+enumerific-1.1.0.dist-info/licenses/LICENSE.md,sha256=j1XidOCGUhPx7CyXA31uC0XGKDRnvUcZpMp161qHI6g,1077
+enumerific-1.1.0.dist-info/METADATA,sha256=zFgJmPHy1GRbQzC2eaIj5QiLyRVOKvISOdYFKNHe1mo,34430
+enumerific-1.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+enumerific-1.1.0.dist-info/top_level.txt,sha256=hyemsMgPYZgSx71XHmFRF-gvc_2Y4rDAESR8e0hbYHU,11
+enumerific-1.1.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+enumerific-1.1.0.dist-info/RECORD,,

{enumerific-1.0.9.dist-info → enumerific-1.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

enumerific-1.0.9.dist-info/RECORD

@@ -1,12 +0,0 @@
-enumerific/__init__.py,sha256=K9iFirgxSkrHgXfhocOvgRkskGe0VfWRgxEvppnVWBM,587
-enumerific/exceptions.py,sha256=lvfcH1cz43hDjzSUpgm1-OZjKzxo--fyZ8UsBS-GiZA,359
-enumerific/extensible.py,sha256=JPr4LRGg4rABV_WO9Yzb6FJhrxwiafju7ITIQXW6QiY,87136
-enumerific/logging.py,sha256=zz1Phnot1BFWMoxwvZ0FlZDsiYZZYhz-_S4IzgPYc40,97
-enumerific/standard.py,sha256=xQhhwlcYZ6-8DmgscbV38g2Ol5Z8_vvBwonz-Ww0I40,3254
-enumerific/version.txt,sha256=1vkXxITmpI_Pi5DvCc3gKGw9huXerUi0L68NrpT7LfU,5
-enumerific-1.0.9.dist-info/licenses/LICENSE.md,sha256=j1XidOCGUhPx7CyXA31uC0XGKDRnvUcZpMp161qHI6g,1077
-enumerific-1.0.9.dist-info/METADATA,sha256=LnOD66jWq4fMD79UFTvZA-ILzxh89gdNKs8485h-3b8,34237
-enumerific-1.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-enumerific-1.0.9.dist-info/top_level.txt,sha256=hyemsMgPYZgSx71XHmFRF-gvc_2Y4rDAESR8e0hbYHU,11
-enumerific-1.0.9.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-enumerific-1.0.9.dist-info/RECORD,,