orionis 0.709.0__py3-none-any.whl → 0.710.0__py3-none-any.whl

orionis/metadata/framework.py

@@ -6,7 +6,7 @@
 NAME = "orionis"
 
 # Current version of the framework
-VERSION = "0.709.0"
+VERSION = "0.710.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

orionis/test/exceptions/config.py

@@ -1,23 +1,13 @@
 class OrionisTestConfigException(Exception):
-
-    def __init__(self, msg: str):
-        """
-        Initialize the OrionisTestConfigException.
-
-        Parameters
-        ----------
-        msg : str
-            The error message describing the cause of the exception.
-        """
-        super().__init__(msg)
-
-    def __str__(self) -> str:
-        """
-        Return the exception message as a string.
-
-        Returns
-        -------
-        str
-            The error message provided during initialization.
-        """
-        return str(self.args[0])
+    """
+    Exception raised for errors encountered in the Orionis test configuration.
+
+    This exception signals issues related to the configuration process or invalid
+    configuration values during testing within the Orionis framework.
+
+    Returns
+    -------
+    None
+        This exception does not return a value.
+    """
+    pass  # This class serves as a custom exception for test configuration errors.

orionis/test/exceptions/persistence.py

@@ -1,23 +1,15 @@
 class OrionisTestPersistenceError(Exception):
+    """
+    Exception raised for errors encountered during persistence operations in Orionis tests.
 
-    def __init__(self, msg: str):
-        """
-        Initialize the OrionisTestPersistenceError with an error message.
+    This exception is intended to signal issues related to saving, loading, or managing
+    persistent data within the Orionis testing framework.
 
-        Parameters
-        ----------
-        msg : str
-            The error message describing the cause of the exception.
-        """
-        super().__init__(msg)
+    Returns
+    -------
+    None
+        This exception does not return a value.
+    """
 
-    def __str__(self) -> str:
-        """
-        Return the string representation of the exception message.
-
-        Returns
-        -------
-        str
-            The error message associated with the exception.
-        """
-        return str(self.args[0])
+    # No additional implementation required; inherits from Exception.
+    pass

orionis/test/exceptions/runtime.py

@@ -1,23 +1,19 @@
 class OrionisTestRuntimeError(Exception):
+    """
+    Exception raised for errors encountered during the runtime of Orionis tests.
 
-    def __init__(self, msg: str):
-        """
-        Initialize the OrionisTestRuntimeError with a specific error message.
+    This exception signals unexpected issues that arise while executing test cases
+    within the Orionis framework.
 
-        Parameters
-        ----------
-        msg : str
-            The error message describing the cause of the exception.
-        """
-        super().__init__(msg)
+    Attributes
+    ----------
+    None
 
-    def __str__(self) -> str:
-        """
-        Return the string representation of the exception.
+    Returns
+    -------
+    None
+        This class does not return a value; it is used for exception handling.
+    """
 
-        Returns
-        -------
-        str
-            The error message provided during initialization.
-        """
-        return str(self.args[0])
+    # No additional implementation; inherits from Exception.
+    pass

orionis/test/exceptions/value.py

@@ -1,23 +1,15 @@
 class OrionisTestValueError(Exception):
+    """
+    Exception raised for invalid values encountered in Orionis tests.
 
-    def __init__(self, msg: str):
-        """
-        Initialize the OrionisTestValueError exception.
+    This exception indicates that a value used during testing does not satisfy
+    the required criteria or constraints.
 
-        Parameters
-        ----------
-        msg : str
-            The error message describing the cause of the exception.
-        """
-        super().__init__(msg)
+    Returns
+    -------
+    None
+        This exception does not return a value.
+    """
 
-    def __str__(self) -> str:
-        """
-        Return the string representation of the exception.
-
-        Returns
-        -------
-        str
-            The error message associated with this exception.
-        """
-        return str(self.args[0])
+    # Inherits from the base Exception class to define a custom error type for test value issues.
+    pass

orionis/test/records/logs.py

@@ -329,11 +329,11 @@ class TestLogs(ITestLogs):
             )
 
         # Validate 'first' parameter if provided
-        if first is not None and not isinstance(first, int) or first <= 0:
+        if first is not None and (not isinstance(first, int) or first <= 0):
             raise OrionisTestValueError("'first' must be a positive integer greater than zero.")
 
         # Validate 'last' parameter if provided
-        if last is not None and not isinstance(last, int) or last <= 0:
+        if last is not None and (not isinstance(last, int) or last <= 0):
             raise OrionisTestValueError("'last' must be a positive integer greater than zero.")
 
         # Determine the order and quantity of records to retrieve

orionis/test/validators/__init__.py

@@ -7,6 +7,8 @@ from .name_pattern import ValidNamePattern
 from .pattern import ValidPattern
 from .persistent_driver import ValidPersistentDriver
 from .persistent import ValidPersistent
+from .print_result import ValidPrintResult
+from .tags import ValidTags
 from .throw_exception import ValidThrowException
 from .verbosity import ValidVerbosity
 from .web_report import ValidWebReport
@@ -22,6 +24,8 @@ __all__ = [
     'ValidPattern',
     'ValidPersistentDriver',
     'ValidPersistent',
+    'ValidPrintResult',
+    'ValidTags',
     'ValidThrowException',
     'ValidVerbosity',
     'ValidWebReport',

orionis/test/validators/base_path.py

@@ -24,15 +24,16 @@ class __ValidBasePath:
         """
 
         if isinstance(base_path, str):
-            base_path = base_path.strip()
-            if not base_path:
+            stripped_path = base_path.strip()
+            if not stripped_path:
                 raise OrionisTestValueError(
                     "Invalid base_path: Expected a non-empty string or Path."
                 )
-            return Path(base_path)
+            return Path(stripped_path)
 
         elif isinstance(base_path, Path):
-            if not str(base_path).strip():
+            path_str = str(base_path).strip()
+            if not path_str or path_str == ".":
                 raise OrionisTestValueError(
                     "Invalid base_path: Path cannot be empty."
                 )

orionis/test/validators/module_name.py

@@ -21,7 +21,7 @@ class __ValidModuleName:
         OrionisTestValueError
             If `module_name` is not a non-empty string.
         """
-        if not module_name or not isinstance(module_name, str):
+        if not isinstance(module_name, str) or not module_name.strip():
             raise OrionisTestValueError(
                 f"Invalid module_name: Expected a non-empty string, got '{module_name}' ({type(module_name).__name__})."
             )

orionis/test/validators/print_result.py

@@ -0,0 +1,32 @@
+from orionis.test.exceptions import OrionisTestValueError
+
+class __ValidPrintResult:
+
+    def __call__(self, print_result) -> bool:
+        """
+        Validates that the input is a boolean value.
+
+        Parameters
+        ----------
+        print_result : Any
+            The value to be validated as a boolean.
+
+        Returns
+        -------
+        bool
+            The validated boolean value.
+
+        Raises
+        ------
+        OrionisTestValueError
+            If `print_result` is not of type `bool`.
+        """
+        if not isinstance(print_result, bool):
+            raise OrionisTestValueError(
+                f"Invalid print_result: Expected a boolean, got '{print_result}' ({type(print_result).__name__})."
+            )
+
+        return print_result
+
+# Exported singleton instance
+ValidPrintResult = __ValidPrintResult()

orionis/test/validators/tags.py

@@ -0,0 +1,56 @@
+from orionis.test.exceptions import OrionisTestValueError
+
+class __ValidTags:
+
+    def __call__(self, tags) -> list | None:
+        """
+        Validates that the input is either None or a list of non-empty string tags.
+
+        Parameters
+        ----------
+        tags : list or None
+            The list of tags to validate. Must be None or a list of non-empty strings.
+
+        Returns
+        -------
+        list or None
+            The validated list of normalized tag strings, or None if input is None.
+
+        Raises
+        ------
+        OrionisTestValueError
+            If `tags` is not None or a list, if the list is empty, or if any tag
+            is not a non-empty string.
+        """
+        if tags is None:
+            return None
+
+        if not isinstance(tags, list):
+            raise OrionisTestValueError(
+                f"Invalid tags: Expected a list or None, got '{tags}' ({type(tags).__name__})."
+            )
+
+        if not tags:
+            raise OrionisTestValueError(
+                "Invalid tags: Expected a non-empty list or None."
+            )
+
+        normalized_tags = []
+        for tag in tags:
+            if not isinstance(tag, str):
+                raise OrionisTestValueError(
+                    f"Invalid tag: Expected a string, got '{tag}' ({type(tag).__name__})."
+                )
+            
+            normalized_tag = tag.strip()
+            if not normalized_tag:
+                raise OrionisTestValueError(
+                    "Invalid tag: Expected a non-empty string."
+                )
+            
+            normalized_tags.append(normalized_tag)
+
+        return normalized_tags
+
+# Exported singleton instance
+ValidTags = __ValidTags()

orionis/test/validators/workers.py

@@ -1,4 +1,4 @@
-from orionis.services.system.workers import Workers
+from orionis.support.facades.workers import Workers
 from orionis.test.exceptions import OrionisTestValueError
 
 class __ValidWorkers:
@@ -25,7 +25,7 @@ class __ValidWorkers:
         OrionisTestValueError
             If `max_workers` is not a positive integer within the allowed range.
         """
-        max_allowed = Workers().calculate()
+        max_allowed = Workers.calculate()
         if not isinstance(max_workers, int) or max_workers < 1 or max_workers > max_allowed:
             raise OrionisTestValueError(
                 f"Invalid max_workers: Expected a positive integer between 1 and {max_allowed}, got '{max_workers}' ({type(max_workers).__name__})."

{orionis-0.709.0.dist-info → orionis-0.710.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.709.0
+Version: 0.710.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro

{orionis-0.709.0.dist-info → orionis-0.710.0.dist-info}/RECORD

@@ -207,7 +207,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=IrPQJwvQVLRm5Qnz0Cxon4
 orionis/foundation/providers/testing_provider.py,sha256=eI1p2lUlxl25b5Z487O4nmqLE31CTDb4c3Q21xFadkE,1615
 orionis/foundation/providers/workers_provider.py,sha256=GdHENYV_yGyqmHJHn0DCyWmWId5xWjD48e6Zq2PGCWY,1674
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=684u8AFoYkTrBh_Jwn9VQsz41kldOL9Fcq-nGEW2lUc,4570
+orionis/metadata/framework.py,sha256=cYeDyi8GcnquSc5ovbhabjEmaFlYplKP8xm8HN1DI-k,4570
 orionis/metadata/package.py,sha256=s1JeGJPwdVh4jO3IOfmpwMuJ_oX6Vf9NL7jgPEQNf5Y,16050
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -367,35 +367,37 @@ orionis/test/entities/result.py,sha256=eZ6UIqGmFW8FZ9x8PB_MZbLAc-SAuUyi4FUcMYIZz
 orionis/test/enums/__init__.py,sha256=M3imAgMvKFTKg55FbtVoY3zxj7QRY9AfaUWxiSZVvn4,66
 orionis/test/enums/status.py,sha256=5SXvDQEFOT4Jkzdndw6hV8Tc2k4gm9XGjyZp0Qa55Zk,757
 orionis/test/exceptions/__init__.py,sha256=HcFudBMqi86hzgxEyNhh29hNMOle4KZmKosJRqX5ayc,424
-orionis/test/exceptions/config.py,sha256=tzwTyfxuriALzH39VRtNcpO9iA64OuZTXPCJEbEG1C4,579
+orionis/test/exceptions/config.py,sha256=POzRCoKXqp8EzLtqR_e7E_VlAiN_GJqu7M92g9cH66E,469
 orionis/test/exceptions/failure.py,sha256=IlaH45y1D0kypu6uaNbi4iCzYrhZUxxO5hQ9DtGv0Gg,2020
-orionis/test/exceptions/persistence.py,sha256=8Oakaey35DpByLoGnfbwHxFKntxgWaGl496hlyeosxU,619
-orionis/test/exceptions/runtime.py,sha256=h9gQ0pS8tJTmuXNG-GHky8tTqpdz-cNqkntOOlRXZJg,612
-orionis/test/exceptions/value.py,sha256=CoqYOkViU_RaKCMNpB82tgEsR3XhI1pw6YQ8sH8CJh4,588
+orionis/test/exceptions/persistence.py,sha256=bIuhO2IZVdKuDJKHPF2BDdRxr6uzQnvEFm6cintzbcg,476
+orionis/test/exceptions/runtime.py,sha256=BfLGfA8eeCbOlFbH_CyI33rPc-4imTYwcCgVan_KK2Y,498
+orionis/test/exceptions/value.py,sha256=BeSR0bheS40IqVdXRDrmYPnXkezhyNanG4DQneEhj68,451
 orionis/test/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/output/dumper.py,sha256=m68kaIuTs3G7H1B2ZthN_H52XeRHeO95cvNNDwzby0w,6030
 orionis/test/output/printer.py,sha256=5BF8elV_CUhz2Gzc5zFZ8_Kq-cMTmYFLhDsEUX7o3kg,29643
 orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/records/logs.py,sha256=_kq3VLUCCuQzUYFUOoMXD5riPYQ3GdLHQR5TxwmylxE,21996
-orionis/test/validators/__init__.py,sha256=mhzMkpLPTyI8GMXYevIibRf1PnRDvSJLLDwjGhnvxes,875
-orionis/test/validators/base_path.py,sha256=wAn5_HG0vQ5GH7wDKriO33Ijl1L1F3882BH67oraJnQ,1477
+orionis/test/records/logs.py,sha256=Vein9TE4-C64m9tcYhT9kMvUESI4OGUd-05QDwOMbpo,22000
+orionis/test/validators/__init__.py,sha256=RpuZFsrmxzLjRERyJ2fcZIQ27xuq2DedDlao2zmFE_U,991
+orionis/test/validators/base_path.py,sha256=5sEnBqC--q7AvXkMRQOLT4sLCV1Gus_eSfXdHlClvac,1541
 orionis/test/validators/execution_mode.py,sha256=YnrQlnIaoPtM0xjW7jJ2170m1aHwAPPIZBjSVe9g2QM,1693
 orionis/test/validators/fail_fast.py,sha256=Z54GSQ2KxYeLy2gZwo51sYYMXH-6mj1w09okhI1MWOQ,850
 orionis/test/validators/folder_path.py,sha256=Pfy65fANR6eY-8665exTOhzzzEUvblYSOFGEuJMiGxA,953
-orionis/test/validators/module_name.py,sha256=A5Ng8LW2pPfgPKm0Vs_Y0oiP8Pe8Nfz8kV1zv_y7fbo,928
+orionis/test/validators/module_name.py,sha256=Eo-4dE0Ms_yp4As1Rvu1UjVsUQvbx7M76-qeRSysnZE,936
 orionis/test/validators/name_pattern.py,sha256=I0DRZ7Nhtlzw33urmlr3EoGH6eJ8TdeFnpeRmqliThg,1139
 orionis/test/validators/pattern.py,sha256=NYc_qsjd0Y1J0tmioW7nmlBVowbzkhGA17e4AdxfcA8,881
 orionis/test/validators/persistent.py,sha256=8y6rkseAG4yobbw9AFvVjKlMl2HL_w5i6rH9LNNYZAU,851
 orionis/test/validators/persistent_driver.py,sha256=9t832vIZyBAdIyKn-nZ-_nKs0Oxf2uvmR7K9ncWdRpw,1545
+orionis/test/validators/print_result.py,sha256=qLb0oJVtQUgFcOUQI8WKqGVCQDo_1oLLlXpVuzv873o,875
+orionis/test/validators/tags.py,sha256=LrF2eCiEhC4eukW_ABzx-nTiaUn-lUFvmVDT98fkZVM,1762
 orionis/test/validators/throw_exception.py,sha256=PLtM94BArQf11VJhxfBHJSHARZSia-Q8ePixctU2JwQ,893
 orionis/test/validators/verbosity.py,sha256=rADzM82cPcJ2_6crszpobJuwb5WihWNQf6i4M_yrCpw,1785
 orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNusHqc02R8,853
-orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
+orionis/test/validators/workers.py,sha256=HcZ3cnrk6u7cvM1xZpn_lsglHAq69_jx9RcTSvLrdb0,1204
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=arysoswhkV2vUd2aVMZRPpmH317jaWbgjDpQ_AWQ5AE,5663
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.709.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.709.0.dist-info/METADATA,sha256=Cmb0ANzrtQ2npYC4UREZKZ3g1j-IXrGxgvUSKGhIB00,4772
-orionis-0.709.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.709.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.709.0.dist-info/RECORD,,
+orionis-0.710.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.710.0.dist-info/METADATA,sha256=COcX7OIV0MkmYS11DG4P6UnoY18Amb2BaWgNiVoHyyk,4772
+orionis-0.710.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.710.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.710.0.dist-info/RECORD,,