jac-client 0.2.9__py3-none-any.whl → 0.2.10__py3-none-any.whl

jac_client/plugin/src/targets/desktop/sidecar/main.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""
+Jac Sidecar Entry Point
+
+This is the entry point for the Jac backend sidecar.
+It launches the Jac runtime and starts an HTTP API server.
+
+Usage:
+    python -m jac_client.plugin.src.targets.desktop.sidecar.main [OPTIONS]
+    # Or via wrapper script: ./jac-sidecar.sh [OPTIONS]
+
+Options:
+    --module-path PATH    Path to the .jac module file (default: main.jac)
+    --port PORT          Port to bind the API server (default: 8000)
+    --base-path PATH     Base path for the project (default: current directory)
+    --host HOST          Host to bind to (default: 127.0.0.1)
+    --help               Show this help message
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from jaclang.cli.console import console
+
+
+def main():
+    """Main entry point for the sidecar."""
+    parser = argparse.ArgumentParser(
+        description="Jac Backend Sidecar - Runs Jac API server in a bundled executable"
+    )
+    parser.add_argument(
+        "--module-path",
+        type=str,
+        default="main.jac",
+        help="Path to the .jac module file (default: main.jac)",
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=8000,
+        help="Port to bind the API server (default: 8000)",
+    )
+    parser.add_argument(
+        "--base-path",
+        type=str,
+        default=None,
+        help="Base path for the project (default: current directory)",
+    )
+    parser.add_argument(
+        "--host",
+        type=str,
+        default="127.0.0.1",
+        help="Host to bind to (default: 127.0.0.1)",
+    )
+
+    args = parser.parse_args()
+
+    # Determine base path
+    if args.base_path:
+        base_path = Path(args.base_path).resolve()
+    else:
+        # Try to find project root (look for jac.toml)
+        base_path = Path.cwd()
+        for parent in [base_path] + list(base_path.parents):
+            if (parent / "jac.toml").exists():
+                base_path = parent
+                break
+
+    # Resolve module path
+    module_path = Path(args.module_path)
+    if not module_path.is_absolute():
+        module_path = base_path / module_path
+
+    if not module_path.exists():
+        console.print(f"Error: Module file not found: {module_path}", file=sys.stderr)
+        console.print(f"  Base path: {base_path}", file=sys.stderr)
+        sys.exit(1)
+
+    # Extract module name (without .jac extension)
+    module_name = module_path.stem
+    module_base = module_path.parent
+
+    # Import Jac runtime and server
+    try:
+        # Import jaclang (must be installed via pip)
+        from jaclang.pycore.runtime import JacRuntime as Jac
+    except ImportError as e:
+        console.print(f"Error: Failed to import Jac runtime: {e}", file=sys.stderr)
+        console.print(
+            "  Make sure jaclang is installed: pip install jaclang", file=sys.stderr
+        )
+        sys.exit(1)
+
+    # Initialize Jac runtime
+    try:
+        # Import the module
+        Jac.jac_import(target=module_name, base_path=str(module_base), lng="jac")
+        if Jac.program.errors_had:
+            console.print("Error: Failed to compile module:", file=sys.stderr)
+            for error in Jac.program.errors_had:
+                console.print(f"  {error}", file=sys.stderr)
+            sys.exit(1)
+    except Exception as e:
+        console.print(
+            f"Error: Failed to load module '{module_name}': {e}", file=sys.stderr
+        )
+        import traceback
+
+        traceback.print_exc()
+        sys.exit(1)
+
+    # Create and start the API server
+    try:
+        # Get server class (allows plugins like jac-scale to provide enhanced server)
+        server_class = Jac.get_api_server_class()
+        server = server_class(
+            module_name=module_name, port=args.port, base_path=str(base_path)
+        )
+
+        console.print("Jac Sidecar starting...")
+        console.print(f"  Module: {module_name}")
+        console.print(f"  Base path: {base_path}")
+        console.print(f"  Server: http://{args.host}:{args.port}")
+        console.print("\nPress Ctrl+C to stop the server\n")
+
+        # Start the server (blocks until interrupted)
+        server.start(dev=False)
+
+    except KeyboardInterrupt:
+        console.print("\nShutting down sidecar...")
+        sys.exit(0)
+    except Exception as e:
+        console.print(f"Error: Server failed to start: {e}", file=sys.stderr)
+        import traceback
+
+        traceback.print_exc()
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

jac_client/plugin/src/targets/desktop_target.jac

@@ -0,0 +1,37 @@
+"""Desktop target implementation.
+
+This target will be implemented in Phase 2.
+"""
+import from pathlib { Path }
+import from typing { Optional }
+import from jac_client.plugin.src.targets.registry { ClientTarget }
+
+"""Desktop build target (placeholder for Phase 2)."""
+class DesktopTarget(ClientTarget) {
+    def init(self: DesktopTarget) {
+        self.name = "desktop";
+        self.default = False;
+        self.requires_setup = True;
+        self.config_section = "desktop";
+        self.output_dir = Path("src-tauri/target/release/bundle");
+    }
+
+    """Setup desktop target - scaffold Tauri project structure."""
+    override def setup(self: DesktopTarget, project_dir: Path) -> None;
+
+    """Build desktop app - build web bundle first, then wrap with Tauri."""
+    override def build(
+        self: DesktopTarget,
+        entry_file: Path,
+        project_dir: Path,
+        platform: Optional[str] = None
+    ) -> Path;
+
+    """Start desktop dev server - start web dev server and launch tauri dev."""
+    override def dev(self: DesktopTarget, entry_file: Path, project_dir: Path) -> None;
+
+    """Start desktop app - build web bundle and launch Tauri with built bundle."""
+    override def start(
+        self: DesktopTarget, entry_file: Path, project_dir: Path
+    ) -> None;
+}