dragon-ml-toolbox 19.8.2__py3-none-any.whl → 19.9.0__py3-none-any.whl

{dragon_ml_toolbox-19.8.2.dist-info → dragon_ml_toolbox-19.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dragon-ml-toolbox
-Version: 19.8.2
+Version: 19.9.0
 Summary: Complete pipelines and helper tools for data science and machine learning projects.
 Author-email: Karl Luigi Loza Vidaurre <luigiloza@gmail.com>
 License-Expression: MIT

{dragon_ml_toolbox-19.8.2.dist-info → dragon_ml_toolbox-19.9.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-dragon_ml_toolbox-19.8.2.dist-info/licenses/LICENSE,sha256=L35WDmmLZNTlJvxF6Vy7Uy4SYNi6rCfWUqlTHpoRMoU,1081
-dragon_ml_toolbox-19.8.2.dist-info/licenses/LICENSE-THIRD-PARTY.md,sha256=XBLtvGjvBf-q93a5iylHj94Lm78UzInC-3Cii01jc6I,3127
+dragon_ml_toolbox-19.9.0.dist-info/licenses/LICENSE,sha256=L35WDmmLZNTlJvxF6Vy7Uy4SYNi6rCfWUqlTHpoRMoU,1081
+dragon_ml_toolbox-19.9.0.dist-info/licenses/LICENSE-THIRD-PARTY.md,sha256=XBLtvGjvBf-q93a5iylHj94Lm78UzInC-3Cii01jc6I,3127
 ml_tools/ETL_cleaning.py,sha256=cKXyRFaaFs_beAGDnQM54xnML671kq-yJEGjHafW-20,351
 ml_tools/ETL_engineering.py,sha256=cwh1FhtNdUHllUDvho-x3SIVj4KwG_rFQR6VYzWUg0U,898
 ml_tools/GUI_tools.py,sha256=O89rG8WQv6GY1DiphQjIsPzXFCQID6te7q_Sgt1iTkQ,294
@@ -99,13 +99,13 @@ ml_tools/_core/_math_utilities.py,sha256=IlXAiZgTcLtus03jJOBOyF9ZCQDf8qLGjrCHu9M
 ml_tools/_core/_models_advanced_base.py,sha256=ceW0V_CcfOnSFqHlxUhVU8-5mtQq4tFyo8TX-xVexrY,4982
 ml_tools/_core/_models_advanced_helpers.py,sha256=yrAVgYdBsNYD6Vy-pYL5__wI9Z7inOvNUngMgyuypjo,38973
 ml_tools/_core/_optimization_tools.py,sha256=2LkntNRc19uGur9u0yI-KnNX56tc63sxaRNj6W440Og,20077
-ml_tools/_core/_path_manager.py,sha256=ty_tTUfOMiqKfB3fL_xerWhiJRZFgxvtzM-RHR-9U5E,18504
+ml_tools/_core/_path_manager.py,sha256=z4zqYqppKhgOj3ArfkKo4tieO8oNaHWUoshCQRNbd1w,20284
 ml_tools/_core/_plot_fonts.py,sha256=CjYXW2gZ9AUaGkyX8_WOXXNYs6d1PTK-nEJBrv_Zb2o,2287
 ml_tools/_core/_schema.py,sha256=TM5WVVMoKOvr_Bc2z34sU_gzKlM465PRKTgdZaEOkGY,14076
 ml_tools/_core/_script_info.py,sha256=21r83LV3RubsNZ_RTEUON6RbDf7Mh4_udweNcvdF_Fk,212
 ml_tools/_core/_serde.py,sha256=tsI4EO2Y7jrBMmbQ1pinDsPOrOg-SaPuB-Dt40q0taE,5609
 ml_tools/_core/_utilities.py,sha256=iA8fLWdhsIx4ut2Dp8M_OyU0Y3PPLgGdIklyl17x6xk,22560
-dragon_ml_toolbox-19.8.2.dist-info/METADATA,sha256=PBht866esAUBXiPNsjgNFLcwiTlWk0yNFa2RL1QoV8Y,8774
-dragon_ml_toolbox-19.8.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-dragon_ml_toolbox-19.8.2.dist-info/top_level.txt,sha256=wm-oxax3ciyez6VoO4zsFd-gSok2VipYXnbg3TH9PtU,9
-dragon_ml_toolbox-19.8.2.dist-info/RECORD,,
+dragon_ml_toolbox-19.9.0.dist-info/METADATA,sha256=_EtgLq25qcjnIMmFvPVOfa-xWTp176hHC_VbxFLdWno,8774
+dragon_ml_toolbox-19.9.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+dragon_ml_toolbox-19.9.0.dist-info/top_level.txt,sha256=wm-oxax3ciyez6VoO4zsFd-gSok2VipYXnbg3TH9PtU,9
+dragon_ml_toolbox-19.9.0.dist-info/RECORD,,

ml_tools/_core/_path_manager.py

@@ -35,7 +35,8 @@ class DragonPathManager:
     def __init__(
         self,
         anchor_file: str,
-        base_directories: Optional[List[str]] = None
+        base_directories: Optional[List[str]] = None,
+        strict_to_root: bool = True
     ):
         """
         Sets up the core paths for a project by anchoring to a specific file.
@@ -53,14 +54,16 @@ class DragonPathManager:
                                                     where each string is the name
                                                     of a subdirectory to register
                                                     relative to the package root.
+            strict_to_root (bool): If True, checks that all registered paths are defined within the package ROOT.
         """
         resolved_anchor_path = Path(anchor_file).resolve()
         self._package_name = resolved_anchor_path.parent.name
         self._is_bundled, bundle_root = self._get_bundle_root()
         self._paths: Dict[str, Path] = {}
+        self._strict_to_root = strict_to_root
 
         if self._is_bundled:
-            # In a PyInstaller bundle, the package is inside the temp _MEIPASS dir
+            # In a PyInstaller/Nuitka bundle, the package is inside the temp _MEIPASS dir
             package_root = Path(bundle_root) / self._package_name # type: ignore
         else:
             # In dev mode, the package root is the directory containing the anchor file.
@@ -182,17 +185,44 @@ class DragonPathManager:
         """
         Checks the status of all registered paths on the filesystem and prints a formatted report.
         """
-        report = {}
-        for key, path in self.items():
+        # 1. Gather Data and determine max widths
+        rows = []
+        max_key_len = len("Key")  # Start with header width
+        
+        # Sort by key for readability
+        for key, path in sorted(self.items()):
             if path.is_dir():
-                report[key] = "📁 Directory"
+                stat_msg = "📁 Directory"
             elif path.is_file():
-                report[key] = "📄 File"
+                stat_msg = "📄 File"
+            elif not path.exists():
+                stat_msg = "❌ Not Found"
             else:
-                report[key] = "❌ Not Found"
+                stat_msg = "❓ Unknown"
+            
+            rows.append((key, stat_msg, str(path)))
+            max_key_len = max(max_key_len, len(key))
 
-        print("\n--- Path Status Report ---")
-        pprint(report)
+        # 2. Print Header
+        mode_icon = "📦" if self._is_bundled else "🛠️"
+        mode_text = "Bundled Mode" if self._is_bundled else "Development Mode"
+        
+        print(f"\n{'-'*80}")
+        print(f" 🐉 DragonPathManager Status Report")
+        print(f"    Context: {mode_icon} {mode_text}")
+        print(f"    Root:    {self.ROOT}")
+        print(f"{'-'*80}")
+
+        # 3. Print Table Header
+        # {variable:<width} aligns text to the left within the padding
+        print(f" {'Key':<{max_key_len}} | {'Status':<12} | Path")
+        print(f" {'-'*max_key_len} | {'-'*12} | {'-'*40}")
+
+        # 4. Print Rows
+        for key, stat, p_str in rows:
+            print(f" {key:<{max_key_len}} | {stat:<12} | {p_str}")
+        
+        print(f"{'-'*80}\n")
 
     def __repr__(self) -> str:
         """Provides a string representation of the stored paths."""
@@ -276,10 +306,22 @@ class DragonPathManager:
         
         if not isinstance(value, (str, Path)):
             _LOGGER.error(f"Cannot assign type '{type(value).__name__}' to a path. Must be str or Path.")
-            raise TypeError
-
-        # If all checks pass, treat it as a public path and store it in the _paths dictionary.
-        self._paths[sanitized_name] = Path(value)
+            raise TypeError()
+        
+        # Resolve the new path
+        new_path = Path(value).expanduser().absolute()
+
+        # --- STRICT CHECK ---
+        # Only check if strict mode is on
+        if self.__dict__.get("_strict_to_root", False) and sanitized_name != "ROOT":
+            root_path = self._paths.get("ROOT")
+            # Ensure ROOT exists and the new path is inside it
+            if root_path and not new_path.is_relative_to(root_path):
+                _LOGGER.error(f"Strict Mode Violation: '{name}' ({new_path}) is outside ROOT ({root_path})")
+                raise ValueError()
+
+        # Store absolute Path.
+        self._paths[sanitized_name] = new_path
 
 
 def make_fullpath(