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

scitex/cli/template.py

@@ -11,38 +11,55 @@ from pathlib import Path
 import click
 
 
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
-def template():
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    invoke_without_command=True,
+)
+@click.option("--help-recursive", is_flag=True, help="Show help for all subcommands")
+@click.pass_context
+def template(ctx, help_recursive):
     """
     Project template scaffolding
 
     \b
-    Available templates:
+    Project Templates (clone):
       research      - Full scientific workflow structure
       pip-project   - Pip-installable Python package
       singularity   - Container-based project
       paper         - Academic paper writing template
 
+    \b
+    Code Templates (get):
+      session       - @stx.session script with CONFIG docs (priority)
+      io            - stx.io save/load patterns (priority)
+      config        - YAML configuration file
+      session-minimal/plot/stats - Variants
+      module        - Standard Python module
+      all           - All templates combined
+
     \b
     Examples:
-      scitex template list                        # Show available templates
-      scitex template clone research ./my-project # Clone research template
-      scitex template clone pip-project ./my-pkg  # Clone package template
+      scitex template get session                 # Session script template
+      scitex template get io                      # I/O operations template
+      scitex template get all                     # All templates
+      scitex template get session -o script.py   # Save to file
     """
-    pass
+    if help_recursive:
+        _print_help_recursive(ctx)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
 
 
-@template.command("help-recursive")
-@click.pass_context
-def help_recursive(ctx):
-    """Show help for all commands recursively."""
+def _print_help_recursive(ctx):
+    """Print help for all commands recursively."""
     fake_parent = click.Context(click.Group(), info_name="scitex")
     parent_ctx = click.Context(template, info_name="template", parent=fake_parent)
     click.secho("━━━ scitex template ━━━", fg="cyan", bold=True)
     click.echo(template.get_help(parent_ctx))
     for name in sorted(template.list_commands(ctx) or []):
         cmd = template.get_command(ctx, name)
-        if cmd is None or name == "help-recursive":
+        if cmd is None:
             continue
         click.echo()
         click.secho(f"━━━ scitex template {name} ━━━", fg="cyan", bold=True)
@@ -198,6 +215,106 @@ def clone(template_type, destination, git_strategy, branch, tag):
         sys.exit(1)
 
 
+@template.command()
+@click.argument(
+    "template_id",
+    type=click.Choice(
+        [
+            # Core templates (priority 1-3)
+            "session",
+            "io",
+            "config",
+            # Session variants
+            "session-minimal",
+            "session-plot",
+            "session-stats",
+            # Module template
+            "module",
+            # Module usage templates
+            "plt",
+            "stats",
+            "scholar",
+            "audio",
+            "capture",
+            "diagram",
+            "canvas",
+            "writer",
+            # All templates
+            "all",
+        ]
+    ),
+)
+@click.option(
+    "--output", "-o", type=click.Path(), help="Save to file instead of printing"
+)
+@click.option("--docstring", "-d", help="Custom docstring for the template")
+def get(template_id, output, docstring):
+    """
+    Get a code template (print or save to file)
+
+    \b
+    Core Templates (priority 1-3):
+      session         - Full @stx.session script with CONFIG docs
+      io              - stx.io.save/load patterns (30+ formats)
+      config          - YAML configuration file
+
+    \b
+    Session Variants:
+      session-minimal - Minimal session script
+      session-plot    - Plotting-focused session script
+      session-stats   - Statistical analysis script
+      module          - Standard Python module
+
+    \b
+    Module Usage Templates:
+      plt             - stx.plt plotting usage
+      stats           - stx.stats statistical analysis
+      scholar         - stx.scholar literature management
+      audio           - stx.audio text-to-speech
+      capture         - stx.capture screenshots
+      diagram         - stx.diagram Mermaid/Graphviz
+      canvas          - stx.canvas figure composition
+      writer          - stx.writer LaTeX compilation
+
+    \b
+    All:
+      all             - All templates combined
+
+    \b
+    Examples:
+      scitex template get session              # Print to stdout
+      scitex template get io                   # I/O operations template
+      scitex template get all                  # All templates
+      scitex template get session -o script.py # Save to file
+    """
+    try:
+        if template_id == "all":
+            from scitex.template import get_all_templates
+
+            content = get_all_templates()
+        else:
+            from scitex.template import get_code_template
+
+            filepath = output if output else None
+            content = get_code_template(
+                template_id, filepath=filepath, docstring=docstring
+            )
+
+        if output:
+            # Save to file
+            out_path = Path(output)
+            out_path.parent.mkdir(parents=True, exist_ok=True)
+            out_path.write_text(content)
+            click.secho(f"Template saved: {out_path}", fg="green")
+        else:
+            # Print to stdout
+            click.echo(content)
+
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
+
+
 @template.command()
 @click.argument("template_id")
 def info(template_id):

scitex/cli/tex.py

@@ -11,8 +11,13 @@ from pathlib import Path
 import click
 
 
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
-def tex():
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    invoke_without_command=True,
+)
+@click.option("--help-recursive", is_flag=True, help="Show help for all subcommands")
+@click.pass_context
+def tex(ctx, help_recursive):
     """
     LaTeX compilation and utilities
 
@@ -28,20 +33,22 @@ def tex():
       scitex tex preview paper.tex
       scitex tex to-vec figure.tex --format svg
     """
-    pass
+    if help_recursive:
+        _print_help_recursive(ctx)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
 
 
-@tex.command("help-recursive")
-@click.pass_context
-def help_recursive(ctx):
-    """Show help for all commands recursively."""
+def _print_help_recursive(ctx):
+    """Print help for all commands recursively."""
     fake_parent = click.Context(click.Group(), info_name="scitex")
     parent_ctx = click.Context(tex, info_name="tex", parent=fake_parent)
     click.secho("━━━ scitex tex ━━━", fg="cyan", bold=True)
     click.echo(tex.get_help(parent_ctx))
     for name in sorted(tex.list_commands(ctx) or []):
         cmd = tex.get_command(ctx, name)
-        if cmd is None or name == "help-recursive":
+        if cmd is None:
             continue
         click.echo()
         click.secho(f"━━━ scitex tex {name} ━━━", fg="cyan", bold=True)

scitex/cli/writer.py

@@ -11,8 +11,13 @@ from pathlib import Path
 import click
 
 
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
-def writer():
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    invoke_without_command=True,
+)
+@click.option("--help-recursive", is_flag=True, help="Show help for all subcommands")
+@click.pass_context
+def writer(ctx, help_recursive):
     """
     Manuscript writing and LaTeX compilation
 
@@ -23,13 +28,15 @@ def writer():
     - Watch mode for auto-recompilation
     - Project structure management
     """
-    pass
+    if help_recursive:
+        _print_help_recursive(ctx)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
 
 
-@writer.command("help-recursive")
-@click.pass_context
-def help_recursive(ctx):
-    """Show help for all commands recursively."""
+def _print_help_recursive(ctx):
+    """Print help for all commands recursively."""
     fake_parent = click.Context(click.Group(), info_name="scitex")
     parent_ctx = click.Context(writer, info_name="writer", parent=fake_parent)
 
@@ -38,7 +45,7 @@ def help_recursive(ctx):
 
     for name in sorted(writer.list_commands(ctx) or []):
         cmd = writer.get_command(ctx, name)
-        if cmd is None or name == "help-recursive":
+        if cmd is None:
             continue
         click.echo()
         click.secho(f"━━━ scitex writer {name} ━━━", fg="cyan", bold=True)
@@ -280,6 +287,123 @@ def info(dir):
         sys.exit(1)
 
 
+@writer.group()
+def mcp():
+    """
+    MCP (Model Context Protocol) tools for writer module.
+
+    \b
+    Examples:
+      scitex writer mcp list-tools      # List available MCP tools
+      scitex writer mcp usage           # Show tool usage and parameters
+    """
+    pass
+
+
+@mcp.command("list-tools")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def list_tools(as_json: bool):
+    """
+    List available MCP tools for writer module.
+
+    \b
+    Examples:
+      scitex writer mcp list-tools
+      scitex writer mcp list-tools --json
+    """
+    from scitex.writer._mcp.tool_schemas import get_tool_schemas
+
+    tools = get_tool_schemas()
+
+    if as_json:
+        import json
+
+        output = {
+            "module": "writer",
+            "count": len(tools),
+            "tools": [
+                {
+                    "name": t.name,
+                    "description": t.description,
+                    "parameters": list(t.inputSchema.get("properties", {}).keys()),
+                    "required": t.inputSchema.get("required", []),
+                }
+                for t in tools
+            ],
+        }
+        click.echo(json.dumps(output, indent=2))
+    else:
+        click.secho(
+            f"SciTeX Writer MCP Tools ({len(tools)} total)", fg="cyan", bold=True
+        )
+        click.echo()
+
+        for tool in tools:
+            click.secho(f"  {tool.name}", fg="green", bold=True)
+            # First line of description
+            desc = tool.description.split("\n")[0] if tool.description else ""
+            click.echo(f"    {desc}")
+
+            # Parameters
+            props = tool.inputSchema.get("properties", {})
+            required = tool.inputSchema.get("required", [])
+            if props:
+                params = []
+                for pname, pinfo in props.items():
+                    req_marker = "*" if pname in required else ""
+                    params.append(f"{pname}{req_marker}")
+                click.echo(f"    Parameters: {', '.join(params)}")
+            click.echo()
+
+
+@mcp.command("usage")
+@click.argument("tool_name", required=False)
+def usage(tool_name: str):
+    """
+    Show detailed usage for writer MCP tools.
+
+    \b
+    Examples:
+      scitex writer mcp usage                    # Show all tools
+      scitex writer mcp usage compile_manuscript # Show specific tool
+    """
+    from scitex.writer._mcp.tool_schemas import get_tool_schemas
+
+    tools = get_tool_schemas()
+
+    if tool_name:
+        # Find specific tool
+        tool = next((t for t in tools if t.name == tool_name), None)
+        if not tool:
+            click.secho(f"Tool '{tool_name}' not found", fg="red", err=True)
+            click.echo(f"Available tools: {', '.join(t.name for t in tools)}")
+            raise SystemExit(1)
+        tools = [tool]
+
+    for tool in tools:
+        click.secho(f"━━━ {tool.name} ━━━", fg="cyan", bold=True)
+        click.echo()
+        click.echo(f"Description: {tool.description}")
+        click.echo()
+
+        props = tool.inputSchema.get("properties", {})
+        required = tool.inputSchema.get("required", [])
+
+        if props:
+            click.secho("Parameters:", bold=True)
+            for pname, pinfo in props.items():
+                req = " (required)" if pname in required else ""
+                ptype = pinfo.get("type", "any")
+                pdesc = pinfo.get("description", "")
+                default = pinfo.get("default")
+                default_str = f" [default: {default}]" if default is not None else ""
+
+                click.echo(f"  {pname}: {ptype}{req}{default_str}")
+                if pdesc:
+                    click.echo(f"    {pdesc}")
+        click.echo()
+
+
 @writer.command()
 @click.option(
     "--dir",

scitex/cloud/__init__.py

@@ -1,14 +1,44 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # SciTeX Cloud Integration Module
 # Provides cloud-specific functionality for SciTeX running in SciTeX Cloud
+#
+# This module wraps the scitex-cloud package (if installed) and provides
+# additional cloud environment utilities.
 
+import base64
 import os
 import sys
-import base64
 from pathlib import Path
 from typing import Optional
 
+# ============================================================================
+# Optional scitex-cloud package integration
+# Pattern: scitex-cloud → scitex.cloud (like figrecipe → scitex.plt)
+# ============================================================================
+try:
+    from scitex_cloud import (
+        DockerManager,
+        Environment,
+        get_environment,
+    )
+    from scitex_cloud import __version__ as cloud_version
+    from scitex_cloud import (
+        config as cloud_config,
+    )
+    from scitex_cloud import (
+        utils as cloud_utils,
+    )
+
+    HAS_CLOUD_CLI = True
+except ImportError:
+    HAS_CLOUD_CLI = False
+    cloud_version = None
+    DockerManager = None
+    Environment = None
+    get_environment = None
+    cloud_config = None
+    cloud_utils = None
+
 
 def is_cloud_environment() -> bool:
     """Check if running in SciTeX Cloud environment."""
@@ -116,11 +146,20 @@ def emit_file_link(file_path: str, line_number: Optional[int] = None) -> None:
 
 
 __all__ = [
+    # Local cloud environment utilities
     "is_cloud_environment",
     "get_cloud_backend",
     "get_project_root",
     "emit_inline_image",
     "emit_file_link",
+    # scitex-cloud package integration (if installed)
+    "HAS_CLOUD_CLI",
+    "cloud_version",
+    "DockerManager",
+    "Environment",
+    "get_environment",
+    "cloud_config",
+    "cloud_utils",
 ]
 
 # Auto-import matplotlib hook to enable inline plotting

scitex/config/README.md

@@ -1,7 +1,7 @@
 <!-- ---
 !-- Timestamp: 2025-12-09
 !-- Author: ywatanabe
-!-- File: /home/ywatanabe/proj/scitex-code/src/scitex/config/README.md
+!-- File: /home/ywatanabe/proj/scitex-python/src/scitex/config/README.md
 !-- --- -->
 
 # SciTeX Configuration Module

scitex/config/__init__.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # Timestamp: "2025-12-09 (ywatanabe)"
 # File: ./src/scitex/config/__init__.py
 
@@ -34,8 +33,16 @@ Usage:
     cache_dir = paths.resolve("cache", user_provided_path)
 """
 
-from ._PriorityConfig import PriorityConfig, get_scitex_dir, load_dotenv
+from ._env_registry import (
+    ENV_REGISTRY,
+    EnvVar,
+    generate_template,
+    get_all_modules,
+    get_env_by_module,
+    get_env_docs,
+)
 from ._paths import ScitexPaths, get_paths
+from ._PriorityConfig import PriorityConfig, get_scitex_dir, load_dotenv
 from ._ScitexConfig import ScitexConfig, get_config, load_yaml
 
 __all__ = [
@@ -50,6 +57,13 @@ __all__ = [
     "PriorityConfig",
     "get_scitex_dir",
     "load_dotenv",
+    # Environment variable registry
+    "ENV_REGISTRY",
+    "EnvVar",
+    "generate_template",
+    "get_all_modules",
+    "get_env_by_module",
+    "get_env_docs",
 ]