UniversalFunctions 2.0.0__tar.gz → 2.1.1__tar.gz

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UniversalFunctions
-Version: 2.0.0
+Version: 2.1.1
 Summary: A Python utility library providing foundational functions, validators, and infrastructure.
 Author-email: "Miah M. Sabiq" <miah.sabiq@gibs.at>
 Requires-Python: >=3.14

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UF/ClassToDict.py

@@ -17,6 +17,7 @@ def classes_to_dict(*classes: type) -> dict[str, Callable]:
     >>> result = classes_to_dict(RandomClass)
     >>> list(result)
     ['get_item']
+
     :param classes: Classes from which the callables are extracted
     :return: Dictionary of callable names and their objects
     """

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UF/Trigonometry.py

@@ -16,6 +16,10 @@ from .Validators import real_validate
 def sine(angle: Real) -> Real:
     """
     Calculates the sine of a given angle
+
+    >>> sin(0)
+    0
+
     :param angle: value required in degrees
     :return: sine value
     """
@@ -25,6 +29,10 @@ def sine(angle: Real) -> Real:
 def cosine(angle: Real) -> Real:
     """
     Calculates the cosine of a given angle
+
+    >>> cosine(0)
+    1
+
     :param angle: value required in degrees
     :return: cosine value
     """
@@ -34,6 +42,10 @@ def cosine(angle: Real) -> Real:
 def asine(value: Real) -> Real:
     """
     Calculates the asine of a given angle
+
+    >>> asine(0)
+    0
+
     :param value: real value
     :return: asine value
     """

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UF/Validators/Errors.py

@@ -17,6 +17,8 @@ class ErrorDedent:
     way it would be printed otherwise.
 
     >>> print(ErrorDedent(TypeError)("This is a TypeError!"))
+    TypeError
+    <BLANKLINE>
     This is a TypeError!
     """
     name: Final[Literal["ErrorDedent"]] = "ErrorDedent"
@@ -40,13 +42,19 @@ class ErrorDedent:
                 expected: str
                 received: {text}
                 """).strip())
-        return self.error_func(dedent(text).strip())
+        return self.error_func(dedent(f"""
+            {self.error_func.__name__}
+            
+            {text}
+            """).strip())
 
 def type_error() -> Callable:
     """
     This function returns a callable type error function.
 
     >>> print(type_error()("This is a TypeError!"))
+    TypeError
+    <BLANKLINE>
     This is a TypeError!
 
     :return: ErrorDedent function
@@ -58,6 +66,8 @@ def value_error() -> Callable:
     This function returns a callable value error function.
 
     >>> print(value_error()("This is a ValueError!"))
+    ValueError
+    <BLANKLINE>
     This is a ValueError!
 
     :return: ErrorDedent function
@@ -69,6 +79,8 @@ def item_count_error() -> Callable:
     This function returns a callable item count error function.
 
     >>> print(item_count_error()("This is an Item Count Error!"))
+    ItemCountError
+    <BLANKLINE>
     This is an Item Count Error!
 
     :return: ErrorDedent function
@@ -80,12 +92,27 @@ def constraint_error() -> Callable:
     This function returns a callable constraint error function.
 
     >>> print(constraint_error()("This is a Constraint Error!"))
+    ConstraintError
+    <BLANKLINE>
     This is a Constraint Error!
 
     :return: ErrorDedent function
     """
     return ErrorDedent(ConstraintError)
 
+def attribute_error() -> Callable:
+    """
+    This function returns a callable attribute error function.
+
+    >>> print(attribute_error()("This is an Attribute Error!"))
+    AttributeError
+    <BLANKLINE>
+    This is an Attribute Error!
+
+    :return: ErrorDedent function
+    """
+    return ErrorDedent(AttributeError)
+
 class ItemCountError(Exception):
     """
     This exception is raised when an item count does not match the expected count.

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UF/Validators/QuantumValidators.py

@@ -23,8 +23,6 @@ def qtm_lt_validator(value: list[Any] | tuple[Any, ...], TYPE: Any, name: str) -
     origin = get_origin(TYPE)
     if origin not in (list, tuple):
         raise type_error()(f"""
-            TypeError
-            
             Validator: {func_name}
             Parameter TYPE must be a list/tuple of elements!
             Expected: type object
@@ -49,8 +47,6 @@ def qtm_constr_validator(value: Any, annotation, name: str) -> Any:
     func_name: Final[Literal["qtm_constr_validator"]] = "qtm_constr_validator"
     if get_origin(annotation) is not Annotated:
         raise type_error()(f"""
-            TypeError
-            
             Validator: {func_name}
             Parameter annotation is not an Annotated type!
             Expected: Annotated object

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UF/Validators/ValidationClasses.py

@@ -34,8 +34,6 @@ class TypeValidate:
             for item in expected:
                 if not isinstance(item, type):
                     raise type_error()(f"""
-                        TypeError
-                        
                         Validator: {self.name}
                         Entered value {item!r} is not a type object!
                         Expected: type object
@@ -50,8 +48,6 @@ class TypeValidate:
 
         else:
             raise type_error()(f"""
-                TypeError
-                
                 Validator: {self.name}
                 Parameter 'expected' MUST be a type object or a tuple of type objects!
                 Expected: type|tuple
@@ -64,8 +60,6 @@ class TypeValidate:
         """Validates the entered value, expected to be of expected type"""
         if name is not None and not isinstance(name, str):
             raise type_error()(f"""
-            TypeError
-            
             Validator: {self.name}
             Parameter 'name' MUST be a string object!
             Expected: str (name of value)
@@ -82,8 +76,6 @@ class TypeValidate:
 
                 if name is not None:
                     raise type_error()(f"""
-                        TypeError
-                        
                         Validator: {self.name}
                         Parameter {name!r} is not of expected type {expected_type!r}!
                         Expected: {expected_type}
@@ -93,7 +85,6 @@ class TypeValidate:
                             Type: {value_type}
                         """)
                 raise type_error()(f"""
-                    TypeError
                     Validator: {self.name}
                     Parameter value is not of expected type {expected_type!r}!
                     Expected: {expected_type}
@@ -107,8 +98,6 @@ class TypeValidate:
 
                 if name is not None:
                     raise type_error()(f"""
-                        TypeError
-                        
                         Validator: {self.name}
                         Parameter {name!r} is not of expected type {expected_type!r}!
                         Expected: {expected_type}
@@ -118,8 +107,6 @@ class TypeValidate:
                             Type: {value_type}
                         """)
                 raise type_error()(f"""
-                    TypeError
-                    
                     Validator: {self.name}
                     Parameter value is not of expected type {expected_type!r}!
                     Expected: {expected_type}
@@ -185,8 +172,6 @@ class Positive:
 
         if value <= 0:
             raise constraint_error()(f"""
-                ConstraintError
-                
                 Validator: {self.name}
                 Parameter value is expected to be greater than 0!
                 Expected: value > 0
@@ -216,8 +201,6 @@ class LessThan(RealValidationParent):
 
         if value >= self.expected:
             raise constraint_error()(f"""
-                ConstraintError
-                
                 Validator: {self.name}
                 Parameter value is expected to be less than {self.expected!r}!
                 Expected: {self.expected}
@@ -249,8 +232,6 @@ class LessOrEqual(RealValidationParent):
 
         if value > self.expected:
             raise constraint_error()(f"""
-                ConstraintError
-                
                 Validator: {self.name}
                 Parameter value is expected to be less than or equal to {self.expected!r}!
                 Expected: {self.expected}
@@ -281,8 +262,6 @@ class GreaterThan(RealValidationParent):
 
         if self.expected >= value:
             raise constraint_error()(f"""
-                ConstraintError
-                
                 Validator: {self.name}
                 Parameter value is expected to be greater than {self.expected!r}!
                 Expected: {self.expected}
@@ -314,8 +293,6 @@ class GreaterOrEqual(RealValidationParent):
 
         if self.expected > value:
             raise constraint_error()(f"""
-                ConstraintError
-                
                 Validator: {self.name}
                 Parameter value is expected to be greater than or equal to {self.expected!r}!
                 Expected: {self.expected}
@@ -346,8 +323,6 @@ class SequenceValidate:
             else:
                 if expected[-1] is not Ellipsis:
                     raise type_error()(f"""
-                        TypeError
-                        
                         Validator: {self.name}
                         The last item in 'expected' is expected to be an ellipsis type!
                         Expected: ellipsis type
@@ -389,8 +364,6 @@ class SequenceValidate:
         else:
             if len(self.expected) != len(value):
                 raise item_count_error()(f"""
-                    ItemCountError
-                    
                     Validator: {self.name}
                     Parameter value ({name}) must have the same number of elements as the provided expected tuple!
                     Expected number of items: {len(self.expected)}

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UF/Validators/__init__.py

@@ -21,6 +21,7 @@ from .Errors import (
     value_error,
     item_count_error,
     constraint_error,
+    attribute_error,
     ItemCountError,
     ConstraintError,
 )
@@ -50,6 +51,7 @@ __all__ = [
     "value_error",
     "item_count_error",
     "constraint_error",
+    "attribute_error",
     "ItemCountError",
     "ConstraintError",
 

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UF/__init__.py

@@ -56,6 +56,7 @@ __all__ = [
     "value_error",
     "item_count_error",
     "constraint_error",
+    "attribute_error",
     "ItemCountError",
     "ConstraintError",
 

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/UniversalFunctions.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UniversalFunctions
-Version: 2.0.0
+Version: 2.1.1
 Summary: A Python utility library providing foundational functions, validators, and infrastructure.
 Author-email: "Miah M. Sabiq" <miah.sabiq@gibs.at>
 Requires-Python: >=3.14

{universalfunctions-2.0.0 → universalfunctions-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "UniversalFunctions"
-version = "2.0.0"
+version = "2.1.1"
 description = "A Python utility library providing foundational functions, validators, and infrastructure."
 readme = "README.md"
 requires-python = ">=3.14"