scitex 2.10.3__py3-none-any.whl → 2.13.0__py3-none-any.whl

scitex/__init__.py

@@ -164,10 +164,7 @@ cloud = _LazyModule("cloud")
 config = _LazyModule("config")
 audio = _LazyModule("audio")
 msword = _LazyModule("msword")
-fts = _LazyModule(
-    "fts"
-)  # Figure-Table-Statistics - single source of truth for bundle schemas
-fsb = fts  # Legacy alias (FSB -> FTS)
+fts = _LazyModule("fts")  # Bundle schemas module
 
 # Centralized path configuration - eager loaded for convenience
 # Usage: scitex.PATHS.logs, scitex.PATHS.cache, etc.

scitex/__main__.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 """
 SciTeX Package Entry Point
 
@@ -9,16 +8,36 @@ Allows running: python -m scitex [command]
 import sys
 
 
+def _check_cli_dependencies():
+    """Check CLI dependencies and return missing ones."""
+    missing = []
+    try:
+        import click
+    except ImportError:
+        missing.append(("click", "pip install click"))
+    return missing
+
+
 def main():
     """Main entry point for scitex CLI"""
+    # Check dependencies first
+    missing = _check_cli_dependencies()
+    if missing:
+        print("SciTeX CLI missing dependencies:")
+        for pkg, install in missing:
+            print(f"  - {pkg}: {install}")
+        print("\nOr install all CLI deps: pip install scitex[cli]")
+        sys.exit(1)
+
     try:
         from scitex.cli.main import cli
 
         cli()
-    except ImportError:
-        # CLI not available (click not installed)
-        print("SciTeX CLI requires 'click' package")
-        print("Install: pip install click")
+    except ImportError as e:
+        print(f"SciTeX CLI import error: {e}")
+        import traceback
+
+        traceback.print_exc()
         sys.exit(1)
 
 

scitex/__version__.py

@@ -8,6 +8,6 @@ __FILE__ = "./src/scitex/__version__.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
-__version__ = "2.10.3"
+__version__ = "2.12.0"
 
 # EOF

scitex/_install_guide.py

@@ -16,33 +16,45 @@ from ._optional_deps import PACKAGE_TO_EXTRA, check_optional_deps
 F = TypeVar("F", bound=Callable[..., Any])
 
 # Module name -> (required_packages, extra_name, description)
+# Synced with pyproject.toml [project.optional-dependencies]
 MODULE_REQUIREMENTS: Dict[str, Tuple[List[str], str, str]] = {
     "ai": (["openai", "anthropic"], "ai", "LLM APIs"),
     "audio": (["pyttsx3", "gtts"], "audio", "Text-to-Speech"),
     "benchmark": (["psutil"], "benchmark", "Performance Monitoring"),
+    "bridge": (["matplotlib", "scipy"], "bridge", "External System Integration"),
     "browser": (["playwright"], "browser", "Web Automation"),
     "capture": (["mss", "PIL"], "capture", "Screenshot Capture"),
     "cli": (["click"], "cli", "Command Line Interface"),
+    "cloud": (["matplotlib"], "cloud", "Cloud Service Integration"),
+    "config": (["pyyaml"], "config", "Configuration Management"),
     "db": (["sqlalchemy"], "db", "Database"),
     "decorators": (["joblib"], "decorators", "Caching Utilities"),
+    "devtools": (["joblib", "ruamel.yaml"], "devtools", "Development Tools"),
+    "diagram": (["pyyaml"], "diagram", "Diagram Generation"),
     "dsp": (["scipy", "sounddevice"], "dsp", "Signal Processing"),
-    "fts": (["matplotlib", "PIL", "flask"], "fts", "Figures/Tables/Stats"),
+    "dt": (["matplotlib"], "dt", "Date/Time Utilities"),
     "gen": (["IPython", "h5py"], "gen", "General Utilities"),
     "git": (["git"], "git", "Git Operations"),
     "io": (["h5py", "openpyxl"], "io", "File I/O"),
     "linalg": (["scipy", "sympy"], "linalg", "Linear Algebra"),
+    "logging": (["matplotlib"], "logging", "Enhanced Logging"),
     "msword": (["docx"], "msword", "MS Word"),
-    "neuro": (["mne"], "neuro", "Neuroscience"),
     "nn": (["torch"], "nn", "Neural Networks"),
+    "parallel": (["tqdm"], "parallel", "Parallel Processing"),
     "path": (["git"], "path", "Path Utilities"),
+    "pd": (["xarray"], "pd", "Pandas Utilities"),
     "plt": (["matplotlib", "seaborn"], "plt", "Plotting"),
     "repro": (["torch"], "repro", "Reproducibility"),
     "resource": (["psutil"], "resource", "Resource Monitoring"),
     "scholar": (["selenium", "bs4", "playwright"], "scholar", "Paper Management"),
+    "session": (["matplotlib", "pyyaml"], "session", "Session Management"),
+    "sh": (["matplotlib"], "sh", "Shell Utilities"),
     "stats": (["scipy", "statsmodels"], "stats", "Statistical Analysis"),
     "str": (["natsort"], "str", "String Utilities"),
+    "tex": (["matplotlib"], "tex", "LaTeX Utilities"),
     "torch": (["torch"], "torch", "PyTorch Support"),
     "types": (["xarray"], "types", "Type Utilities"),
+    "utils": (["h5py", "natsort"], "utils", "General Utilities"),
     "web": (["aiohttp", "bs4"], "web", "Web Utilities"),
     "writer": (["yq"], "writer", "Academic Writing"),
 }

scitex/_optional_deps.py

@@ -38,6 +38,8 @@ PACKAGE_TO_EXTRA: Dict[str, tuple] = {
     "mss": ("mss", "capture"),
     # CLI Module
     "click": ("click", "cli"),
+    # MCP Module (Model Context Protocol)
+    "mcp": ("mcp", "mcp"),
     # DB Module
     "sqlalchemy": ("sqlalchemy", "db"),
     "psycopg2": ("psycopg2-binary", "db"),
@@ -297,4 +299,35 @@ def has_plotting() -> bool:
     return check_optional_deps("matplotlib")["matplotlib"]
 
 
+def has_mcp() -> bool:
+    """Check if MCP (Model Context Protocol) dependencies are available."""
+    return check_optional_deps("mcp")["mcp"]
+
+
+def check_mcp_deps(server_name: str = "scitex") -> None:
+    """
+    Check MCP dependencies and exit with helpful message if missing.
+
+    Use at the start of MCP server main() functions for graceful handling.
+
+    Args:
+        server_name: Name of the MCP server for error messages
+    """
+    import sys
+
+    try:
+        import mcp  # noqa: F401
+    except ImportError:
+        print(f"{'=' * 60}")
+        print(f"MCP Server '{server_name}' requires the 'mcp' package.")
+        print()
+        print("Install with:")
+        print("  pip install mcp")
+        print()
+        print("Or install scitex with MCP support:")
+        print("  pip install scitex[mcp]")
+        print(f"{'=' * 60}")
+        sys.exit(1)
+
+
 # EOF

scitex/ai/classification/reporters/_ClassificationReporter.py

@@ -731,7 +731,7 @@ def run_main():
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/classification/timeseries/_TimeSeriesBlockingSplit.py

@@ -101,7 +101,7 @@ class TimeSeriesBlockingSplit(BaseCrossValidator):
         self.test_ratio = test_ratio
         self.val_ratio = val_ratio
         self.random_state = random_state
-        self.rng_manager = np.random.default_rng(random_state)
+        self.rng = np.random.default_rng(random_state)
 
     def split(
         self,
@@ -616,7 +616,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/classification/timeseries/_TimeSeriesCalendarSplit.py

@@ -110,7 +110,7 @@ class TimeSeriesCalendarSplit(BaseCrossValidator):
         self.gap_intervals = gap_intervals
         self.step_intervals = step_intervals
         self.random_state = random_state
-        self.rng_manager = np.random.default_rng(random_state)
+        self.rng = np.random.default_rng(random_state)
 
     def split(
         self,
@@ -705,7 +705,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/classification/timeseries/_TimeSeriesSlidingWindowSplit.py

@@ -151,7 +151,7 @@ class TimeSeriesSlidingWindowSplit(BaseCrossValidator):
         self.gap = gap
         self.val_ratio = val_ratio
         self.random_state = random_state
-        self.rng_manager = np.random.default_rng(random_state)
+        self.rng = np.random.default_rng(random_state)
         self.overlapping_tests = overlapping_tests
         self.expanding_window = expanding_window
         self.undersample = undersample
@@ -1613,7 +1613,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/classification/timeseries/_TimeSeriesSlidingWindowSplit_v01-not-using-n_splits.py

@@ -121,7 +121,7 @@ class TimeSeriesSlidingWindowSplit(BaseCrossValidator):
         self.gap = gap
         self.val_ratio = val_ratio
         self.random_state = random_state
-        self.rng_manager = np.random.default_rng(random_state)
+        self.rng = np.random.default_rng(random_state)
         self.overlapping_tests = overlapping_tests
         self.expanding_window = expanding_window
         self.undersample = undersample
@@ -1582,7 +1582,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/classification/timeseries/_TimeSeriesStratifiedSplit.py

@@ -97,7 +97,7 @@ class TimeSeriesStratifiedSplit(BaseCrossValidator):
         self.gap = gap
         self.stratify = stratify
         self.random_state = random_state
-        self.rng_manager = np.random.default_rng(random_state)
+        self.rng = np.random.default_rng(random_state)
 
     def split(
         self,
@@ -670,7 +670,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/classification/timeseries/_normalize_timestamp.py

@@ -412,7 +412,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/metrics/_calc_seizure_prediction_metrics.py

@@ -478,7 +478,7 @@ def run_main():
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/plt/_plot_feature_importance.py

@@ -294,7 +294,7 @@ def run_main():
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/plt/_plot_learning_curve.py

@@ -303,7 +303,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/plt/_plot_optuna_study.py

@@ -195,7 +195,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/plt/_plot_pre_rec_curve.py

@@ -257,7 +257,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/plt/_plot_roc_curve.py

@@ -222,7 +222,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/plt/_stx_conf_mat.py

@@ -336,7 +336,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/ai/training/_LearningCurveLogger.py

@@ -525,7 +525,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/audio/mcp_server.py

@@ -20,12 +20,23 @@ from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
 
-import mcp.types as types
-from mcp.server import NotificationOptions, Server
-from mcp.server.models import InitializationOptions
-from mcp.server.stdio import stdio_server
+# Graceful MCP dependency handling
+try:
+    import mcp.types as types
+    from mcp.server import NotificationOptions, Server
+    from mcp.server.models import InitializationOptions
+    from mcp.server.stdio import stdio_server
 
-__all__ = ["AudioServer", "main"]
+    MCP_AVAILABLE = True
+except ImportError:
+    MCP_AVAILABLE = False
+    types = None  # type: ignore
+    Server = None  # type: ignore
+    NotificationOptions = None  # type: ignore
+    InitializationOptions = None  # type: ignore
+    stdio_server = None  # type: ignore
+
+__all__ = ["AudioServer", "main", "MCP_AVAILABLE"]
 
 
 @dataclass
@@ -373,8 +384,8 @@ class AudioServer:
             return {"success": False, "error": str(e)}
 
 
-async def main():
-    """Main entry point for the MCP server."""
+async def _run_server():
+    """Run the MCP server (internal)."""
     server = AudioServer()
     async with stdio_server() as (read_stream, write_stream):
         await server.server.run(
@@ -391,8 +402,27 @@ async def main():
         )
 
 
+def main():
+    """Main entry point for the MCP server."""
+    if not MCP_AVAILABLE:
+        import sys
+
+        print("=" * 60)
+        print("MCP Server 'scitex-audio' requires the 'mcp' package.")
+        print()
+        print("Install with:")
+        print("  pip install mcp")
+        print()
+        print("Or install scitex with MCP support:")
+        print("  pip install scitex[mcp]")
+        print("=" * 60)
+        sys.exit(1)
+
+    asyncio.run(_run_server())
+
+
 if __name__ == "__main__":
-    asyncio.run(main())
+    main()
 
 
 # EOF

scitex/bridge/_figrecipe.py

@@ -63,7 +63,7 @@ def save_with_recipe(
     dict
         Paths to saved files: {'image': Path, 'csv': Path, 'recipe': Path}
     """
-    from scitex.fts._bundle._storage import get_storage
+    from scitex.io.bundle._bundle._storage import get_storage
 
     path = Path(path)
     result = {}

scitex/bridge/_helpers.py

@@ -118,7 +118,7 @@ def _detect_backend(target) -> Literal["plt", "vis"]:
     """
     # Check for vis FigureModel
     try:
-        from scitex.fig.model import FigureModel
+        from scitex.canvas.model import FigureModel
         if isinstance(target, FigureModel):
             return "vis"
     except ImportError:

scitex/bridge/_plt_vis.py

@@ -16,7 +16,7 @@ import warnings
 
 # Legacy model imports - may not be available (deleted module)
 try:
-    from scitex.fig.model import (
+    from scitex.canvas.model import (
         FigureModel,
         AxesModel,
         PlotModel,

scitex/bridge/_stats_plt.py

@@ -29,7 +29,7 @@ from typing import Optional, Dict, Any, Union, List
 import warnings
 
 # Import GUI classes from FTS (single source of truth)
-from scitex.fts._stats import Position
+from scitex.io.bundle._stats import Position
 
 # StatResult is now a dict - the GUI-specific StatResult is deprecated
 StatResult = dict

scitex/bridge/_stats_vis.py

@@ -27,11 +27,11 @@ When bridging between plt and vis, coordinate transformation may be needed.
 from typing import Optional, Dict, Any, List, Tuple
 
 # Import GUI classes from FTS (single source of truth)
-from scitex.fts._stats import Position, StatPositioning
+from scitex.io.bundle._stats import Position, StatPositioning
 
 # Legacy model imports - may not be available
 try:
-    from scitex.fig.model import AnnotationModel, FigureModel, AxesModel, TextStyle
+    from scitex.canvas.model import AnnotationModel, FigureModel, AxesModel, TextStyle
     VIS_MODEL_AVAILABLE = True
 except ImportError:
     AnnotationModel = None

scitex/browser/automation/CookieHandler.py

@@ -186,7 +186,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/core/BrowserMixin.py

@@ -292,7 +292,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/core/ChromeProfileManager.py

@@ -402,7 +402,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/debugging/_browser_logger.py

@@ -620,7 +620,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/debugging/_highlight_element.py

@@ -125,7 +125,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/debugging/_show_grid.py

@@ -126,7 +126,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/interaction/click_center.py

@@ -121,7 +121,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/interaction/click_with_fallbacks.py

@@ -174,7 +174,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/interaction/close_popups.py

@@ -482,7 +482,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/interaction/fill_with_fallbacks.py

@@ -180,7 +180,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/pdf/click_download_for_chrome_pdf_viewer.py

@@ -174,7 +174,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/pdf/detect_chrome_pdf_viewer.py

@@ -166,7 +166,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/stealth/HumanBehavior.py

@@ -310,7 +310,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,

scitex/browser/stealth/StealthManager.py

@@ -964,7 +964,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
         sys,
         plt,
         args=args,