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

scitex/cli/writer.py

@@ -1,329 +1,79 @@
 #!/usr/bin/env python3
 """
-SciTeX Writer Commands - LaTeX Manuscript Management
+SciTeX Writer CLI - Thin wrapper delegating to scitex-writer package.
 
-Provides manuscript project initialization and compilation.
+All commands are delegated to scitex-writer CLI for maintainability.
 """
 
+import subprocess
 import sys
-from pathlib import Path
 
 import click
 
+# Check if scitex-writer package is available
+try:
+    import scitex_writer
 
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
-def writer():
-    """
-    Manuscript writing and LaTeX compilation
-
-    \b
-    Provides manuscript project management:
-    - Initialize new manuscript projects
-    - Compile manuscript, supplementary, and revision documents
-    - Watch mode for auto-recompilation
-    - Project structure management
-    """
-    pass
-
-
-@writer.command("help-recursive")
-@click.pass_context
-def help_recursive(ctx):
-    """Show 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)
-
-    click.secho("━━━ scitex writer ━━━", fg="cyan", bold=True)
-    click.echo(writer.get_help(parent_ctx))
-
-    for name in sorted(writer.list_commands(ctx) or []):
-        cmd = writer.get_command(ctx, name)
-        if cmd is None or name == "help-recursive":
-            continue
-        click.echo()
-        click.secho(f"━━━ scitex writer {name} ━━━", fg="cyan", bold=True)
-        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
-            click.echo(cmd.get_help(sub_ctx))
-
-
-@writer.command()
-@click.argument("project_dir", type=click.Path())
-@click.option(
-    "--git-strategy",
-    "-g",
-    type=click.Choice(["child", "parent", "origin", "none"], case_sensitive=False),
-    default="child",
-    help="Git initialization strategy (default: child)",
-)
-@click.option("--branch", "-b", help="Specific branch of template to clone")
-@click.option("--tag", "-t", help="Specific tag/release of template to clone")
-def clone(project_dir, git_strategy, branch, tag):
-    """
-    Clone a new writer project from template
-
-    \b
-    Arguments:
-        PROJECT_DIR  Path to project directory (will be created)
-
-    \b
-    Git Strategies:
-        child   - Create isolated git in project directory (default)
-        parent  - Use parent git repository
-        origin  - Preserve template's original git history
-        none    - Disable git initialization
+    HAS_WRITER_PKG = True
+except ImportError:
+    HAS_WRITER_PKG = False
 
-    \b
-    Examples:
-        scitex writer clone my_paper
-        scitex writer clone ./papers/my_paper
-        scitex writer clone my_paper --git-strategy parent
-        scitex writer clone my_paper --branch develop
-        scitex writer clone my_paper --tag v1.0.0
-    """
-    try:
-        from scitex.writer._clone_writer_project import clone_writer_project
-
-        # Validate mutual exclusivity of branch and tag
-        if branch and tag:
-            click.echo("Error: Cannot specify both --branch and --tag", err=True)
-            sys.exit(1)
-
-        # Convert git_strategy 'none' to None
-        if git_strategy and git_strategy.lower() == "none":
-            git_strategy = None
 
-        click.echo(f"Cloning writer project: {project_dir}")
-
-        # Clone writer project
-        result = clone_writer_project(
-            project_dir=project_dir,
-            git_strategy=git_strategy,
-            branch=branch,
-            tag=tag,
+def _require_writer_pkg():
+    """Check if scitex-writer package is available."""
+    if not HAS_WRITER_PKG:
+        click.secho(
+            "scitex-writer package not installed. "
+            "Install with: pip install scitex-writer",
+            fg="red",
+            err=True,
         )
-
-        if result:
-            project_path = Path(project_dir)
-            click.echo()
-            click.secho(
-                f"✓ Successfully cloned project at {project_path.absolute()}",
-                fg="green",
-            )
-            click.echo()
-            click.echo("Project structure:")
-            click.echo(f"  {project_dir}/")
-            click.echo(
-                "    ├── 00_shared/          # Shared resources (figures, bibliography)"
-            )
-            click.echo("    ├── 01_manuscript/      # Main manuscript")
-            click.echo("    ├── 02_supplementary/   # Supplementary materials")
-            click.echo("    ├── 03_revision/        # Revision documents")
-            click.echo("    └── scripts/            # Compilation scripts")
-            click.echo()
-            click.echo("Next steps:")
-            click.echo(f"  cd {project_dir}")
-            click.echo("  # Edit your manuscript in 01_manuscript/contents/")
-            click.echo("  scitex writer compile manuscript")
-        else:
-            click.secho("✗ Failed to clone project", fg="red", err=True)
-            sys.exit(1)
-
-    except Exception as e:
-        click.secho(f"Error: {e}", fg="red", err=True)
         sys.exit(1)
 
 
-@writer.command()
-@click.argument(
-    "document",
-    type=click.Choice(
-        ["manuscript", "supplementary", "revision"], case_sensitive=False
-    ),
-    default="manuscript",
-)
-@click.option(
-    "--dir",
-    "-d",
-    type=click.Path(exists=True),
-    help="Project directory (defaults to current directory)",
+@click.command(
+    context_settings={
+        "help_option_names": ["-h", "--help"],
+        "ignore_unknown_options": True,
+        "allow_extra_args": True,
+        "allow_interspersed_args": False,
+    },
 )
-@click.option(
-    "--track-changes", is_flag=True, help="Enable change tracking (revision only)"
-)
-@click.option(
-    "--timeout",
-    type=int,
-    default=300,
-    help="Compilation timeout in seconds (default: 300)",
-)
-def compile(document, dir, track_changes, timeout):
+@click.argument("args", nargs=-1, type=click.UNPROCESSED)
+@click.pass_context
+def writer(ctx, args):
     """
-    Compile LaTeX document to PDF
+    Manuscript writing and LaTeX compilation (delegates to scitex-writer)
 
     \b
-    Arguments:
-        DOCUMENT  Document type to compile (manuscript|supplementary|revision)
+    Commands (from scitex-writer):
+      compile     Compile LaTeX to PDF
+      bib         Bibliography management
+      tables      Table management
+      figures     Figure management
+      guidelines  IMRAD writing guidelines
+      prompts     AI prompts (Asta integration)
+      mcp         MCP server commands
 
     \b
     Examples:
-        scitex writer compile manuscript
-        scitex writer compile manuscript --dir ./my_paper
-        scitex writer compile revision --track-changes
-        scitex writer compile supplementary --timeout 600
-    """
-    from scitex.writer import Writer
-
-    project_dir = Path(dir) if dir else Path.cwd()
-
-    # Check if this is a Writer project before trying to attach
-    required_dirs = ["01_manuscript", "02_supplementary", "03_revision"]
-    missing = [d for d in required_dirs if not (project_dir / d).exists()]
-
-    if missing:
-        click.echo(f"Not a Writer project: {project_dir.absolute()}")
-        click.echo(f"Missing directories: {', '.join(missing)}")
-        click.echo()
-        click.echo("To create a new project, run:")
-        click.echo("  scitex writer clone <project-name>")
-        return  # Exit gracefully with code 0
-
-    try:
-        writer = Writer(project_dir)
-
-        click.echo(f"Compiling {document} in {project_dir}...")
-        click.echo()
-
-        # Compile based on document type
-        if document == "manuscript":
-            result = writer.compile_manuscript(timeout=timeout)
-        elif document == "supplementary":
-            result = writer.compile_supplementary(timeout=timeout)
-        elif document == "revision":
-            result = writer.compile_revision(
-                track_changes=track_changes, timeout=timeout
-            )
-
-        if result.success:
-            click.secho("✓ Compilation successful!", fg="green")
-            click.echo(f"PDF: {result.output_pdf}")
-        else:
-            click.secho(
-                f"✗ Compilation failed (exit code {result.exit_code})",
-                fg="red",
-                err=True,
-            )
-            if result.errors:
-                click.echo()
-                click.echo("Errors:")
-                for error in result.errors[:10]:  # Show first 10 errors
-                    click.echo(f"  - {error}")
-            sys.exit(result.exit_code)
-
-    except Exception as e:
-        click.secho(f"Error: {e}", fg="red", err=True)
-        sys.exit(1)
-
-
-@writer.command()
-@click.option(
-    "--dir",
-    "-d",
-    type=click.Path(exists=True),
-    help="Project directory (defaults to current directory)",
-)
-def info(dir):
-    """
-    Show project information
+      scitex writer compile manuscript ./my-paper
+      scitex writer bib list ./my-paper
+      scitex writer tables add ./my-paper data.csv
+      scitex writer figures list ./my-paper
+      scitex writer guidelines get abstract
+      scitex writer prompts asta ./my-paper --section introduction
 
     \b
-    Examples:
-        scitex writer info
-        scitex writer info --dir ./my_paper
+    For full help:
+      scitex writer --help
+      scitex-writer --help
     """
-    from scitex.writer import Writer
-
-    project_dir = Path(dir) if dir else Path.cwd()
-
-    # Check if this is a Writer project before trying to attach
-    required_dirs = ["01_manuscript", "02_supplementary", "03_revision"]
-    missing = [d for d in required_dirs if not (project_dir / d).exists()]
-
-    if missing:
-        click.echo(f"Not a Writer project: {project_dir.absolute()}")
-        click.echo(f"Missing directories: {', '.join(missing)}")
-        return  # Exit gracefully with code 0
+    _require_writer_pkg()
 
-    try:
-        writer = Writer(project_dir)
-
-        click.echo(f"Project: {writer.project_name}")
-        click.echo(f"Location: {writer.project_dir.absolute()}")
-        click.echo(f"Git root: {writer.git_root}")
-        click.echo()
-        click.echo("Documents:")
-        click.echo(f"  - Manuscript: {writer.manuscript.root}")
-        click.echo(f"  - Supplementary: {writer.supplementary.root}")
-        click.echo(f"  - Revision: {writer.revision.root}")
-        click.echo()
-
-        # Check for compiled PDFs
-        click.echo("Compiled PDFs:")
-        for doc_type in ["manuscript", "supplementary", "revision"]:
-            pdf = writer.get_pdf(doc_type)
-            if pdf:
-                click.secho(f"  ✓ {doc_type}: {pdf}", fg="green")
-            else:
-                click.echo(f"  - {doc_type}: not compiled")
-
-    except Exception as e:
-        click.secho(f"Error: {e}", fg="red", err=True)
-        sys.exit(1)
-
-
-@writer.command()
-@click.option(
-    "--dir",
-    "-d",
-    type=click.Path(exists=True),
-    help="Project directory (defaults to current directory)",
-)
-def watch(dir):
-    """
-    Watch for file changes and auto-recompile
-
-    \b
-    Examples:
-        scitex writer watch
-        scitex writer watch --dir ./my_paper
-    """
-    from scitex.writer import Writer
-
-    project_dir = Path(dir) if dir else Path.cwd()
-
-    # Check if this is a Writer project before trying to attach
-    required_dirs = ["01_manuscript", "02_supplementary", "03_revision"]
-    missing = [d for d in required_dirs if not (project_dir / d).exists()]
-
-    if missing:
-        click.echo(f"Not a Writer project: {project_dir.absolute()}")
-        click.echo(f"Missing directories: {', '.join(missing)}")
-        return  # Exit gracefully with code 0
-
-    try:
-        writer = Writer(project_dir)
-
-        click.echo(f"Watching {project_dir} for changes...")
-        click.echo("Press Ctrl+C to stop")
-        click.echo()
-
-        writer.watch()
-
-    except KeyboardInterrupt:
-        click.echo()
-        click.echo("Stopped watching")
-    except Exception as e:
-        click.secho(f"Error: {e}", fg="red", err=True)
-        sys.exit(1)
+    # Delegate to scitex-writer CLI
+    cmd = ["scitex-writer"] + list(args)
+    sys.exit(subprocess.call(cmd))
 
 
 # EOF

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",
 ]