scitex 2.4.3__py3-none-any.whl → 2.7.0__py3-none-any.whl

scitex/__init__.py

@@ -15,24 +15,27 @@ Modules are imported on-demand to avoid circular dependencies.
 """
 
 import warnings
+
 # Always show our own deprecation warnings first
-warnings.filterwarnings(
-    "always", category=DeprecationWarning, module="scitex.*"
-)
+warnings.filterwarnings("always", category=DeprecationWarning, module="scitex.*")
 # Then ignore others
 warnings.filterwarnings("ignore", category=DeprecationWarning)
 
 # Version
 from .__version__ import __version__
 
+
 # Sentinel object for decorator-injected parameters
 class _InjectedSentinel:
     """Sentinel value indicating a parameter will be injected by a decorator"""
+
     def __repr__(self):
         return "<INJECTED>"
 
+
 INJECTED = _InjectedSentinel()
 
+
 # Lazy loading for all modules
 class _LazyModule:
     def __init__(self, name):
@@ -43,9 +46,7 @@ class _LazyModule:
         if self._module is None:
             import importlib
 
-            self._module = importlib.import_module(
-                f".{self._name}", package="scitex"
-            )
+            self._module = importlib.import_module(f".{self._name}", package="scitex")
         return getattr(self._module, attr)
 
 
@@ -69,7 +70,7 @@ class _CallableModuleWrapper:
         scitex.session.start(...)  # Access other functions
     """
 
-    def __init__(self, module_name, main_decorator_name='session'):
+    def __init__(self, module_name, main_decorator_name="session"):
         self._module_name = module_name
         self._main_decorator_name = main_decorator_name
         self._module = None
@@ -159,10 +160,18 @@ session._setup_persistence("scitex", "session")
 capture = _LazyModule("capture")
 template = _LazyModule("template")
 cloud = _LazyModule("cloud")
+config = _LazyModule("config")
+
+# Centralized path configuration - eager loaded for convenience
+# Usage: scitex.PATHS.logs, scitex.PATHS.cache, etc.
+from .config import ScitexPaths as _ScitexPaths
+
+PATHS = _ScitexPaths()
 
 # Auto-load cloud hooks if in cloud environment
 import os as _os
-if _os.environ.get('SCITEX_CLOUD_CODE_WORKSPACE') == 'true':
+
+if _os.environ.get("SCITEX_CLOUD_CODE_WORKSPACE") == "true":
     try:
         from .cloud import _matplotlib_hook
     except Exception:
@@ -211,6 +220,8 @@ __all__ = [
     "dev",
     "gists",
     "cloud",
+    "config",
+    "PATHS",
     "INJECTED",
 ]
 

scitex/__main__.py

@@ -13,6 +13,7 @@ def main():
     """Main entry point for scitex CLI"""
     try:
         from scitex.cli.main import cli
+
         cli()
     except ImportError:
         # CLI not available (click not installed)
@@ -21,5 +22,5 @@ def main():
         sys.exit(1)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()

scitex/__version__.py

@@ -9,6 +9,6 @@ __FILE__ = "./src/scitex/__version__.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
-__version__ = "2.4.3"
+__version__ = "2.7.0"
 
 # EOF

scitex/_optional_deps.py

@@ -18,30 +18,25 @@ DEPENDENCY_GROUPS: Dict[str, str] = {
     "accelerate": "dl",
     "bitsandbytes": "dl",
     "fairscale": "dl",
-    
     # AI APIs
     "openai": "ai-apis",
     "anthropic": "ai-apis",
     "google.generativeai": "ai-apis",
     "groq": "ai-apis",
-    
     # Scholar
     "selenium": "scholar",
     "playwright": "scholar",
     "crawl4ai": "scholar",
     "bs4": "scholar",
-    
     # Neuroscience
     "mne": "neuro",
     "obspy": "neuro",
     "pyedflib": "neuro",
     "tensorpac": "neuro",
-    
     # Web
     "fastapi": "web",
     "flask": "web",
     "streamlit": "web",
-    
     # Jupyter
     "jupyterlab": "jupyter",
     "IPython": "jupyter",
@@ -50,21 +45,19 @@ DEPENDENCY_GROUPS: Dict[str, str] = {
 
 
 def optional_import(
-    module_name: str,
-    package_name: Optional[str] = None,
-    raise_error: bool = True
+    module_name: str, package_name: Optional[str] = None, raise_error: bool = True
 ) -> Optional[Any]:
     """
     Import an optional dependency with helpful error message.
-    
+
     Args:
         module_name: Name of the module to import (e.g., 'torch')
         package_name: Name of the package to install if different from module
         raise_error: If True, raise ImportError. If False, return None.
-    
+
     Returns:
         The imported module, or None if raise_error=False and import fails
-        
+
     Examples:
         >>> torch = optional_import('torch')
         >>> torch = optional_import('torch', raise_error=False)  # Returns None if not installed
@@ -74,10 +67,10 @@ def optional_import(
     except ImportError:
         if not raise_error:
             return None
-            
+
         pkg_name = package_name or module_name
         extra_group = DEPENDENCY_GROUPS.get(module_name, "all")
-        
+
         error_msg = (
             f"\n{'=' * 70}\n"
             f"Optional dependency '{pkg_name}' is not installed.\n\n"
@@ -93,13 +86,13 @@ def optional_import(
 def check_optional_deps(*module_names: str) -> Dict[str, bool]:
     """
     Check which optional dependencies are available.
-    
+
     Args:
         *module_names: Names of modules to check
-        
+
     Returns:
         Dictionary mapping module names to availability (True/False)
-        
+
     Example:
         >>> available = check_optional_deps('torch', 'transformers')
         >>> if available['torch']:
@@ -118,23 +111,23 @@ def check_optional_deps(*module_names: str) -> Dict[str, bool]:
 # Convenience: Check common dependency groups
 def has_deep_learning() -> bool:
     """Check if deep learning dependencies are available."""
-    return check_optional_deps('torch')['torch']
+    return check_optional_deps("torch")["torch"]
 
 
 def has_transformers() -> bool:
     """Check if transformers is available."""
-    return check_optional_deps('transformers')['transformers']
+    return check_optional_deps("transformers")["transformers"]
 
 
 def has_scholar() -> bool:
     """Check if scholar dependencies are available."""
-    deps = check_optional_deps('selenium', 'bs4')
+    deps = check_optional_deps("selenium", "bs4")
     return all(deps.values())
 
 
 def has_jupyter() -> bool:
     """Check if Jupyter dependencies are available."""
-    return check_optional_deps('IPython')['IPython']
+    return check_optional_deps("IPython")["IPython"]
 
 
 # EOF

scitex/ai/__init__.py

@@ -4,6 +4,7 @@
 # File: /home/ywatanabe/proj/scitex_repo/src/scitex/ai/__init__.py
 # ----------------------------------------
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -22,6 +23,7 @@ from . import activation
 from . import classification
 from . import clustering
 from . import feature_extraction
+
 # from . import layer
 from . import loss
 from . import metrics
@@ -32,13 +34,16 @@ from . import sklearn
 from . import training
 from . import utils
 
+
 # Lazy import for GenAI (heavy anthropic dependency)
 def __getattr__(name):
     if name == "GenAI":
         from ._gen_ai import GenAI
+
         return GenAI
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
 
+
 __all__ = [
     # "Classifiers",  # Moved to .old directory
     "LearningCurveLogger",

scitex/ai/_gen_ai/_Anthropic.py

@@ -4,6 +4,7 @@
 # File: /home/ywatanabe/proj/scitex_repo/src/scitex/ai/_gen_ai/_Anthropic.py
 # ----------------------------------------
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -33,6 +34,8 @@ import matplotlib.pyplot as plt
 from ._BaseGenAI import BaseGenAI
 
 """Functions & Classes"""
+
+
 class Anthropic(BaseGenAI):
     def __init__(
         self,
@@ -46,7 +49,6 @@ class Anthropic(BaseGenAI):
         chat_history: Optional[List[Dict[str, str]]] = None,
         max_tokens: int = 100_000,
     ) -> None:
-
         if model == "claude-3-7-sonnet-2025-0219":
             max_tokens = 128_000
 

scitex/ai/_gen_ai/_BaseGenAI.py

@@ -107,7 +107,6 @@ class BaseGenAI(ABC):
         format_output: bool = False,
         return_stream: bool = False,
     ) -> Union[str, Generator]:
-
         # ----------------------------------------
         # Handles Prompt and Prompt File
         if (not prompt) and (not prompt_file):
@@ -324,7 +323,9 @@ def main() -> None:
 if __name__ == "__main__":
     import scitex
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(sys, plt, verbose=False)
+    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(
+        sys, plt, verbose=False
+    )
     main()
     scitex.session.close(CONFIG, verbose=False, notify=False)
 

scitex/ai/_gen_ai/_DeepSeek.py

@@ -166,7 +166,7 @@ if __name__ == "__main__":
         response = client.complete(prompt)
         print(response)
         return 0
-    
+
     exit_status = main()
 
     # -----------------------------------

scitex/ai/_gen_ai/_Google.py

@@ -53,7 +53,6 @@ class Google(BaseGenAI):
         chat_history: Optional[List[Dict[str, str]]] = None,
         max_tokens: int = 32_768,
     ) -> None:
-
         api_key = api_key or os.getenv("GOOGLE_API_KEY")
 
         if not api_key:
@@ -147,7 +146,9 @@ def main() -> None:
 
 
 if __name__ == "__main__":
-    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(sys, plt, verbose=False)
+    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(
+        sys, plt, verbose=False
+    )
     main()
     scitex.session.close(CONFIG, verbose=False, notify=False)
 

scitex/ai/_gen_ai/_Llama.py

@@ -4,6 +4,7 @@
 # File: ./scitex_repo/src/scitex/ai/_gen_ai/_Llama.py
 
 """Imports"""
+
 import os
 import sys
 from typing import List, Optional
@@ -54,7 +55,6 @@ class Llama(BaseGenAI):
         chat_history=None,
         **kwargs,
     ):
-
         # Configure environment variables
         os.environ["MASTER_ADDR"] = os.getenv("MASTER_ADDR", "localhost")
         os.environ["MASTER_PORT"] = os.getenv("MASTER_PORT", "12355")
@@ -135,7 +135,9 @@ def main():
 
 if __name__ == "__main__":
     # Main
-    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(sys, plt, verbose=False)
+    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(
+        sys, plt, verbose=False
+    )
     main()
     scitex.session.close(CONFIG, verbose=False, notify=False)
 

scitex/ai/_gen_ai/_OpenAI.py

@@ -218,7 +218,9 @@ if __name__ == "__main__":
     import matplotlib.pyplot as plt
     import scitex
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(sys, plt, verbose=False)
+    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(
+        sys, plt, verbose=False
+    )
     main()
     scitex.session.close(CONFIG, verbose=False, notify=False)
 

scitex/ai/_gen_ai/_PARAMS.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------

scitex/ai/_gen_ai/_Perplexity.py

@@ -184,7 +184,9 @@ def main():
 if __name__ == "__main__":
     import scitex
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(sys, plt, verbose=False)
+    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(
+        sys, plt, verbose=False
+    )
     main()
     scitex.session.close(CONFIG, verbose=False, notify=False)
 

scitex/ai/_gen_ai/__init__.py

@@ -4,6 +4,7 @@
 # File: /ssh:sp:/home/ywatanabe/proj/scitex_repo/src/scitex/ai/_gen_ai/__init__.py
 # ----------------------------------------
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------

scitex/ai/_gen_ai/_format_output_func.py

@@ -80,7 +80,9 @@ def main() -> None:
 
 
 if __name__ == "__main__":
-    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(sys, plt, verbose=False)
+    CONFIG, sys.stdout, sys.stderr, plt, CC = scitex.session.start(
+        sys, plt, verbose=False
+    )
     main()
     scitex.session.close(CONFIG, verbose=False, notify=False)
 

scitex/ai/classification/CrossValidationExperiment.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -70,9 +71,7 @@ class CrossValidationExperiment:
     ):
         self.name = name
         self.model_fn = model_fn
-        self.cv = cv or StratifiedKFold(
-            n_splits=5, shuffle=True, random_state=42
-        )
+        self.cv = cv or StratifiedKFold(n_splits=5, shuffle=True, random_state=42)
         self.save_models = save_models
         self.verbose = verbose
 
@@ -87,9 +86,7 @@ class CrossValidationExperiment:
             "start_time": None,
             "end_time": None,
             "n_folds": (
-                self.cv.get_n_splits()
-                if hasattr(self.cv, "get_n_splits")
-                else None
+                self.cv.get_n_splits() if hasattr(self.cv, "get_n_splits") else None
             ),
             "hyperparameters": {},
             "dataset_info": {},
@@ -144,9 +141,7 @@ class CrossValidationExperiment:
         }
 
         # Save dataset info
-        self.reporter.add(
-            self.metadata["dataset_info"], "experiment/dataset_info.json"
-        )
+        self.reporter.add(self.metadata["dataset_info"], "experiment/dataset_info.json")
 
     def run(
         self,
@@ -200,9 +195,7 @@ class CrossValidationExperiment:
             fold_start = time.time()
 
             if self.verbose:
-                print(
-                    f"\n--- Fold {fold + 1}/{self.cv.get_n_splits()} ---"
-                )
+                print(f"\n--- Fold {fold + 1}/{self.cv.get_n_splits()} ---")
 
             # Split data
             X_train, X_test = X[train_idx], X[test_idx]
@@ -279,10 +272,10 @@ class CrossValidationExperiment:
         self.reporter.add(timing_info, "experiment/timing.json")
 
         if self.verbose:
-            print(f"\n{'='*70}")
+            print(f"\n{'=' * 70}")
             print(f"Experiment completed in {total_time:.2f}s")
             print(f"Mean fold time: {np.mean(self.fold_times):.2f}s")
-            print(f"{'='*70}\n")
+            print(f"{'=' * 70}\n")
 
         # Generate final reports
         result_paths = self.reporter.save()
@@ -371,4 +364,5 @@ def quick_experiment(
 
     return results
 
+
 # EOF