edda-framework 0.15.0__py3-none-any.whl → 0.15.1__py3-none-any.whl

edda/viewer_app.py

@@ -0,0 +1,147 @@
+"""
+Edda Workflow Viewer - Interactive web interface for workflow visualization.
+
+This application provides an interactive web interface to visualize
+workflow instances with clickable Mermaid diagrams.
+
+Installation:
+    # Install Edda core only (viewer command available but won't run)
+    pip install edda-framework
+
+    # Install with viewer dependencies (recommended)
+    uv sync --extra viewer
+    # or
+    pip install edda-framework[viewer]
+
+Usage:
+    # View existing workflows (no module imports)
+    uv run edda-viewer
+
+    # Import demo_app workflows
+    uv run edda-viewer --import-module demo_app
+
+    # Import custom workflows
+    uv run edda-viewer -m my_workflows
+
+    # Multiple modules
+    uv run edda-viewer -m demo_app -m my_workflows
+
+    # Custom database and port
+    uv run edda-viewer --db my.db --port 9000 -m my_workflows
+
+    # Using Just (project root)
+    just viewer                              # No modules
+    just viewer-demo                         # With demo_app
+    just viewer demo.db 8080 "-m demo_app"  # Custom
+
+Alternative (direct script execution):
+    # Run the viewer script directly
+    uv run python viewer_app.py -m demo_app
+
+    # Or with auto-reload for development
+    nicegui viewer_app.py --reload
+
+Then open http://localhost:<port> in your browser.
+"""
+
+import argparse
+import os
+import sys
+
+from edda import EddaApp
+from edda.viewer_ui import start_viewer
+
+
+def parse_args() -> argparse.Namespace:
+    """Parse command line arguments."""
+    parser = argparse.ArgumentParser(
+        description="Edda Workflow Viewer - Interactive web interface for workflow visualization",
+        epilog="Example: edda-viewer --db my.db --port 9000 -m demo_app -m my_workflows",
+    )
+    parser.add_argument(
+        "--db",
+        "-d",
+        type=str,
+        default="demo.db",
+        help="Database file path (default: demo.db)",
+    )
+    parser.add_argument(
+        "--port",
+        "-p",
+        type=int,
+        default=8080,
+        help="Port number for the web server (default: 8080)",
+    )
+    parser.add_argument(
+        "--import-module",
+        "-m",
+        type=str,
+        action="append",
+        dest="import_modules",
+        help="Python module to import (can be specified multiple times). "
+        "Workflows decorated with @workflow in these modules will be available in the viewer. "
+        "Example: --import-module demo_app",
+    )
+    return parser.parse_args()
+
+
+def main() -> None:
+    """Main entry point for the Edda Viewer CLI."""
+    # Step 1: Check if nicegui is installed
+    try:
+        import nicegui  # type: ignore[import-not-found]  # noqa: F401
+    except ImportError:
+        print("Error: Viewer dependencies are not installed.", file=sys.stderr)
+        print("", file=sys.stderr)
+        print("Please install viewer dependencies with one of:", file=sys.stderr)
+        print("  uv sync --extra viewer", file=sys.stderr)
+        print("  uv pip install edda-framework[viewer]", file=sys.stderr)
+        print("  pip install edda-framework[viewer]", file=sys.stderr)
+        sys.exit(1)
+
+    # Step 2: Parse arguments
+    args = parse_args()
+
+    # Step 3: Import specified modules
+    if args.import_modules:
+        print("Importing modules...")
+        for module_name in args.import_modules:
+            try:
+                __import__(module_name)
+                print(f"  ✓ Imported: {module_name}")
+            except ImportError as e:
+                print(
+                    f"  ✗ Warning: Could not import module '{module_name}': {e}",
+                    file=sys.stderr,
+                )
+                print("    Continuing without this module...", file=sys.stderr)
+        print()
+
+    # Step 4: Determine database URL (prioritize environment variable)
+    db_url = os.getenv("EDDA_DB_URL")
+    if db_url is None:
+        # Fallback to --db option (SQLite)
+        db_url = f"sqlite:///{args.db}"
+        db_display = args.db
+    else:
+        # Hide password in display
+        db_display = db_url.split("@")[-1] if "@" in db_url else db_url
+
+    # Create Edda app (for database access only)
+    edda_app = EddaApp(
+        service_name="viewer",
+        db_url=db_url,
+    )
+
+    # Step 5: Start the viewer (storage will be initialized on startup)
+    print("Starting Edda Viewer...")
+    print(f"  Database: {db_display}")
+    print(f"  Port: {args.port}")
+    print(f"  URL: http://localhost:{args.port}")
+    print()
+
+    start_viewer(edda_app, port=args.port)
+
+
+if __name__ == "__main__":
+    main()

{edda_framework-0.15.0.dist-info → edda_framework-0.15.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edda-framework
-Version: 0.15.0
+Version: 0.15.1
 Summary: Lightweight Durable Execution Framework
 Project-URL: Homepage, https://github.com/i2y/edda
 Project-URL: Documentation, https://github.com/i2y/edda#readme

{edda_framework-0.15.0.dist-info → edda_framework-0.15.1.dist-info}/RECORD

@@ -10,6 +10,7 @@ edda/locking.py,sha256=ZMdzGO4u3h8m3kDysmkDpAkJNvQQADbILPsmo52EQis,12716
 edda/pydantic_utils.py,sha256=dGVPNrrttDeq1k233PopCtjORYjZitsgASPfPnO6R10,9056
 edda/replay.py,sha256=IQGByw9mlTpRulyUgsHJSPsZUULmM2YqFcm2WeB4jtw,43227
 edda/retry.py,sha256=t4_E1skrhotA1XWHTLbKi-DOgCMasOUnhI9OT-O_eCE,6843
+edda/viewer_app.py,sha256=gsvZaa4DQJyOmZC5ynxrDlAJW1lzfoG7t9c__XpWw5Q,4531
 edda/workflow.py,sha256=hfBZM0JrtK0IkvZSrva0VmYVyvKCdiJ5FWFmIVENfrM,8807
 edda/wsgi.py,sha256=1pGE5fhHpcsYnDR8S3NEFKWUs5P0JK4roTAzX9BsIj0,2391
 edda/integrations/__init__.py,sha256=F_CaTvlDEbldfOpPKq_U9ve1E573tS6XzqXnOtyHcXI,33
@@ -56,8 +57,8 @@ edda/visualizer/mermaid_generator.py,sha256=XWa2egoOTNDfJEjPcwoxwQmblUqXf7YInWFj
 edda/migrations/mysql/20251217000000_initial_schema.sql,sha256=LpINasESRhadOeqABwDk4JZ0OZ4_zQw_opnhIR4Xe9U,12367
 edda/migrations/postgresql/20251217000000_initial_schema.sql,sha256=hCaGMWeptpzpnsjfNKVsMYuwPRe__fK9E0VZpClAumQ,11732
 edda/migrations/sqlite/20251217000000_initial_schema.sql,sha256=Wq9gCnQ0K9SOt0PY_8f1MG4va8rLVWIIcf2lnRzSK5g,11906
-edda_framework-0.15.0.dist-info/METADATA,sha256=d7VXuP5MWTx0WvL4KzwmZVl0AUtTJzTxaLWL7Q0Ou8Q,38074
-edda_framework-0.15.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-edda_framework-0.15.0.dist-info/entry_points.txt,sha256=dPH47s6UoJgUZxHoeSMqZsQkLaSE-SGLi-gh88k2WrU,48
-edda_framework-0.15.0.dist-info/licenses/LICENSE,sha256=udxb-V7_cYKTHqW7lNm48rxJ-Zpf0WAY_PyGDK9BPCo,1069
-edda_framework-0.15.0.dist-info/RECORD,,
+edda_framework-0.15.1.dist-info/METADATA,sha256=XPF_Y5pnbx93FmhLIr05vmdzw7G1aqK-q-hkk8XKcBA,38074
+edda_framework-0.15.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+edda_framework-0.15.1.dist-info/entry_points.txt,sha256=Cidn1ATgyQTJVFtn6FVu5u_rhyD4XGTmsCGukFFfzEs,53
+edda_framework-0.15.1.dist-info/licenses/LICENSE,sha256=udxb-V7_cYKTHqW7lNm48rxJ-Zpf0WAY_PyGDK9BPCo,1069
+edda_framework-0.15.1.dist-info/RECORD,,

edda_framework-0.15.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+edda-viewer = edda.viewer_app:main

edda_framework-0.15.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-edda-viewer = viewer_app:main