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

scitex/cli/introspect.py

@@ -23,20 +23,20 @@ def introspect(ctx, help_recursive):
 
     \b
     IPython-like introspection for any Python package:
-      signature  - Function/class signature (like func?)
-      docstring  - Extract docstrings
-      source     - Full source code (like func??)
-      members    - List module/class members (like dir())
-      exports    - Show __all__ exports
-      examples   - Find usage examples
+      q         - Function/class signature (like func?)
+      qq        - Full source code (like func??)
+      dir       - List module/class members (like dir())
+      api       - Full module API tree
+      docstring - Extract docstrings
+      exports   - Show __all__ exports
+      examples  - Find usage examples
 
     \b
     Examples:
-      scitex introspect signature scitex.plt.plot
-      scitex introspect docstring scitex.audio.speak --format parsed
-      scitex introspect source scitex.stats.run_test --max-lines 50
-      scitex introspect members scitex.plt --kind functions
-      scitex introspect exports scitex.audio
+      scitex introspect q scitex.plt.plot
+      scitex introspect qq scitex.stats.run_test --max-lines 50
+      scitex introspect dir scitex.plt --kind functions
+      scitex introspect api scitex --max-depth 2
     """
     if help_recursive:
         from . import print_help_recursive
@@ -52,19 +52,19 @@ def introspect(ctx, help_recursive):
 @click.option("--no-defaults", is_flag=True, help="Exclude default values")
 @click.option("--no-annotations", is_flag=True, help="Exclude type annotations")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
-def signature(dotted_path, no_defaults, no_annotations, as_json):
+def q(dotted_path, no_defaults, no_annotations, as_json):
     """
     Get function/class signature (like IPython's func?)
 
     \b
     Examples:
-      scitex introspect signature scitex.plt.plot
-      scitex introspect signature scitex.audio.speak --json
-      scitex introspect signature json.dumps
+      scitex introspect q scitex.plt.plot
+      scitex introspect q scitex.audio.speak --json
+      scitex introspect q json.dumps
     """
-    from scitex.introspect import get_signature
+    from scitex.introspect import q as get_q
 
-    result = get_signature(
+    result = get_q(
         dotted_path,
         include_defaults=not no_defaults,
         include_annotations=not no_annotations,
@@ -89,68 +89,23 @@ def signature(dotted_path, no_defaults, no_annotations, as_json):
                 click.echo(line)
 
 
-@introspect.command()
-@click.argument("dotted_path")
-@click.option(
-    "--format",
-    "-f",
-    type=click.Choice(["raw", "parsed", "summary"]),
-    default="raw",
-    help="Output format",
-)
-@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
-def docstring(dotted_path, format, as_json):
-    """
-    Get docstring of a Python object
-
-    \b
-    Formats:
-      raw     - Full docstring as-is
-      parsed  - Parse into sections (summary, parameters, returns, etc.)
-      summary - First line/paragraph only
-
-    \b
-    Examples:
-      scitex introspect docstring scitex.plt.plot
-      scitex introspect docstring scitex.audio.speak --format parsed
-    """
-    from scitex.introspect import get_docstring
-
-    result = get_docstring(dotted_path, format=format)
-
-    if not result.get("success", False):
-        click.secho(f"Error: {result.get('error', 'Unknown error')}", fg="red")
-        sys.exit(1)
-
-    if as_json:
-        click.echo(json.dumps(result, indent=2))
-    else:
-        click.echo(result["docstring"])
-        if format == "parsed" and result.get("sections"):
-            click.echo("\n--- Parsed Sections ---")
-            for key, value in result["sections"].items():
-                if value:
-                    click.secho(f"\n[{key}]", fg="cyan", bold=True)
-                    click.echo(value)
-
-
 @introspect.command()
 @click.argument("dotted_path")
 @click.option("--max-lines", "-n", type=int, help="Limit output to N lines")
 @click.option("--no-decorators", is_flag=True, help="Exclude decorator lines")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
-def source(dotted_path, max_lines, no_decorators, as_json):
+def qq(dotted_path, max_lines, no_decorators, as_json):
     """
     Get source code of a Python object (like IPython's func??)
 
     \b
     Examples:
-      scitex introspect source scitex.plt.plot
-      scitex introspect source scitex.audio.speak --max-lines 50
+      scitex introspect qq scitex.plt.plot
+      scitex introspect qq scitex.audio.speak --max-lines 50
     """
-    from scitex.introspect import get_source
+    from scitex.introspect import qq as get_qq
 
-    result = get_source(
+    result = get_qq(
         dotted_path,
         max_lines=max_lines,
         include_decorators=not no_decorators,
@@ -169,7 +124,7 @@ def source(dotted_path, max_lines, no_decorators, as_json):
         click.echo(result["source"])
 
 
-@introspect.command()
+@introspect.command("dir")
 @click.argument("dotted_path")
 @click.option(
     "--filter",
@@ -186,19 +141,19 @@ def source(dotted_path, max_lines, no_decorators, as_json):
 )
 @click.option("--inherited", is_flag=True, help="Include inherited members (classes)")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
-def members(dotted_path, filter, kind, inherited, as_json):
+def dir_cmd(dotted_path, filter, kind, inherited, as_json):
     """
     List members of a module or class (like dir())
 
     \b
     Examples:
-      scitex introspect members scitex.plt
-      scitex introspect members scitex.audio --kind functions
-      scitex introspect members scitex.plt.AxisWrapper --filter all
+      scitex introspect dir scitex.plt
+      scitex introspect dir scitex.audio --kind functions
+      scitex introspect dir scitex.plt.AxisWrapper --filter all
     """
-    from scitex.introspect import list_members
+    from scitex.introspect import dir as get_dir
 
-    result = list_members(
+    result = get_dir(
         dotted_path,
         filter=filter,
         kind=kind,
@@ -220,6 +175,89 @@ def members(dotted_path, filter, kind, inherited, as_json):
             click.echo(f"  {kind_str} {name_str}{summary}")
 
 
+@introspect.command()
+@click.argument("dotted_path")
+@click.option("--max-depth", "-d", type=int, default=5, help="Max recursion depth")
+@click.option("--docstring", is_flag=True, help="Include docstrings")
+@click.option("--root-only", is_flag=True, help="Show only root-level items")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def api(dotted_path, max_depth, docstring, root_only, as_json):
+    """
+    List the full API tree of a module recursively
+
+    \b
+    Examples:
+      scitex introspect api scitex --max-depth 2
+      scitex introspect api scitex.plt --docstring
+      scitex introspect api scitex.audio --root-only
+    """
+    from scitex.introspect import list_api
+
+    df = list_api(
+        dotted_path,
+        max_depth=max_depth,
+        docstring=docstring,
+        root_only=root_only,
+    )
+
+    if as_json:
+        click.echo(json.dumps(df.to_dict(orient="records"), indent=2))
+    else:
+        click.secho(f"API tree of {dotted_path} ({len(df)} items):", fg="cyan")
+        for _, row in df.iterrows():
+            indent = "  " * row["Depth"]
+            type_str = click.style(f"[{row['Type']}]", fg="yellow")
+            name = row["Name"].split(".")[-1]
+            name_str = click.style(name, fg="green", bold=True)
+            doc = f" - {row['Docstring'][:50]}..." if row.get("Docstring") else ""
+            click.echo(f"{indent}{type_str} {name_str}{doc}")
+
+
+@introspect.command()
+@click.argument("dotted_path")
+@click.option(
+    "--format",
+    "-f",
+    type=click.Choice(["raw", "parsed", "summary"]),
+    default="raw",
+    help="Output format",
+)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def docstring(dotted_path, format, as_json):
+    """
+    Get docstring of a Python object
+
+    \b
+    Formats:
+      raw     - Full docstring as-is
+      parsed  - Parse into sections (summary, parameters, returns, etc.)
+      summary - First line/paragraph only
+
+    \b
+    Examples:
+      scitex introspect docstring scitex.plt.plot
+      scitex introspect docstring scitex.audio.speak --format parsed
+    """
+    from scitex.introspect import get_docstring
+
+    result = get_docstring(dotted_path, format=format)
+
+    if not result.get("success", False):
+        click.secho(f"Error: {result.get('error', 'Unknown error')}", fg="red")
+        sys.exit(1)
+
+    if as_json:
+        click.echo(json.dumps(result, indent=2))
+    else:
+        click.echo(result["docstring"])
+        if format == "parsed" and result.get("sections"):
+            click.echo("\n--- Parsed Sections ---")
+            for key, value in result["sections"].items():
+                if value:
+                    click.secho(f"\n[{key}]", fg="cyan", bold=True)
+                    click.echo(value)
+
+
 @introspect.command()
 @click.argument("dotted_path")
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")

scitex/cli/main.py

@@ -17,6 +17,7 @@ from . import (
     convert,
     introspect,
     mcp,
+    plt,
     repro,
     resource,
     scholar,
@@ -71,6 +72,7 @@ cli.add_command(config.config)
 cli.add_command(convert.convert)
 cli.add_command(introspect.introspect)
 cli.add_command(mcp.mcp)
+cli.add_command(plt.plt)
 cli.add_command(repro.repro)
 cli.add_command(resource.resource)
 cli.add_command(scholar.scholar)

scitex/cli/plt.py

@@ -0,0 +1,357 @@
+#!/usr/bin/env python3
+# Timestamp: 2026-01-25
+# File: /home/ywatanabe/proj/scitex-python/src/scitex/cli/plt.py
+
+"""
+SciTeX CLI - Plot Commands
+
+Thin wrapper around figrecipe CLI for reproducible matplotlib figures.
+All commands delegate to figrecipe for reproducibility.
+"""
+
+import subprocess
+import sys
+
+import click
+
+
+def _run_figrecipe(*args) -> int:
+    """Run figrecipe CLI command."""
+    cmd = [sys.executable, "-m", "figrecipe"]
+    cmd.extend(args)
+
+    result = subprocess.run(cmd)
+    return result.returncode
+
+
+def _check_figrecipe() -> bool:
+    """Check if figrecipe is available."""
+    try:
+        import figrecipe  # noqa: F401
+
+        return True
+    except ImportError:
+        return False
+
+
+@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 plt(ctx, help_recursive):
+    """
+    Plot and figure management (powered by figrecipe)
+
+    \b
+    Commands:
+      plot       - Create figure from YAML/JSON spec
+      edit       - Launch interactive GUI editor
+      compose    - Combine multiple figures
+      crop       - Crop whitespace from images
+      reproduce  - Reproduce figure from recipe
+      validate   - Validate recipe reproducibility
+      diagram    - Create diagrams (flowcharts, etc.)
+
+    \b
+    Examples:
+      scitex plt plot spec.yaml -o fig.png
+      scitex plt edit
+      scitex plt compose a.png b.png -o combined.png
+      scitex plt reproduce recipe.yaml
+
+    \b
+    Note: Wraps figrecipe CLI. Run 'figrecipe --help' for full options.
+    """
+    if not _check_figrecipe():
+        click.secho("Error: figrecipe not installed", fg="red", err=True)
+        click.echo("\nInstall with: pip install figrecipe")
+        ctx.exit(1)
+
+    if help_recursive:
+        from . import print_help_recursive
+
+        print_help_recursive(ctx, plt)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+@plt.command()
+@click.argument("spec_file", type=click.Path(exists=True))
+@click.option("-o", "--output", required=True, help="Output file path")
+@click.option("--dpi", type=int, default=300, help="DPI for raster output")
+@click.option("--no-recipe", is_flag=True, help="Don't save YAML recipe")
+def plot(spec_file, output, dpi, no_recipe):
+    """
+    Create a figure from a declarative YAML/JSON spec.
+
+    \b
+    Examples:
+      scitex plt plot spec.yaml -o fig.png
+      scitex plt plot spec.json -o fig.pdf --dpi 600
+    """
+    args = ["plot", spec_file, "-o", output, "--dpi", str(dpi)]
+    if no_recipe:
+        args.append("--no-recipe")
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("recipe_file", type=click.Path(exists=True), required=False)
+def edit(recipe_file):
+    """
+    Launch interactive GUI editor.
+
+    \b
+    Examples:
+      scitex plt edit                  # Open blank editor
+      scitex plt edit recipe.yaml      # Open existing recipe
+    """
+    args = ["edit"]
+    if recipe_file:
+        args.append(recipe_file)
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("sources", nargs=-1, required=True, type=click.Path(exists=True))
+@click.option("-o", "--output", required=True, help="Output file path")
+@click.option(
+    "-l",
+    "--layout",
+    type=click.Choice(["horizontal", "vertical", "grid"]),
+    default="horizontal",
+    help="Layout mode",
+)
+@click.option("--gap", type=float, default=5, help="Gap between panels (mm)")
+@click.option("--dpi", type=int, default=300, help="DPI for output")
+@click.option("--no-labels", is_flag=True, help="Don't add panel labels (A, B, C)")
+@click.option("--caption", help="Figure caption")
+def compose(sources, output, layout, gap, dpi, no_labels, caption):
+    """
+    Compose multiple figures into one.
+
+    \b
+    Examples:
+      scitex plt compose a.png b.png -o combined.png
+      scitex plt compose *.png -o fig.pdf --layout grid
+      scitex plt compose a.yaml b.yaml -o fig.png --gap 10
+    """
+    args = ["compose"]
+    args.extend(sources)
+    args.extend(
+        ["-o", output, "--layout", layout, "--gap", str(gap), "--dpi", str(dpi)]
+    )
+    if no_labels:
+        args.append("--no-labels")
+    if caption:
+        args.extend(["--caption", caption])
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("input_file", type=click.Path(exists=True))
+@click.option("-o", "--output", help="Output file (default: overwrites input)")
+@click.option("--margin", type=float, default=1, help="Margin to keep (mm)")
+def crop(input_file, output, margin):
+    """
+    Crop whitespace from an image.
+
+    \b
+    Examples:
+      scitex plt crop figure.png
+      scitex plt crop figure.png -o cropped.png --margin 2
+    """
+    args = ["crop", input_file, "--margin", str(margin)]
+    if output:
+        args.extend(["-o", output])
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("recipe_file", type=click.Path(exists=True))
+@click.option("-o", "--output", help="Output file path")
+@click.option(
+    "--format", "fmt", type=click.Choice(["png", "pdf", "svg"]), help="Output format"
+)
+@click.option("--dpi", type=int, default=300, help="DPI for raster output")
+def reproduce(recipe_file, output, fmt, dpi):
+    """
+    Reproduce a figure from a YAML recipe.
+
+    \b
+    Examples:
+      scitex plt reproduce recipe.yaml
+      scitex plt reproduce recipe.yaml -o new_fig.pdf
+    """
+    args = ["reproduce", recipe_file, "--dpi", str(dpi)]
+    if output:
+        args.extend(["-o", output])
+    if fmt:
+        args.extend(["--format", fmt])
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("recipe_file", type=click.Path(exists=True))
+@click.option("--threshold", type=float, default=100, help="MSE threshold")
+def validate(recipe_file, threshold):
+    """
+    Validate that a recipe reproduces its original figure.
+
+    \b
+    Examples:
+      scitex plt validate recipe.yaml
+      scitex plt validate recipe.yaml --threshold 50
+    """
+    args = ["validate", recipe_file, "--threshold", str(threshold)]
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("spec_file", type=click.Path(exists=True))
+@click.option("-o", "--output", help="Output file path")
+@click.option(
+    "--format", "fmt", type=click.Choice(["mermaid", "graphviz"]), default="mermaid"
+)
+def diagram(spec_file, output, fmt):
+    """
+    Create diagrams (flowcharts, pipelines, etc.)
+
+    \b
+    Examples:
+      scitex plt diagram workflow.yaml
+      scitex plt diagram pipeline.yaml -o diagram.png --format graphviz
+    """
+    args = ["diagram", spec_file, "--format", fmt]
+    if output:
+        args.extend(["-o", output])
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("recipe_file", type=click.Path(exists=True))
+@click.option("-v", "--verbose", is_flag=True, help="Show detailed info")
+def info(recipe_file, verbose):
+    """
+    Show information about a recipe.
+
+    \b
+    Examples:
+      scitex plt info recipe.yaml
+      scitex plt info recipe.yaml --verbose
+    """
+    args = ["info", recipe_file]
+    if verbose:
+        args.append("--verbose")
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("recipe_file", type=click.Path(exists=True))
+@click.option("-o", "--output", help="Output file for extracted data")
+def extract(recipe_file, output):
+    """
+    Extract plotted data arrays from a recipe.
+
+    \b
+    Examples:
+      scitex plt extract recipe.yaml
+      scitex plt extract recipe.yaml -o data.json
+    """
+    args = ["extract", recipe_file]
+    if output:
+        args.extend(["-o", output])
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("action", type=click.Choice(["list", "show", "set"]), default="list")
+@click.argument("style_name", required=False)
+def style(action, style_name):
+    """
+    Manage figure styles and presets.
+
+    \b
+    Examples:
+      scitex plt style list              # List available styles
+      scitex plt style show nature       # Show style details
+      scitex plt style set publication   # Set default style
+    """
+    args = ["style", action]
+    if style_name:
+        args.append(style_name)
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.option("--check", is_flag=True, help="Check font availability")
+def fonts(check):
+    """
+    List or check available fonts.
+
+    \b
+    Examples:
+      scitex plt fonts
+      scitex plt fonts --check
+    """
+    args = ["fonts"]
+    if check:
+        args.append("--check")
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.argument("input_file", type=click.Path(exists=True))
+@click.option("-o", "--output", required=True, help="Output file path")
+@click.option("--format", "fmt", help="Output format (inferred from extension)")
+def convert(input_file, output, fmt):
+    """
+    Convert between figure formats.
+
+    \b
+    Examples:
+      scitex plt convert fig.png -o fig.pdf
+      scitex plt convert fig.svg -o fig.png
+    """
+    args = ["convert", input_file, "-o", output]
+    if fmt:
+        args.extend(["--format", fmt])
+    sys.exit(_run_figrecipe(*args))
+
+
+@plt.command()
+@click.option(
+    "-t",
+    "--transport",
+    type=click.Choice(["stdio", "sse", "http"]),
+    default="stdio",
+    help="Transport protocol",
+)
+@click.option("--host", default="0.0.0.0", help="Host for HTTP/SSE transport")
+@click.option("--port", default=8087, type=int, help="Port for HTTP/SSE transport")
+def serve(transport, host, port):
+    """
+    Run figrecipe MCP server
+
+    \b
+    Examples:
+      scitex plt serve                    # stdio for Claude Desktop
+      scitex plt serve -t http --port 8087
+    """
+    args = ["mcp", "run", "--transport", transport]
+    if transport != "stdio":
+        args.extend(["--host", host, "--port", str(port)])
+        click.secho(f"Starting figrecipe MCP server ({transport})", fg="cyan")
+        click.echo(f"  Host: {host}")
+        click.echo(f"  Port: {port}")
+
+    sys.exit(_run_figrecipe(*args))
+
+
+if __name__ == "__main__":
+    plt()
+
+# EOF

scitex/cli/repro.py

@@ -10,8 +10,13 @@ import sys
 import click
 
 
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
-def repro():
+@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 repro(ctx, help_recursive):
     """
     Reproducibility utilities
 
@@ -29,20 +34,22 @@ def repro():
       scitex repro hash data.npy       # Hash array file
       scitex repro seed 42             # Set random seed
     """
-    pass
+    if help_recursive:
+        _print_help_recursive(ctx)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
 
 
-@repro.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(repro, info_name="repro", parent=fake_parent)
     click.secho("━━━ scitex repro ━━━", fg="cyan", bold=True)
     click.echo(repro.get_help(parent_ctx))
     for name in sorted(repro.list_commands(ctx) or []):
         cmd = repro.get_command(ctx, name)
-        if cmd is None or name == "help-recursive":
+        if cmd is None:
             continue
         click.echo()
         click.secho(f"━━━ scitex repro {name} ━━━", fg="cyan", bold=True)