enumerific 1.0.0__tar.gz → 1.0.1__tar.gz

{enumerific-1.0.0/source/enumerific.egg-info → enumerific-1.0.1}/PKG-INFO

@@ -1,44 +1,32 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: enumerific
-Version: 1.0.0
+Version: 1.0.1
 Summary: Simplifies working with Python enums.
 Author: Daniel Sissman
-License: MIT License
-        
-        Copyright © 2024–2025 Daniel Sissman.
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-Project-URL: Documentation, https://github.com/bluebinary/enumerific/blob/main/README.md
-Project-URL: Changelog, https://github.com/bluebinary/enumerific/blob/main/CHANGELOG.md
-Project-URL: Repository, https://github.com/bluebinary/enumerific
-Project-URL: Issues, https://github.com/bluebinary/enumerific/issues
+License-Expression: MIT
+Project-URL: documentation, https://github.com/bluebinary/enumerific/blob/main/README.md
+Project-URL: changelog, https://github.com/bluebinary/enumerific/blob/main/CHANGELOG.md
+Project-URL: repository, https://github.com/bluebinary/enumerific
+Project-URL: issues, https://github.com/bluebinary/enumerific/issues
+Project-URL: homepage, https://github.com/bluebinary/enumerific
 Keywords: enum,enumeration,enumerations
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.9
+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: pytest==8.3.*; extra == "development"
+Requires-Dist: pytest-codeblocks==0.17.0; extra == "development"
+Provides-Extra: distribution
+Requires-Dist: build; extra == "distribution"
+Requires-Dist: twine; extra == "distribution"
+Requires-Dist: wheel; extra == "distribution"
+Dynamic: license-file
 
 # Enumerific Enums
 
@@ -46,11 +34,15 @@ The `enumerific` library provides several useful extensions to the Python built-
 
 ### Requirements
 
-The Enumerific library has been tested with Python 3.9, 3.10, 3.11, 3.12 and 3.13 but may work with some earlier versions such as 3.8, but has not been tested against this version or any earlier. The library is not compatible with Python 2.* or earlier.
+The Enumerific library has been tested with Python 3.10, 3.11, 3.12 and 3.13, and is not
+compatible with Python 3.9 or earlier.
 
 ### Installation
 
-The Enumerific library is available from PyPi, so may be added to a project's dependencies via its `requirements.txt` file or similar by referencing the Enumerific library's name, `enumerific`, or the library may be installed directly into your local runtime environment using `pip install` by entering the following command, and following any prompts:
+Enumerific is available from the PyPI, so may be added to a project's dependencies via
+its `requirements.txt` file or similar by referencing the library's name, `enumerific`,
+or the library may be installed directly into your local runtime environment using `pip`
+by entering the following command, and following any prompts:
 
 	$ pip install enumerific
 
@@ -58,10 +50,23 @@ The Enumerific library is available from PyPi, so may be added to a project's de
 
 To use the Enumerific library, simply import the library and use it like you would the built-in `enum` library as a drop-in replacement:
 
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
+val = MyEnum.Option1
 ```
-import enumerific
 
-class MyEnum(enumerific.Enum):
+Alternatively, to make use of the extra functionality for the standard library's `Enum`
+class, import the `Enum` class from the Enumerific library:
+
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
   Option1 = "ABC"
   Option2 = "DEF"
 
@@ -70,12 +75,11 @@ val = MyEnum.Option1
 
 You can also import the `Enum` class directly from the `enumerific` library and use it directly:
 
-```
+```python
 from enumerific import Enum
 
 class MyEnum(Enum):
   Option1 = "ABC"
-  ...
 ```
 
 The Enumerific library's own `Enum` class is a subclass of the built-in `enum.Enum` class, so all of the built-in functionality of `enum.Enum` is available, as well as several additional class methods:
@@ -88,7 +92,7 @@ The benefits of being able to validate and reconcile various input values agains
 
 Some examples of use include the following code samples, where each make use of the example `MyEnum` class, defined as follows:
 
-```
+```python
 from enumerific import Enum
 
 class MyEnum(Enum):
@@ -98,7 +102,13 @@ class MyEnum(Enum):
 
 #### Example 1: Reconciling a Value
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 # Given a string value in this case
 value = "ABC"
 
@@ -111,7 +121,13 @@ assert value is MyEnum.Option1  # asserts successfully as enums are singletons
 
 #### Example 2: Reconciling an Enumeration Option Name
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 # Given a string value in this case
 value = "Option1"
 
@@ -124,7 +140,13 @@ assert value is MyEnum.Option1  # asserts successfully as enums are singletons
 
 #### Example 3: Validating a Value
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 # The value can be an enumeration option's name, its value, or the enumeration option
 value = "Option1"
 value = "ABC"
@@ -132,13 +154,21 @@ value = MyEnum.Option1
 
 if MyEnum.validate(value) is True:
     # do something if the value could be validated
+    pass
 else:
     # do something else if the value could not be validated
+    pass
 ```
 
 #### Example 4: Iterating Over Enumeration Options
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 for option in MyEnum.options():
     # do something with each option
     print(option.name, option.value)
@@ -150,14 +180,14 @@ The Enumerific library includes a suite of comprehensive unit tests which ensure
 
 To ensure that the unit tests are run within a predictable runtime environment where all of the necessary dependencies are available, a [Docker](https://www.docker.com) image is created within which the tests are run. To run the unit tests, ensure Docker and Docker Compose is [installed](https://docs.docker.com/engine/install/), and perform the following commands, which will build the Docker image via `docker compose build` and then run the tests via `docker compose run` – the output of running the tests will be displayed:
 
-```
+```shell
 $ docker compose build
 $ docker compose run tests
 ```
 
 To run the unit tests with optional command line arguments being passed to `pytest`, append the relevant arguments to the `docker compose run tests` command, as follows, for example passing `-vv` to enable verbose output:
 
-```
+```shell
 $ docker compose run tests -vv
 ```
 
@@ -165,4 +195,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–2025 Daniel Sissman; licensed under the MIT License.

{enumerific-1.0.0 → enumerific-1.0.1}/README.md

@@ -4,11 +4,15 @@ The `enumerific` library provides several useful extensions to the Python built-
 
 ### Requirements
 
-The Enumerific library has been tested with Python 3.9, 3.10, 3.11, 3.12 and 3.13 but may work with some earlier versions such as 3.8, but has not been tested against this version or any earlier. The library is not compatible with Python 2.* or earlier.
+The Enumerific library has been tested with Python 3.10, 3.11, 3.12 and 3.13, and is not
+compatible with Python 3.9 or earlier.
 
 ### Installation
 
-The Enumerific library is available from PyPi, so may be added to a project's dependencies via its `requirements.txt` file or similar by referencing the Enumerific library's name, `enumerific`, or the library may be installed directly into your local runtime environment using `pip install` by entering the following command, and following any prompts:
+Enumerific is available from the PyPI, so may be added to a project's dependencies via
+its `requirements.txt` file or similar by referencing the library's name, `enumerific`,
+or the library may be installed directly into your local runtime environment using `pip`
+by entering the following command, and following any prompts:
 
 	$ pip install enumerific
 
@@ -16,10 +20,23 @@ The Enumerific library is available from PyPi, so may be added to a project's de
 
 To use the Enumerific library, simply import the library and use it like you would the built-in `enum` library as a drop-in replacement:
 
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
+val = MyEnum.Option1
 ```
-import enumerific
 
-class MyEnum(enumerific.Enum):
+Alternatively, to make use of the extra functionality for the standard library's `Enum`
+class, import the `Enum` class from the Enumerific library:
+
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
   Option1 = "ABC"
   Option2 = "DEF"
 
@@ -28,12 +45,11 @@ val = MyEnum.Option1
 
 You can also import the `Enum` class directly from the `enumerific` library and use it directly:
 
-```
+```python
 from enumerific import Enum
 
 class MyEnum(Enum):
   Option1 = "ABC"
-  ...
 ```
 
 The Enumerific library's own `Enum` class is a subclass of the built-in `enum.Enum` class, so all of the built-in functionality of `enum.Enum` is available, as well as several additional class methods:
@@ -46,7 +62,7 @@ The benefits of being able to validate and reconcile various input values agains
 
 Some examples of use include the following code samples, where each make use of the example `MyEnum` class, defined as follows:
 
-```
+```python
 from enumerific import Enum
 
 class MyEnum(Enum):
@@ -56,7 +72,13 @@ class MyEnum(Enum):
 
 #### Example 1: Reconciling a Value
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 # Given a string value in this case
 value = "ABC"
 
@@ -69,7 +91,13 @@ assert value is MyEnum.Option1  # asserts successfully as enums are singletons
 
 #### Example 2: Reconciling an Enumeration Option Name
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 # Given a string value in this case
 value = "Option1"
 
@@ -82,7 +110,13 @@ assert value is MyEnum.Option1  # asserts successfully as enums are singletons
 
 #### Example 3: Validating a Value
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 # The value can be an enumeration option's name, its value, or the enumeration option
 value = "Option1"
 value = "ABC"
@@ -90,13 +124,21 @@ value = MyEnum.Option1
 
 if MyEnum.validate(value) is True:
     # do something if the value could be validated
+    pass
 else:
     # do something else if the value could not be validated
+    pass
 ```
 
 #### Example 4: Iterating Over Enumeration Options
 
-```
+```python
+from enumerific import Enum
+
+class MyEnum(Enum):
+  Option1 = "ABC"
+  Option2 = "DEF"
+
 for option in MyEnum.options():
     # do something with each option
     print(option.name, option.value)
@@ -108,14 +150,14 @@ The Enumerific library includes a suite of comprehensive unit tests which ensure
 
 To ensure that the unit tests are run within a predictable runtime environment where all of the necessary dependencies are available, a [Docker](https://www.docker.com) image is created within which the tests are run. To run the unit tests, ensure Docker and Docker Compose is [installed](https://docs.docker.com/engine/install/), and perform the following commands, which will build the Docker image via `docker compose build` and then run the tests via `docker compose run` – the output of running the tests will be displayed:
 
-```
+```shell
 $ docker compose build
 $ docker compose run tests
 ```
 
 To run the unit tests with optional command line arguments being passed to `pytest`, append the relevant arguments to the `docker compose run tests` command, as follows, for example passing `-vv` to enable verbose output:
 
-```
+```shell
 $ docker compose run tests -vv
 ```
 
@@ -123,4 +165,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–2025 Daniel Sissman; licensed under the MIT License.

{enumerific-1.0.0 → enumerific-1.0.1}/pyproject.toml

@@ -4,24 +4,27 @@ description = "Simplifies working with Python enums."
 readme = {file = "README.md", content-type = "text/markdown"}
 keywords = ["enum", "enumeration", "enumerations"]
 authors = [{name = "Daniel Sissman"}]
-license = {file = "LICENSE.md", content-type = "text/markdown"}
+license = "MIT"
 classifiers = [
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
 ]
-requires-python = ">=3.9"
-dynamic = ["version"]
+requires-python = ">=3.10"
+dynamic = [
+  "version",
+  "dependencies",
+  "optional-dependencies",
+]
 
 [project.urls]
-Documentation = "https://github.com/bluebinary/enumerific/blob/main/README.md"
-Changelog = "https://github.com/bluebinary/enumerific/blob/main/CHANGELOG.md"
-Repository = "https://github.com/bluebinary/enumerific"
-Issues = "https://github.com/bluebinary/enumerific/issues"
+documentation = "https://github.com/bluebinary/enumerific/blob/main/README.md"
+changelog = "https://github.com/bluebinary/enumerific/blob/main/CHANGELOG.md"
+repository = "https://github.com/bluebinary/enumerific"
+issues = "https://github.com/bluebinary/enumerific/issues"
+homepage = "https://github.com/bluebinary/enumerific"
 
 [build-system]
 requires = ["setuptools", "wheel"]
@@ -29,6 +32,11 @@ build-backend = "setuptools.build_meta"
 
 [tool.setuptools.dynamic]
 version = {file = "source/enumerific/version.txt"}
+dependencies = {file = "requirements.txt"}
+
+[tool.setuptools.dynamic.optional-dependencies]
+development = {file = "requirements.development.txt"}
+distribution = {file = "requirements.distribution.txt"}
 
 [tool.setuptools]
 zip-safe = true

enumerific-1.0.1/requirements.development.txt

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

enumerific-1.0.1/requirements.distribution.txt

@@ -0,0 +1,4 @@
+# Enumerific Library: Build & Deployment Dependencies
+build
+twine
+wheel

enumerific-1.0.1/requirements.txt

@@ -0,0 +1 @@
+# Enumerific Library: Runtime Dependencies

enumerific-1.0.1/source/enumerific/__init__.py

@@ -0,0 +1,23 @@
+from enum import *
+
+from .logging import logger
+
+from .exceptions import EnumValueError
+
+from .extensible import (
+    Enumeration,
+    EnumerationType,
+    EnumerationInteger,
+    EnumerationString,
+    EnumerationFloat,
+    EnumerationComplex,
+    EnumerationBytes,
+    EnumerationTuple,
+    EnumerationSet,
+    EnumerationList,
+    EnumerationDictionary,
+    EnumerationFlag,
+    auto,
+)
+
+from .standard import Enum

enumerific-1.0.1/source/enumerific/exceptions.py

@@ -0,0 +1,18 @@
+class EnumValueError(ValueError):
+    pass
+
+
+class EnumerationError(RuntimeError):
+    pass
+
+
+class EnumerationOptionError(AttributeError, EnumerationError):
+    pass
+
+
+class EnumerationSubclassingError(EnumerationError):
+    pass
+
+
+class EnumerationNonUniqueError(EnumerationError):
+    pass