scitex 2.15.1__py3-none-any.whl → 2.15.2__py3-none-any.whl

scitex/__init__.py

@@ -29,19 +29,9 @@ warnings.filterwarnings("default", category=DeprecationWarning, module="scitex.*
 # Version
 from .__version__ import __version__
 
-# Installation guide - show users what modules are available
-from ._install_guide import show_install_guide
-
-
-# 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()
+# BACKWARD COMPATIBILITY: Deprecated items accessible via __getattr__
+# These are handled at the end of this file after lazy modules are defined
+_DEPRECATED_ATTRS = {"INJECTED", "show_install_guide", "Diagram"}
 
 
 # Lazy loading for all modules
@@ -198,47 +188,53 @@ msword = _LazyModule("msword")
 fts = _LazyModule("fts")  # Bundle schemas module
 social = _LazyModule("social")  # Social media integration (socialia wrapper)
 diagram = _LazyModule("diagram")  # Diagram creation (delegates to figrecipe)
-
-
-# Lazy Diagram class - delegates to figrecipe.Diagram
-class _LazyDiagram:
-    """Lazy loader for Diagram class from figrecipe."""
-
-    _class = None
-
-    def __new__(cls, *args, **kwargs):
-        if cls._class is None:
-            try:
-                from figrecipe import Diagram as _FigrecipeDiagram
-
-                cls._class = _FigrecipeDiagram
-            except ImportError:
-                # Fallback to scitex's own implementation if figrecipe not available
-                from scitex.diagram._diagram import Diagram as _ScitexDiagram
-
-                cls._class = _ScitexDiagram
-        return cls._class(*args, **kwargs)
-
-    @classmethod
-    def from_yaml(cls, *args, **kwargs):
-        if cls._class is None:
-            cls.__new__(cls)  # Trigger lazy load
-        return cls._class.from_yaml(*args, **kwargs)
-
-    @classmethod
-    def from_mermaid(cls, *args, **kwargs):
-        if cls._class is None:
-            cls.__new__(cls)  # Trigger lazy load
-        return cls._class.from_mermaid(*args, **kwargs)
-
-    @classmethod
-    def from_dict(cls, *args, **kwargs):
-        if cls._class is None:
-            cls.__new__(cls)  # Trigger lazy load
-        return cls._class.from_dict(*args, **kwargs)
-
-
-Diagram = _LazyDiagram
+introspect = _LazyModule("introspect")  # Python introspection utilities
+sh = _LazyModule("sh")  # Shell command execution
+os = _LazyModule("os")  # OS utilities (file operations)
+cv = _LazyModule("cv")  # Computer vision utilities
+ui = _LazyModule("ui")  # User interface utilities
+git = _LazyModule("git")  # Git operations
+schema = _LazyModule("schema")  # Data schema utilities
+canvas = _LazyModule("canvas")  # Canvas utilities for figure composition
+security = _LazyModule("security")  # Security utilities
+benchmark = _LazyModule("benchmark")  # Benchmarking utilities
+bridge = _LazyModule("bridge")  # Bridge utilities
+browser = _LazyModule("browser")  # Browser automation
+compat = _LazyModule("compat")  # Compatibility utilities
+cli = _LazyModule("cli")  # Command-line interface
+
+
+# BACKWARD COMPATIBILITY: Module-level __getattr__ for deprecated attributes
+def __getattr__(name):
+    """Handle deprecated attributes with warnings."""
+    if name == "INJECTED":
+        warnings.warn(
+            "scitex.INJECTED is deprecated, use scitex.session.INJECTED instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        from .session import INJECTED
+
+        return INJECTED
+    if name == "show_install_guide":
+        warnings.warn(
+            "scitex.show_install_guide() is deprecated, use scitex.dev.show_install_guide() instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        from .dev import show_install_guide
+
+        return show_install_guide
+    if name == "Diagram":
+        warnings.warn(
+            "scitex.Diagram is deprecated, use scitex.diagram.Diagram instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        from .diagram import Diagram
+
+        return Diagram
+    raise AttributeError(f"module 'scitex' has no attribute '{name}'")
 
 
 # Centralized path configuration - eager loaded for convenience
@@ -257,6 +253,7 @@ if _os.environ.get("SCITEX_CLOUD_CODE_WORKSPACE") == "true":
         pass  # Silently fail if matplotlib not available
 
 __all__ = [
+    # Core modules
     "io",
     "gen",
     "plt",
@@ -268,7 +265,6 @@ __all__ = [
     "path",
     "dict",
     "decorators",
-    "__version__",
     "sh",
     "errors",
     "units",
@@ -292,7 +288,7 @@ __all__ = [
     "linalg",
     "parallel",
     "datetime",
-    "dt",  # Alias for datetime (shorter name)
+    "dt",
     "types",
     "utils",
     "etc",
@@ -304,12 +300,23 @@ __all__ = [
     "audio",
     "msword",
     "fts",
-    "fsb",  # Legacy alias
-    "social",  # Social media integration
-    "diagram",  # Diagram module (delegates to figrecipe)
-    "Diagram",  # Diagram class (from figrecipe)
+    "social",
+    "diagram",
+    "introspect",
+    "os",
+    "cv",
+    "ui",
+    "git",
+    "schema",
+    "canvas",
+    "security",
+    "benchmark",
+    "bridge",
+    "browser",
+    "compat",
+    "cli",
     "PATHS",
-    "INJECTED",
+    "__version__",
 ]
 
 # EOF

scitex/_mcp_tools/introspect.py

@@ -16,17 +16,18 @@ def _json(data: dict) -> str:
 
 def register_introspect_tools(mcp) -> None:
     """Register introspection tools with FastMCP server."""
+    # IPython-style tools (primary)
 
     @mcp.tool()
-    async def introspect_signature(
+    async def introspect_q(
         dotted_path: str,
         include_defaults: bool = True,
         include_annotations: bool = True,
     ) -> str:
         """[introspect] Get function/class signature (like IPython's func?)."""
-        from scitex.introspect._mcp.handlers import signature_handler
+        from scitex.introspect._mcp.handlers import q_handler
 
-        result = await signature_handler(
+        result = await q_handler(
             dotted_path=dotted_path,
             include_defaults=include_defaults,
             include_annotations=include_annotations,
@@ -34,29 +35,15 @@ def register_introspect_tools(mcp) -> None:
         return _json(result)
 
     @mcp.tool()
-    async def introspect_docstring(
-        dotted_path: str,
-        format: str = "raw",
-    ) -> str:
-        """[introspect] Get docstring of a Python object. format: raw|parsed|summary."""
-        from scitex.introspect._mcp.handlers import docstring_handler
-
-        result = await docstring_handler(
-            dotted_path=dotted_path,
-            format=format,
-        )
-        return _json(result)
-
-    @mcp.tool()
-    async def introspect_source(
+    async def introspect_qq(
         dotted_path: str,
         max_lines: Optional[int] = None,
         include_decorators: bool = True,
     ) -> str:
         """[introspect] Get source code of a Python object (like IPython's func??)."""
-        from scitex.introspect._mcp.handlers import source_handler
+        from scitex.introspect._mcp.handlers import qq_handler
 
-        result = await source_handler(
+        result = await qq_handler(
             dotted_path=dotted_path,
             max_lines=max_lines,
             include_decorators=include_decorators,
@@ -64,16 +51,16 @@ def register_introspect_tools(mcp) -> None:
         return _json(result)
 
     @mcp.tool()
-    async def introspect_members(
+    async def introspect_dir(
         dotted_path: str,
         filter: str = "public",
         kind: Optional[str] = None,
         include_inherited: bool = False,
     ) -> str:
         """[introspect] List members of module/class (like dir()). filter: all|public|private|dunder."""
-        from scitex.introspect._mcp.handlers import members_handler
+        from scitex.introspect._mcp.handlers import dir_handler
 
-        result = await members_handler(
+        result = await dir_handler(
             dotted_path=dotted_path,
             filter=filter,
             kind=kind,
@@ -81,6 +68,38 @@ def register_introspect_tools(mcp) -> None:
         )
         return _json(result)
 
+    @mcp.tool()
+    async def introspect_api(
+        dotted_path: str,
+        max_depth: int = 5,
+        docstring: bool = False,
+        root_only: bool = False,
+    ) -> str:
+        """[introspect] List the API tree of a module recursively."""
+        from scitex.introspect._mcp.handlers import list_api_handler
+
+        result = await list_api_handler(
+            dotted_path=dotted_path,
+            max_depth=max_depth,
+            docstring=docstring,
+            root_only=root_only,
+        )
+        return _json(result)
+
+    @mcp.tool()
+    async def introspect_docstring(
+        dotted_path: str,
+        format: str = "raw",
+    ) -> str:
+        """[introspect] Get docstring of a Python object. format: raw|parsed|summary."""
+        from scitex.introspect._mcp.handlers import docstring_handler
+
+        result = await docstring_handler(
+            dotted_path=dotted_path,
+            format=format,
+        )
+        return _json(result)
+
     @mcp.tool()
     async def introspect_exports(dotted_path: str) -> str:
         """[introspect] Get __all__ exports of a module."""

scitex/_mcp_tools/template.py

@@ -62,5 +62,29 @@ def register_template_tools(mcp) -> None:
         result = await list_git_strategies_handler()
         return _json(result)
 
+    @mcp.tool()
+    async def template_get_code_template(
+        template_id: str,
+        filepath: Optional[str] = None,
+        docstring: Optional[str] = None,
+    ) -> str:
+        """[template] Get a code template for scripts and modules. Core: session, io, config. Module usage: plt, stats, scholar, audio, capture, diagram, canvas, writer. Use 'all' for all templates combined."""
+        from scitex.template._mcp.handlers import get_code_template_handler
+
+        result = await get_code_template_handler(
+            template_id=template_id,
+            filepath=filepath,
+            docstring=docstring,
+        )
+        return _json(result)
+
+    @mcp.tool()
+    async def template_list_code_templates() -> str:
+        """[template] List all available code templates for scripts and modules."""
+        from scitex.template._mcp.handlers import list_code_templates_handler
+
+        result = await list_code_templates_handler()
+        return _json(result)
+
 
 # EOF