bootstack 0.1.0a1__py3-none-any.whl

bootstack/cli/run.py

@@ -0,0 +1,99 @@
+"""bootstack run command - Run a bootstack application."""
+
+from __future__ import annotations
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+from bootstack.cli.config import TtkbConfig, find_config
+
+
+def add_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add the 'run' subcommand parser."""
+    parser = subparsers.add_parser(
+        "run",
+        help="Run the bootstack application",
+        description="Run the application using the entry point defined in bootstack.toml.",
+    )
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=None,
+        help="Path to entry point or directory containing bootstack.toml (default: current directory)",
+    )
+    parser.set_defaults(func=run_run)
+
+
+def run_run(args: argparse.Namespace) -> None:
+    """Execute the run command."""
+    path = args.path
+    config = None
+
+    # Determine what to run
+    if path:
+        path = Path(path)
+        if path.is_file() and path.suffix == ".py":
+            # Direct path to a Python file
+            entry_point = path
+            project_root = path.parent
+        elif path.is_dir():
+            # Directory - look for bootstack.toml
+            config_path = path / "bootstack.toml"
+            if not config_path.exists():
+                print(f"Error: No bootstack.toml found in '{path}'")
+                return
+            config = TtkbConfig.load(config_path)
+            entry_point = path / config.app.entry
+            project_root = path
+        else:
+            print(f"Error: '{path}' is not a valid file or directory")
+            return
+    else:
+        # No path specified - find bootstack.toml
+        config_path = find_config()
+        if config_path is None:
+            print("Error: No bootstack.toml found in current directory or parents.")
+            print("Run 'bootstack start <appname>' to create a new project.")
+            return
+
+        config = TtkbConfig.load(config_path)
+        project_root = config_path.parent
+        entry_point = project_root / config.app.entry
+
+    # Verify entry point exists
+    if not entry_point.exists():
+        print(f"Error: Entry point '{entry_point}' does not exist.")
+        return
+
+    print(f"Running {entry_point.relative_to(project_root)}...")
+    print()
+
+    # Run the application
+    # Add project src directory to PYTHONPATH
+    import os
+
+    src_dir = project_root / "src"
+    env = dict(os.environ)
+    python_path = env.get("PYTHONPATH", "")
+    if src_dir.exists():
+        if python_path:
+            env["PYTHONPATH"] = f"{src_dir}{os.pathsep}{python_path}"
+        else:
+            env["PYTHONPATH"] = str(src_dir)
+
+    # Pass theme from config so the app can pick it up
+    if config is not None and config.settings.theme:
+        env["BOOTSTACK_THEME"] = config.settings.theme
+
+    try:
+        result = subprocess.run(
+            [sys.executable, str(entry_point)],
+            cwd=str(project_root),
+            env=env,
+        )
+        sys.exit(result.returncode)
+    except KeyboardInterrupt:
+        print("\nInterrupted.")
+        sys.exit(1)

bootstack/cli/start.py

@@ -0,0 +1,105 @@
+"""bootstack start command - Create a new bootstack project."""
+
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+
+from bootstack.cli.templates import create_project
+
+
+def add_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add the 'start' subcommand parser."""
+    parser = subparsers.add_parser(
+        "start",
+        help="Create a new bootstack project",
+        description="Scaffold a new bootstack application with sensible defaults.",
+    )
+    parser.add_argument(
+        "name",
+        help="Application name (e.g., 'MyApp')",
+    )
+    parser.add_argument(
+        "--template",
+        choices=["basic", "appshell"],
+        default="basic",
+        help="Project template: 'basic' for single-view app, 'appshell' for sidebar navigation (default: basic)",
+    )
+    parser.add_argument(
+        "--simple",
+        action="store_true",
+        help="Create minimal project without assets or build configuration",
+    )
+    parser.add_argument(
+        "--container",
+        choices=["grid", "pack"],
+        default="grid",
+        help="Default container type for views (default: grid, ignored for appshell template)",
+    )
+    parser.add_argument(
+        "--theme",
+        default="bootstrap-light",
+        help="Theme name for the application (default: bootstrap-light)",
+    )
+    parser.add_argument(
+        "--dir",
+        type=Path,
+        default=None,
+        help="Target directory (default: ./<appname>)",
+    )
+    parser.set_defaults(func=run_start)
+
+
+def run_start(args: argparse.Namespace) -> None:
+    """Execute the start command."""
+    name = args.name
+    simple = args.simple
+    container = args.container
+    theme = args.theme
+    template = args.template
+
+    # Warn if --container is used with appshell (it's ignored)
+    if template == "appshell" and container != "grid":
+        print("Note: --container is ignored for appshell template.")
+
+    # Determine target directory
+    if args.dir:
+        target_dir = args.dir
+    else:
+        # Use lowercase name with underscores for directory
+        dir_name = name.lower().replace(" ", "_").replace("-", "_")
+        target_dir = Path.cwd() / dir_name
+
+    # Check if directory already exists and has content
+    if target_dir.exists() and any(target_dir.iterdir()):
+        print(f"Error: Directory '{target_dir}' already exists and is not empty.")
+        print("Choose a different name or remove the existing directory.")
+        return
+
+    # Create the project
+    print(f"Creating '{template}' project '{name}' in {target_dir}...")
+    create_project(
+        name=name,
+        target_dir=target_dir,
+        container=container,
+        theme=theme,
+        template=template,
+        simple=simple,
+    )
+
+    # Print success message
+    print()
+    print(f"Project '{name}' created successfully!")
+    print()
+    print("Next steps:")
+    print(f"  cd {target_dir.name}")
+    print("  bootstack run")
+    print()
+    if template == "appshell":
+        print("To add a new page:")
+        print("  bootstack add page DashboardPage")
+        print()
+    if not simple:
+        print("To build for distribution:")
+        print("  bootstack promote --pyinstaller")
+        print("  bootstack build")