bootstack 0.1.0__py3-none-any.whl

bootstack/cli/pyinstaller.py

@@ -0,0 +1,268 @@
+"""PyInstaller spec file generation for bootstack projects."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from bootstack.cli.config import TtkbConfig
+
+
+# PyInstaller spec template that reads from bootstack.toml
+SPEC_TEMPLATE = '''\
+# -*- mode: python ; coding: utf-8 -*-
+"""
+PyInstaller spec file for {app_name}.
+
+This file is auto-generated by bootstack CLI.
+Edit bootstack.toml to change build settings, then regenerate with:
+    bootstack promote --pyinstaller --force
+"""
+
+import sys
+from pathlib import Path
+
+# PyInstaller exec's this spec with SPECPATH (directory of the .spec file)
+# in the namespace. __file__ is not defined inside a spec.
+PROJECT_ROOT = Path(SPECPATH).parent.parent
+CONFIG_PATH = PROJECT_ROOT / "bootstack.toml"
+
+# Ensure we can import bootstack CLI tools
+try:
+    from bootstack.cli.config import TtkbConfig
+except ImportError:
+    sys.path.insert(0, str(PROJECT_ROOT / "src"))
+    from bootstack.cli.config import TtkbConfig
+
+if not CONFIG_PATH.exists():
+    raise FileNotFoundError(f"bootstack.toml not found at {{CONFIG_PATH}}")
+
+config = TtkbConfig.load(CONFIG_PATH)
+
+# Extract settings
+APP_NAME = config.app.name
+ENTRY_POINT = PROJECT_ROOT / config.app.entry
+WINDOWED = config.build.windowed if config.build else True
+ONEFILE = config.build.onefile if config.build else False
+
+# Icon handling — resolve the icon for the platform this build runs on
+# (PyInstaller can't cross-compile, so we only need the host's format).
+_HOST_KEY = {{"win32": "windows", "darwin": "macos", "linux": "linux"}}.get(sys.platform)
+_HOST_EXT = {{"win32": ".ico", "darwin": ".icns"}}.get(sys.platform, ".png")
+
+ICON_PATH = None
+_icon_cfg = config.build.icon if config.build else None
+
+# A host-specific path (windows/macos/linux) wins over the generic path.
+_icon_path = None
+if _icon_cfg:
+    _host_specific = getattr(_icon_cfg, _HOST_KEY, None) if _HOST_KEY else None
+    _icon_path = _host_specific or _icon_cfg.path
+
+if _icon_path:
+    _candidate = PROJECT_ROOT / _icon_path
+    if _candidate.exists():
+        ICON_PATH = str(_candidate)
+elif _icon_cfg and _icon_cfg.glyph:
+    # Render the glyph into the host platform's icon format. No app runs during a
+    # build, so colors must be hex — a theme token cannot be resolved.
+    if not (_icon_cfg.background.startswith("#") and _icon_cfg.foreground.startswith("#")):
+        print(
+            "[build.icon] background/foreground must be hex colors (e.g. "
+            "'#0d6efd'); theme tokens need a running app. Using the default icon."
+        )
+    else:
+        try:
+            from bootstack.images import AppIcon
+            out = PROJECT_ROOT / "build" / ("app-icon" + _HOST_EXT)
+            out.parent.mkdir(parents=True, exist_ok=True)
+            AppIcon(
+                _icon_cfg.glyph,
+                background=_icon_cfg.background,
+                foreground=_icon_cfg.foreground,
+                radius=_icon_cfg.radius,
+                shape=_icon_cfg.shape,
+            ).save(str(out))
+            ICON_PATH = str(out)
+        except Exception as exc:
+            print(f"Could not generate app icon from glyph {{_icon_cfg.glyph!r}}: {{exc}}")
+
+if ICON_PATH is None:
+    # Fall back to the bundled bootstack launch icon. Override with [build.icon].
+    try:
+        import bootstack
+        default_icon = Path(bootstack.__file__).parent / "assets" / "bootstack.ico"
+        if default_icon.exists():
+            ICON_PATH = str(default_icon)
+    except Exception:
+        pass
+
+
+# =============================================================================
+# Collect data files
+# =============================================================================
+
+from glob import glob
+
+datas = []
+
+# Always include bootstack.toml
+datas.append((str(CONFIG_PATH), "."))
+
+# Include patterns from config
+if config.build and config.build.datas.include:
+    for pattern in config.build.datas.include:
+        if pattern == "bootstack.toml":
+            continue  # Already added
+        matches = glob(str(PROJECT_ROOT / pattern), recursive=True)
+        for match in matches:
+            match_path = Path(match)
+            if match_path.is_file():
+                rel_path = match_path.relative_to(PROJECT_ROOT)
+                dest_dir = str(rel_path.parent) if rel_path.parent != Path(".") else "."
+                datas.append((str(match_path), dest_dir))
+
+
+# =============================================================================
+# Collect package data (themes, fonts, icon glyphmaps, locales, etc.)
+# =============================================================================
+
+from PyInstaller.utils.hooks import collect_data_files, copy_metadata
+
+for _pkg in ("bootstack",):
+    try:
+        datas += collect_data_files(_pkg)
+        datas += copy_metadata(_pkg)
+    except Exception as _e:  # pragma: no cover
+        print(f"Warning: Could not collect data files from {{_pkg}}: {{_e}}")
+
+
+# =============================================================================
+# Hidden imports for bootstack
+# =============================================================================
+
+hiddenimports = [
+    "bootstack",
+    "bootstack.style",
+    "bootstack.widgets",
+    "PIL",
+    "PIL._tkinter_finder",
+    "babel.numbers",
+    "babel.dates",
+    "dateutil",
+    "dateparser",
+]
+# Extra hidden imports from [build] hidden_imports
+if config.build and config.build.hidden_imports:
+    hiddenimports += list(config.build.hidden_imports)
+
+# babel.bin is a CLI script package whose __init__.py calls exit(1) when
+# imported without args; PyInstaller's binary-dependency analyzer
+# imports it during package walking and crashes. Excluding it is safe
+# because nothing in a bootstack app uses babel's command-line tools.
+excludes = [
+    "babel.bin",
+]
+# Extra excludes from [build] excludes
+if config.build and config.build.excludes:
+    excludes += list(config.build.excludes)
+
+
+# =============================================================================
+# Analysis
+# =============================================================================
+
+a = Analysis(
+    [str(ENTRY_POINT)],
+    pathex=[str(PROJECT_ROOT / "src")],
+    binaries=[],
+    datas=datas,
+    hiddenimports=hiddenimports,
+    hookspath=[],
+    hooksconfig={{}},
+    runtime_hooks=[],
+    excludes=excludes,
+    noarchive=False,
+    optimize=0,
+)
+
+
+# =============================================================================
+# Build
+# =============================================================================
+
+pyz = PYZ(a.pure)
+
+if ONEFILE:
+    exe = EXE(
+        pyz,
+        a.scripts,
+        a.binaries,
+        a.datas,
+        [],
+        name=APP_NAME,
+        debug=False,
+        bootloader_ignore_signals=False,
+        strip=False,
+        upx=True,
+        upx_exclude=[],
+        runtime_tmpdir=None,
+        console=not WINDOWED,
+        disable_windowed_traceback=False,
+        argv_emulation=False,
+        target_arch=None,
+        codesign_identity=None,
+        entitlements_file=None,
+        icon=ICON_PATH,
+    )
+else:
+    exe = EXE(
+        pyz,
+        a.scripts,
+        [],
+        exclude_binaries=True,
+        name=APP_NAME,
+        debug=False,
+        bootloader_ignore_signals=False,
+        strip=False,
+        upx=True,
+        console=not WINDOWED,
+        disable_windowed_traceback=False,
+        argv_emulation=False,
+        target_arch=None,
+        codesign_identity=None,
+        entitlements_file=None,
+        icon=ICON_PATH,
+    )
+
+    coll = COLLECT(
+        exe,
+        a.binaries,
+        a.datas,
+        strip=False,
+        upx=True,
+        upx_exclude=[],
+        name=APP_NAME,
+    )
+'''
+
+
+def generate_spec(
+    config: TtkbConfig,
+    project_root: Path,
+    output_path: Path,
+) -> None:
+    """Generate a PyInstaller spec file.
+
+    Args:
+        config: The project configuration.
+        project_root: Root directory of the project.
+        output_path: Path to write the spec file.
+    """
+    content = SPEC_TEMPLATE.format(
+        app_name=config.app.name,
+    )
+
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(content, encoding="utf-8")

bootstack/cli/run.py

@@ -0,0 +1,95 @@
+"""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)
+
+    try:
+        result = subprocess.run(
+            [sys.executable, str(entry_point.resolve())],
+            cwd=str(project_root),
+            env=env,
+        )
+        sys.exit(result.returncode)
+    except KeyboardInterrupt:
+        print("\nInterrupted.")
+        sys.exit(1)

bootstack/cli/start.py

@@ -0,0 +1,117 @@
+"""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(
+        "--nav",
+        choices=["single", "grouped", "master-detail", "workspaces"],
+        default="single",
+        help="Navigation style for the appshell template (default: single, "
+             "ignored for the basic template)",
+    )
+    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
+    nav = args.nav
+
+    # Warn if --container is used with appshell (it's ignored)
+    if template == "appshell" and container != "grid":
+        print("Note: --container is ignored for appshell template.")
+    # Warn if --nav is used with the basic template (it's ignored)
+    if template == "basic" and nav != "single":
+        print("Note: --nav is ignored for the basic 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,
+        nav=nav,
+    )
+
+    # 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")