Tui separation and simplification (#65)

* Move tui dependencies to be optional

* Identify processed files both with suffix and prefix

---------

Co-authored-by: avvertix <5672748+avvertix@users.noreply.github.com>

Author: avvertix

pyproject.toml

@@ -21,7 +21,6 @@ dependencies = [
     "opentelemetry-exporter-otlp>=1.37.0",
     "opentelemetry-proto>=1.37.0",
     "opentelemetry-sdk>=1.37.0",
-    "textual>=0.89.0",
 ]
 
 [project.scripts]
@@ -40,16 +39,18 @@ llmwhisperer = [
 unstructured_local = [
     "unstructured[pdf]>=0.18.13",
 ]
-
 landingai = [
-    "landingai-ade>=0.15.1"
+    "landingai-ade>=0.15.1",
+]
+tui = [
+    "textual>=0.89.0",
 ]
-
 all = [
     "llama-cloud-services>=0.6.77",
     "llmwhisperer-client>=2.4.2",
     "unstructured[pdf]>=0.18.13",
     "landingai-ade>=0.15.1",
+    "textual>=0.89.0",
 ]
 
 

src/parxy_cli/commands/tui.py

@@ -1,12 +1,11 @@
 """Command to launch the Parxy TUI."""
 
 from pathlib import Path
-from typing import Annotated
+from typing import Annotated, Optional
 
 import typer
 
 from parxy_cli.console.console import Console
-from parxy_cli.tui.app import run_tui
 
 app = typer.Typer(
     name='tui', help='Launch the Parxy TUI for interactive parser comparison'
@@ -18,40 +17,60 @@
 @app.callback(invoke_without_command=True)
 def tui(
     workspace: Annotated[
-        str,
+        Optional[str],
         typer.Argument(
-            help='Path to the workspace folder containing documents to process',
+            help='Path to the workspace folder (optional — can be selected inside the TUI)',
         ),
-    ],
+    ] = None,
 ):
     """
     Launch the Parxy TUI for interactive parser comparison.
 
+    If no workspace is provided, the TUI opens a folder selection screen.
+
     The TUI provides an interactive interface to:
     - Browse files in your workspace
     - Select multiple parsers to compare
     - View parsing results side-by-side
     - See JSON and Markdown diffs between parsers
 
+    Requires the tui extra: pip install 'parxy[tui]'
+
     Examples:
 
+        # Launch TUI and select a folder interactively
+        parxy tui
+
         # Launch TUI with current directory
         parxy tui .
 
         # Launch TUI with specific folder
         parxy tui /path/to/documents
     """
-    workspace_path = Path(workspace).resolve()
+    workspace_path: Optional[Path] = None
 
-    if not workspace_path.exists():
-        console.error(f'Workspace path does not exist: {workspace_path}')
-        raise typer.Exit(1)
+    if workspace is not None:
+        workspace_path = Path(workspace).resolve()
 
-    if not workspace_path.is_dir():
-        console.error(f'Workspace path is not a directory: {workspace_path}')
+        if not workspace_path.exists():
+            console.error(f'Workspace path does not exist: {workspace_path}')
+            raise typer.Exit(1)
+
+        if not workspace_path.is_dir():
+            console.error(f'Workspace path is not a directory: {workspace_path}')
+            raise typer.Exit(1)
+
+    try:
+        from parxy_cli.tui.app import run_tui
+    except ImportError:
+        console.error(
+            "The TUI requires the 'tui' extra. Install it with:\n\n"
+            "    pip install 'parxy[tui]'"
+        )
         raise typer.Exit(1)
 
-    console.info(f'Starting Parxy TUI with workspace: {workspace_path}')
+    if workspace_path:
+        console.info(f'Starting Parxy TUI with workspace: {workspace_path}')
 
     try:
         run_tui(workspace_path)