orionis 0.591.0__py3-none-any.whl → 0.593.0__py3-none-any.whl

orionis/test/view/render.py

@@ -10,32 +10,52 @@ class TestingResultRender(ITestingResultRender):
     def __init__(
         self,
         result,
-        storage_path: str,
+        storage_path: str | Path,
+        filename: str = 'orionis-test-results.html',
         persist: bool = False
     ) -> None:
         """
-        Initializes the TestingResultRender instance.
+        Initializes a TestingResultRender instance for rendering test results into an HTML report.
 
         Parameters
         ----------
-        result : Any
-            The test result data to be rendered in the report.
-        storage_path : str
+        result : dict or list
+            The test result data to be rendered in the report. Must be a dictionary or a list.
+        storage_path : str or Path
             Directory path where the HTML report will be saved. The directory is created if it does not exist.
+        filename : str, optional
+            The name of the HTML report file (default is 'orionis-test-results.html').
         persist : bool, optional
             If True, enables persistent storage for test reports (default is False).
 
         Returns
         -------
         None
+            This method does not return any value.
         """
-        self.__filename = 'orionis-test-results.html'
+
+        # Validate filename input
+        if not isinstance(filename, str) or not filename.strip():
+            raise ValueError('Filename must be a non-empty string.')
+        self.__filename = filename
+
+        # Validate result input
+        if not isinstance(result, (dict, list)):
+            raise ValueError('Result must be a dictionary or a list.')
         self.__result = result
-        self.__persist = persist
+
+        # Validate storage_path input
+        if not isinstance(storage_path, (str, Path)):
+            raise ValueError('Storage path must be a string or a Path object.')
         self.__storage_path = storage_path
 
+        # Validate persist input
+        if not isinstance(persist, bool):
+            raise ValueError('Persist must be a boolean value.')
+        self.__persist = persist
+
         # Ensure storage_path is a Path object and create the directory if it doesn't exist
-        storage_dir = Path(storage_path)
+        storage_dir = Path(storage_path) if isinstance(storage_path, str) else storage_path
         storage_dir.mkdir(parents=True, exist_ok=True)
 
         # Set the absolute path for the report file
@@ -45,24 +65,35 @@ class TestingResultRender(ITestingResultRender):
         self
     ) -> str:
         """
-        Renders the test results into an HTML report file.
+        Generates an HTML report from the test results and writes it to a file.
 
-        If persistence is enabled, retrieves the last 10 reports from the database and includes them in the report.
-        Otherwise, only the current in-memory test result is used. The method reads a template file, replaces
-        placeholders with the test results and persistence mode, writes the rendered content to a report file,
+        Depending on the persistence mode, the report will include either the current in-memory test result
+        or the last 10 persisted test results from the database. The method reads an HTML template file,
+        replaces placeholders with the test results and persistence mode, writes the rendered content to a report file,
         and attempts to open the report in the default web browser on supported platforms.
 
+        Parameters
+        ----------
+        self : TestingResultRender
+            Instance of the TestingResultRender class.
+
         Returns
         -------
         str
             The absolute path to the generated HTML report file.
+
+        Notes
+        -----
+        - If persistence is enabled, the last 10 test reports are retrieved from the database and included in the report.
+        - If persistence is disabled, only the current test result is included.
+        - The report is automatically opened in the default web browser on Windows and macOS platforms.
         """
+
         # Determine the source of test results based on persistence mode
         if self.__persist:
 
             # If persistence is enabled, fetch the last 10 reports from SQLite
-            logs = TestLogs(self.__storage_path)
-            reports = logs.get(last=10)
+            reports = TestLogs(self.__storage_path).get(last=10)
 
             # Parse each report's JSON data into a list
             results_list = [json.loads(report[1]) for report in reports]
@@ -97,13 +128,10 @@ class TestingResultRender(ITestingResultRender):
 
         # Open the generated report in the default web browser if running on Windows or macOS.
         try:
-
             # Check the operating system and open the report in a web browser if applicable
             if ((os.name == 'nt') or (os.name == 'posix' and sys.platform == 'darwin')):
                 import webbrowser
                 webbrowser.open(self.__report_path.as_uri())
-
         finally:
-
             # Return the absolute path to the generated report
             return str(self.__report_path)

{orionis-0.591.0.dist-info → orionis-0.593.0.dist-info}/METADATA

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

{orionis-0.591.0.dist-info → orionis-0.593.0.dist-info}/RECORD

@@ -191,7 +191,7 @@ orionis/foundation/config/session/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-
 orionis/foundation/config/session/helpers/secret_key.py,sha256=yafjzQ9KVQdXzCQCMthpgizlNCo5F5UTLtAnInipUMk,447
 orionis/foundation/config/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/testing/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/config/testing/entities/testing.py,sha256=bXT1VMXvZQc2rs2x0s3PNVuHSaoDYLBUq7LfK1BcZYs,12204
+orionis/foundation/config/testing/entities/testing.py,sha256=OkgaZ4lCeU3bTUUVHl73PEbdlXjMsI16iuD9Pwkc5vg,11587
 orionis/foundation/config/testing/enums/__init__.py,sha256=aFh5kBxlh5kqHK-9W7qgdykF5-qou5SVRzorRBazqYw,196
 orionis/foundation/config/testing/enums/drivers.py,sha256=mwv47FcKDXEOxydQXAGtkdIY9S6qCAW1cD22oCFy3xw,355
 orionis/foundation/config/testing/enums/mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
@@ -217,7 +217,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=irwkjMiq-HpsbJxAOnhjji
 orionis/foundation/providers/testing_provider.py,sha256=2akFnabtH_cV_7z_2cCL7u8cPCGvCJAmlhMcnlCrc4c,3742
 orionis/foundation/providers/workers_provider.py,sha256=P_YtJuPNrdJAQJkAqI11KI0c6GSB9NqIuuCKpRytE0g,3937
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=ljgJkH88KVq9vm8hJRj5c9Z2hhdDtOlaXgdH3XDgk6c,4109
+orionis/metadata/framework.py,sha256=s6s0dYCwOfjVO09Leal7YLnkxZ0CYqHnEB3e5xJ3E-E,4109
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -370,9 +370,9 @@ orionis/test/contracts/logs.py,sha256=kRH3TGQcTNI0kRxFyEs13Y7NOPP9x9WGitPexnoLzQ
 orionis/test/contracts/printer.py,sha256=iBz8wHAGaS21VBsHlZQVcx0xu9Bqusb-CLAjj-R1Sjg,3412
 orionis/test/contracts/render.py,sha256=wpDQzUtT0r8KFZ7zPcxWHXQ1EVNKxzA_rZ6ZKUcZO1c,744
 orionis/test/contracts/test_result.py,sha256=SNXJ2UerkweYn7uCT0i0HmMGP0XBrL_9KJs-0ZvIYU4,4002
-orionis/test/contracts/unit_test.py,sha256=hOuMgm1JVk3ERLrpMnDhShMWCJCJBdgOsY-U6kPaO0k,2335
+orionis/test/contracts/unit_test.py,sha256=6DG8rqhBSvTf3lwtmzyO_xci_V-9WxBP6ZibATeQ3Gw,589
 orionis/test/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/core/unit_test.py,sha256=Yqn_Q-aM0-x2zzsnB-h3XBGg20iCrn1pkT1UFI-L0RE,65105
+orionis/test/core/unit_test.py,sha256=U5HT1a6s-Wosz5BC7Pi5cPreRyLzFJWbEoKWw7jdvvY,72957
 orionis/test/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/entities/result.py,sha256=eZ6UIqGmFW8FZ9x8PB_MZbLAc-SAuUyi4FUcMYIZzGo,4777
 orionis/test/enums/__init__.py,sha256=M3imAgMvKFTKg55FbtVoY3zxj7QRY9AfaUWxiSZVvn4,66
@@ -385,9 +385,9 @@ orionis/test/exceptions/runtime.py,sha256=h9gQ0pS8tJTmuXNG-GHky8tTqpdz-cNqkntOOl
 orionis/test/exceptions/value.py,sha256=CoqYOkViU_RaKCMNpB82tgEsR3XhI1pw6YQ8sH8CJh4,588
 orionis/test/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/output/dumper.py,sha256=qJDyVvl3MO0Uinr6z9TYYdDTqHNwwM0PcoDNNkTpAnA,5908
-orionis/test/output/printer.py,sha256=Ho8jyhnJsvnJ5zdHbXyvY29kDa1zp4FsCswjt9XSeJ4,23903
+orionis/test/output/printer.py,sha256=M33HhDQBRxB-C-myOqPFSkTvfLyDCc424uVqJg40NYc,29575
 orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/records/logs.py,sha256=7XIdzDmQpb2HLUoAUWVj8UKiQDOnCkLD7ttro-Lv5UY,14223
+orionis/test/records/logs.py,sha256=N5MczDDZ8HqyTCLgb4ikzAQzyzl2JhKHNVd-KGzAG20,22081
 orionis/test/validators/__init__.py,sha256=2e862DM9aRnPajv2nxMujewe9dZ-1PyCamJKDcF-hGc,944
 orionis/test/validators/base_path.py,sha256=wAn5_HG0vQ5GH7wDKriO33Ijl1L1F3882BH67oraJnQ,1477
 orionis/test/validators/execution_mode.py,sha256=YnrQlnIaoPtM0xjW7jJ2170m1aHwAPPIZBjSVe9g2QM,1693
@@ -404,10 +404,10 @@ orionis/test/validators/verbosity.py,sha256=rADzM82cPcJ2_6crszpobJuwb5WihWNQf6i4
 orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNusHqc02R8,853
 orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/view/render.py,sha256=1FJHFBRHbwI5FV90F9-cMUmT10xrA5tc2bY1ysTzD-8,4094
+orionis/test/view/render.py,sha256=R55ykeRs0wDKcdTf4O1YZ8GDHTFmJ0IK6VQkbJkYUvo,5571
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.591.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.591.0.dist-info/METADATA,sha256=AoYGMXmT2rzsE_bYDenQjpDFW12CiZHzvB3lNZXqeeM,4801
-orionis-0.591.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.591.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.591.0.dist-info/RECORD,,
+orionis-0.593.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.593.0.dist-info/METADATA,sha256=O3C-w6zuLT6bsvYt-y-TlgqIw03W_A9EQ17OadTCTdc,4801
+orionis-0.593.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.593.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.593.0.dist-info/RECORD,,