flutter-dev 0.1.4__tar.gz → 0.1.5__tar.gz

{flutter_dev-0.1.4 → flutter_dev-0.1.5}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.1.5 - 2026-06-24
+
+### Added
+
+- Added a Tkinter desktop dashboard that opens by running `fdev` with no command.
+- Added GUI live log output with ANSI terminal color rendering.
+- Added GUI buttons for all documented command groups, including mirror variants, AI provider shortcuts, and GitHub account subcommands.
+- Added Python coverage for GUI command catalog, ANSI color parsing, and no-command CLI dispatch.
+
+### Changed
+
+- Kept command help available through `fdev help`, `fdev --help`, and `fdev -h`.
+- Documented Tkinter requirements for the desktop dashboard.
+
 ## 0.1.4 - 2026-06-15
 
 ### Added

{flutter_dev-0.1.4 → flutter_dev-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.4
+Version: 0.1.5
 Summary: A cross-platform CLI toolkit for Flutter development workflows.
 Author: Royal Court BD
 License-Expression: MIT
@@ -22,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Utilities
 Requires-Python: >=3.8
@@ -41,7 +42,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.4`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.5`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -52,6 +53,7 @@ Current package metadata declares version `0.1.4`, Python `>=3.8`, MIT license,
 - AI-assisted Git commits using Groq, Mistral, SambaNova, or OpenRouter-compatible chat completion APIs.
 - Git workflow helpers for version tags, branch sync, deployment branch merge, discard, and GitHub account management through `gh`.
 - Feature/page generator that creates a `lib/features/<name>` structure using the project's presenter/base-state pattern.
+- Small Tkinter desktop dashboard opened by running `fdev` with no command, with live colored command logs.
 - Environment diagnostics through `fdev doctor`.
 - Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, and git diff prompt export.
 
@@ -71,6 +73,8 @@ fdev doctor
 
 `pip install flutter-dev` installs the Python package, Python dependencies, and console scripts. It does not install Flutter, Dart, Git, Android SDK tools, CocoaPods, Firebase CLI, GitHub CLI, `scrcpy`, Java/JDK, or VS Code CLI.
 
+The desktop dashboard uses Python Tkinter. Some Python distributions install this separately; for Homebrew Python, install the matching package such as `brew install python-tk@3.14`.
+
 ### Install From Source
 
 ```bash
@@ -118,12 +122,19 @@ Feature-specific external tools:
 | GitHub CLI / `gh` | `fdev git ...` |
 | VS Code CLI / `code` | Conflict helper in branch sync |
 | Homebrew | `brew`, macOS `install-scrcpy` flow |
+| Python Tkinter | Desktop dashboard opened by `fdev` |
 
 ## Quick Start
 
 Run commands from the root of a Flutter project when they need `pubspec.yaml`, Android Gradle files, iOS files, or build outputs.
 
 ```bash
+# Open the desktop dashboard
+fdev
+
+# Show command help
+fdev help
+
 # Check environment and optional tools
 fdev doctor
 
@@ -225,6 +236,8 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 
 | Command | Description |
 | --- | --- |
+| `fdev` | Opens a small Tkinter desktop dashboard for running `fdev` commands with live colored logs and command input. The terminal process stays running while the window is open. |
+| `fdev help` | Shows command help without opening the dashboard. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
 | `fdev ai` | Shows the current AI provider and opens an interactive provider switch prompt. |
 | `fdev ai <provider>` | Switches `DEFAULT_AI_SERVICE` to `groq`, `mistral`, `sambanova`, or `openrouter`. |
@@ -373,7 +386,8 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
 - `fdev clear-data` clears app data on Android after confirmation.
 - `fdev uninstall` may fall back to foreground app detection outside a Flutter project root.
-- `fdev` creates build output directories at startup in the current working directory.
+- `fdev` with no command opens the desktop dashboard. Use `fdev help` to print command usage.
+- Most command subcommands create build output directories at startup in the current working directory.
 - Some subcommands return failure internally without always mapping that failure to a non-zero process exit code, so automation should inspect command output carefully.
 
 ## Troubleshooting

{flutter_dev-0.1.4 → flutter_dev-0.1.5}/README.md

@@ -8,7 +8,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.4`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.5`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -19,6 +19,7 @@ Current package metadata declares version `0.1.4`, Python `>=3.8`, MIT license,
 - AI-assisted Git commits using Groq, Mistral, SambaNova, or OpenRouter-compatible chat completion APIs.
 - Git workflow helpers for version tags, branch sync, deployment branch merge, discard, and GitHub account management through `gh`.
 - Feature/page generator that creates a `lib/features/<name>` structure using the project's presenter/base-state pattern.
+- Small Tkinter desktop dashboard opened by running `fdev` with no command, with live colored command logs.
 - Environment diagnostics through `fdev doctor`.
 - Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, and git diff prompt export.
 
@@ -38,6 +39,8 @@ fdev doctor
 
 `pip install flutter-dev` installs the Python package, Python dependencies, and console scripts. It does not install Flutter, Dart, Git, Android SDK tools, CocoaPods, Firebase CLI, GitHub CLI, `scrcpy`, Java/JDK, or VS Code CLI.
 
+The desktop dashboard uses Python Tkinter. Some Python distributions install this separately; for Homebrew Python, install the matching package such as `brew install python-tk@3.14`.
+
 ### Install From Source
 
 ```bash
@@ -85,12 +88,19 @@ Feature-specific external tools:
 | GitHub CLI / `gh` | `fdev git ...` |
 | VS Code CLI / `code` | Conflict helper in branch sync |
 | Homebrew | `brew`, macOS `install-scrcpy` flow |
+| Python Tkinter | Desktop dashboard opened by `fdev` |
 
 ## Quick Start
 
 Run commands from the root of a Flutter project when they need `pubspec.yaml`, Android Gradle files, iOS files, or build outputs.
 
 ```bash
+# Open the desktop dashboard
+fdev
+
+# Show command help
+fdev help
+
 # Check environment and optional tools
 fdev doctor
 
@@ -192,6 +202,8 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 
 | Command | Description |
 | --- | --- |
+| `fdev` | Opens a small Tkinter desktop dashboard for running `fdev` commands with live colored logs and command input. The terminal process stays running while the window is open. |
+| `fdev help` | Shows command help without opening the dashboard. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
 | `fdev ai` | Shows the current AI provider and opens an interactive provider switch prompt. |
 | `fdev ai <provider>` | Switches `DEFAULT_AI_SERVICE` to `groq`, `mistral`, `sambanova`, or `openrouter`. |
@@ -340,7 +352,8 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
 - `fdev clear-data` clears app data on Android after confirmation.
 - `fdev uninstall` may fall back to foreground app detection outside a Flutter project root.
-- `fdev` creates build output directories at startup in the current working directory.
+- `fdev` with no command opens the desktop dashboard. Use `fdev help` to print command usage.
+- Most command subcommands create build output directories at startup in the current working directory.
 - Some subcommands return failure internally without always mapping that failure to a non-zero process exit code, so automation should inspect command output carefully.
 
 ## Troubleshooting

{flutter_dev-0.1.4 → flutter_dev-0.1.5}/fdev.py

@@ -70,11 +70,15 @@ from managers.brew import (
 from managers.git_account import (
     git_account_manager,
 )
+from managers.gui import (
+    launch_gui,
+)
 
 
-def show_usage():
+def show_usage(exit_code=1):
     """Show usage information"""
     print(f"{YELLOW}Usage: {sys.argv[0]} [command] [options]{NC}")
+    print(f"{BLUE}Run {GREEN}fdev{NC}{BLUE} without a command to open the desktop dashboard.{NC}")
     print(f"\n{BLUE}Build Commands:{NC}")
     print("  apk          Build release APK (Full Process)")
     print("  apk-split    Build APK with --split-per-abi")
@@ -114,6 +118,7 @@ def show_usage():
     print(f"\n{BLUE}Utility Commands:{NC}")
     print("  doctor       Check environment health (tools, deps, config)")
     print("  brew         Interactive Homebrew package manager")
+    print("  help         Show this help")
     print("  merge        Merge files from paths.txt into single output file")
     print("  ai           Show current AI service or switch to another")
     print("               Usage: fdev ai [groq|mistral|sambanova|openrouter]")
@@ -137,10 +142,11 @@ def show_usage():
     print(f"  {GREEN}fdev git config{NC}                # Update git user.name / user.email")
     print(f"  {GREEN}fdev arb-to-csv{NC}                # Export lib/l10n ARB files to translations.csv")
     print(f"  {GREEN}fdev csv-to-arb{NC}                # Generate lib/l10n ARB files from translations.csv")
+    print(f"  {GREEN}fdev{NC}                           # Open small desktop dashboard")
 
     print(f"\n{BLUE}Note:{NC}")
     print(f"  {YELLOW}Multiple devices detected?{NC} Tool will prompt you to select one.")
-    sys.exit(1)
+    return exit_code
 
 
 def main():
@@ -151,10 +157,13 @@ def main():
     os.makedirs("build/ios/ipa", exist_ok=True)
 
     if len(sys.argv) < 2:
-        show_usage()
+        return launch_gui()
 
     command = sys.argv[1].lower()
 
+    if command in ("help", "--help", "-h"):
+        return show_usage(exit_code=0)
+
     # Build commands
     if command == "apk":
         build_apk()
@@ -262,7 +271,7 @@ def main():
         git_account_manager(sys.argv[2:])
 
     else:
-        show_usage()
+        sys.exit(show_usage())
 
 
 if __name__ == "__main__":
@@ -272,4 +281,4 @@ if __name__ == "__main__":
         sys.exit(0)
 
     signal.signal(signal.SIGINT, signal_handler)
-    main()
+    sys.exit(main())

{flutter_dev-0.1.4 → flutter_dev-0.1.5}/flutter_dev.egg-info/SOURCES.txt

@@ -26,9 +26,12 @@ managers/device.py
 managers/doctor.py
 managers/git.py
 managers/git_account.py
+managers/gui.py
 managers/localization.py
 managers/merge.py
 managers/mirror.py
 managers/project.py
 managers/web_deploy.py
+tests/test_fdev_cli.py
+tests/test_gui.py
 tests/test_localization.py

flutter_dev-0.1.5/managers/gui.py

@@ -0,0 +1,531 @@
+#!/usr/bin/env python3
+"""
+Small Tkinter GUI for running fdev commands with live logs.
+"""
+
+from __future__ import annotations
+
+import shlex
+import subprocess
+import sys
+import threading
+import re
+from collections import OrderedDict
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Callable, Iterable, List, Optional
+
+
+ANSI_PATTERN = re.compile(r"\033\[([0-9;]*)m")
+
+ANSI_COLORS = {
+    30: "black",
+    31: "red",
+    32: "green",
+    33: "yellow",
+    34: "blue",
+    35: "magenta",
+    36: "cyan",
+    37: "white",
+    90: "bright_black",
+    91: "bright_red",
+    92: "bright_green",
+    93: "bright_yellow",
+    94: "bright_blue",
+    95: "bright_magenta",
+    96: "bright_cyan",
+    97: "bright_white",
+}
+
+
+def _apply_ansi_codes(codes: List[int], current_tag: Optional[str]) -> Optional[str]:
+    if not codes:
+        return None
+
+    tag = current_tag
+    bright = False
+
+    for code in codes:
+        if code == 0:
+            tag = None
+            bright = False
+        elif code == 1:
+            bright = True
+            if tag and not tag.startswith("bright_"):
+                tag = f"bright_{tag}"
+        elif code in ANSI_COLORS:
+            tag = ANSI_COLORS[code]
+            if bright and not tag.startswith("bright_"):
+                tag = f"bright_{tag}"
+
+    return tag
+
+
+def parse_ansi_segments(text: str, initial_tag: Optional[str] = None):
+    """Split ANSI-colored terminal text into Tkinter tag segments."""
+    segments = []
+    current_tag = initial_tag
+    position = 0
+
+    for match in ANSI_PATTERN.finditer(text):
+        if match.start() > position:
+            segments.append((text[position:match.start()], current_tag))
+
+        raw_codes = match.group(1)
+        codes = [int(code) for code in raw_codes.split(";") if code] if raw_codes else [0]
+        current_tag = _apply_ansi_codes(codes, current_tag)
+        position = match.end()
+
+    if position < len(text):
+        segments.append((text[position:], current_tag))
+
+    return segments, current_tag
+
+
+@dataclass(frozen=True)
+class GuiCommand:
+    """Command metadata displayed by the GUI."""
+
+    label: str
+    args: List[str]
+    description: str
+    argument_prompt: Optional[str] = None
+    confirm: bool = False
+
+    def resolve_args(self, extra_args_text: Optional[str] = None) -> List[str]:
+        """Return the full fdev argument list for this command."""
+        resolved = list(self.args)
+        if extra_args_text:
+            resolved.extend(shlex.split(extra_args_text))
+        return resolved
+
+
+def get_gui_sections():
+    """Return GUI sections and their fdev commands."""
+    return OrderedDict(
+        [
+            (
+                "Dashboard",
+                [
+                    GuiCommand("Doctor", ["doctor"], "Check environment, tools, devices, and config."),
+                    GuiCommand("AI Status", ["ai"], "Show and switch the active AI provider."),
+                    GuiCommand("GitHub Accounts", ["git", "status"], "Show GitHub CLI account status."),
+                ],
+            ),
+            (
+                "Build",
+                [
+                    GuiCommand("APK", ["apk"], "Build release APK."),
+                    GuiCommand("Split APK", ["apk-split"], "Build release APKs split per ABI."),
+                    GuiCommand("AAB", ["aab"], "Build Android App Bundle."),
+                    GuiCommand("IPA", ["ipa"], "Build iOS IPA on supported systems."),
+                    GuiCommand("Release Run", ["release-run"], "Build, install, and launch release APK."),
+                    GuiCommand("Web Deploy", ["web-deploy"], "Build Flutter web and deploy Firebase.", confirm=True),
+                ],
+            ),
+            (
+                "Project",
+                [
+                    GuiCommand("Setup", ["setup"], "Run full Flutter project setup.", confirm=True),
+                    GuiCommand("Cleanup", ["cleanup"], "Clean, fix, format, and upgrade dependencies.", confirm=True),
+                    GuiCommand("Generate L10n", ["lang"], "Run flutter gen-l10n."),
+                    GuiCommand("Build Runner", ["db"], "Run build_runner."),
+                    GuiCommand("Cache Repair", ["cache-repair"], "Repair Flutter pub cache.", confirm=True),
+                    GuiCommand("Pods", ["pod"], "Update iOS pods."),
+                    GuiCommand(
+                        "Create Page",
+                        ["page"],
+                        "Generate a Flutter feature/page structure.",
+                        argument_prompt="Page name, for example: user_profile",
+                        confirm=True,
+                    ),
+                    GuiCommand("ARB to CSV", ["arb-to-csv"], "Export lib/l10n ARB files to translations.csv."),
+                    GuiCommand("CSV to ARB", ["csv-to-arb"], "Generate ARB files from translations.csv.", confirm=True),
+                ],
+            ),
+            (
+                "Device",
+                [
+                    GuiCommand("Install APK", ["install"], "Install built APK on selected device."),
+                    GuiCommand("Uninstall", ["uninstall"], "Uninstall app from device.", confirm=True),
+                    GuiCommand("Clear Data", ["clear-data"], "Clear foreground app data.", confirm=True),
+                    GuiCommand("Install scrcpy", ["install-scrcpy"], "Install scrcpy if supported."),
+                    GuiCommand("Mirror", ["mirror"], "Launch Android screen mirror."),
+                    GuiCommand("Mirror Wireless", ["mirror", "--wireless"], "Set up wireless ADB mirroring."),
+                    GuiCommand("Mirror No Top", ["mirror", "--no-top"], "Mirror without always-on-top."),
+                    GuiCommand("Date Time", ["datetime"], "Open Date and Time settings on device."),
+                ],
+            ),
+            (
+                "Git",
+                [
+                    GuiCommand("Commit", ["commit"], "Generate AI commit message and commit.", confirm=True),
+                    GuiCommand("Tag", ["tag"], "Bump version, commit, tag, and push.", confirm=True),
+                    GuiCommand("Discard", ["discard"], "Discard tracked and untracked changes.", confirm=True),
+                    GuiCommand(
+                        "Sync Branches",
+                        ["sync"],
+                        "Sync current branch with named branches.",
+                        argument_prompt="Branch names separated by spaces, for example: dev main",
+                        confirm=True,
+                    ),
+                    GuiCommand("Deploy", ["deploy"], "Merge current branch into deployment.", confirm=True),
+                    GuiCommand("Git Manager", ["git"], "Open interactive GitHub account manager."),
+                    GuiCommand("Git Status", ["git", "status"], "Show GitHub CLI account status."),
+                    GuiCommand("Git List", ["git", "list"], "List GitHub CLI accounts."),
+                    GuiCommand(
+                        "Git Switch",
+                        ["git", "switch"],
+                        "Switch to a GitHub CLI account.",
+                        argument_prompt="GitHub username, for example: royalcourtbd",
+                    ),
+                    GuiCommand("Git Add", ["git", "add"], "Add a GitHub CLI account.", confirm=True),
+                    GuiCommand(
+                        "Git Remove",
+                        ["git", "remove"],
+                        "Remove a GitHub CLI account.",
+                        argument_prompt="GitHub username to remove",
+                        confirm=True,
+                    ),
+                    GuiCommand("Git Config", ["git", "config"], "Update git identity."),
+                ],
+            ),
+            (
+                "Tools",
+                [
+                    GuiCommand("Brew", ["brew"], "Open Homebrew package manager."),
+                    GuiCommand("Merge Files", ["merge"], "Merge paths listed in paths.txt."),
+                    GuiCommand(
+                        "AI Switch",
+                        ["ai"],
+                        "Switch AI provider.",
+                        argument_prompt="Provider: groq, mistral, sambanova, or openrouter",
+                    ),
+                    GuiCommand("AI Groq", ["ai", "groq"], "Switch AI provider to Groq."),
+                    GuiCommand("AI Mistral", ["ai", "mistral"], "Switch AI provider to Mistral."),
+                    GuiCommand("AI SambaNova", ["ai", "sambanova"], "Switch AI provider to SambaNova."),
+                    GuiCommand("AI OpenRouter", ["ai", "openrouter"], "Switch AI provider to OpenRouter."),
+                ],
+            ),
+        ]
+    )
+
+
+def build_fdev_command(args: Iterable[str]) -> List[str]:
+    """Build the subprocess command for invoking this repo's fdev entrypoint."""
+    repo_root = Path(__file__).resolve().parent.parent
+    return [sys.executable, str(repo_root / "fdev.py"), *list(args)]
+
+
+class GuiProcessRunner:
+    """Run one fdev subprocess and stream output to callbacks."""
+
+    def __init__(self):
+        self._process: Optional[subprocess.Popen] = None
+        self._reader_thread: Optional[threading.Thread] = None
+
+    @property
+    def is_running(self) -> bool:
+        return self._process is not None and self._process.poll() is None
+
+    def start(
+        self,
+        command: List[str],
+        on_output: Callable[[str], None],
+        on_exit: Callable[[int], None],
+    ) -> bool:
+        if self.is_running:
+            return False
+
+        self._process = subprocess.Popen(
+            command,
+            stdin=subprocess.PIPE,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            text=True,
+            encoding="utf-8",
+            errors="replace",
+            bufsize=1,
+        )
+
+        def read_output():
+            assert self._process is not None
+            assert self._process.stdout is not None
+            while True:
+                chunk = self._process.stdout.read(1)
+                if not chunk:
+                    break
+                on_output(chunk)
+            exit_code = self._process.wait()
+            on_exit(exit_code)
+
+        self._reader_thread = threading.Thread(target=read_output, daemon=True)
+        self._reader_thread.start()
+        return True
+
+    def send_input(self, text: str) -> bool:
+        if not self.is_running or self._process is None or self._process.stdin is None:
+            return False
+        try:
+            self._process.stdin.write(text + "\n")
+            self._process.stdin.flush()
+            return True
+        except (BrokenPipeError, OSError):
+            return False
+
+    def terminate(self) -> bool:
+        if not self.is_running or self._process is None:
+            return False
+        self._process.terminate()
+        return True
+
+
+class FdevGui:
+    """Tkinter mini dashboard for fdev commands."""
+
+    def __init__(self, root):
+        self.root = root
+        self.sections = get_gui_sections()
+        self.runner = GuiProcessRunner()
+        self.current_section = next(iter(self.sections))
+        self._ansi_buffer = ""
+        self._ansi_tag = None
+
+        self.root.title("fdev")
+        self.root.geometry("820x540")
+        self.root.minsize(720, 460)
+        self.root.protocol("WM_DELETE_WINDOW", self._on_close)
+
+        self._build_widgets()
+        self._show_section(self.current_section)
+
+    def _build_widgets(self):
+        import tkinter as tk
+        from tkinter import ttk
+
+        self.root.columnconfigure(1, weight=1)
+        self.root.rowconfigure(0, weight=1)
+
+        sidebar = ttk.Frame(self.root, padding=(10, 10))
+        sidebar.grid(row=0, column=0, sticky="ns")
+
+        title = ttk.Label(sidebar, text="fdev", font=("TkDefaultFont", 16, "bold"))
+        title.grid(row=0, column=0, sticky="w", pady=(0, 10))
+
+        for index, section_name in enumerate(self.sections, start=1):
+            button = ttk.Button(
+                sidebar,
+                text=section_name,
+                command=lambda name=section_name: self._show_section(name),
+            )
+            button.grid(row=index, column=0, sticky="ew", pady=3)
+
+        content = ttk.Frame(self.root, padding=(8, 10, 10, 10))
+        content.grid(row=0, column=1, sticky="nsew")
+        content.columnconfigure(0, weight=1)
+        content.rowconfigure(1, weight=1)
+
+        header = ttk.Frame(content)
+        header.grid(row=0, column=0, sticky="ew", pady=(0, 8))
+        header.columnconfigure(0, weight=1)
+
+        self.section_label = ttk.Label(header, text="", font=("TkDefaultFont", 14, "bold"))
+        self.section_label.grid(row=0, column=0, sticky="w")
+
+        self.status_label = ttk.Label(header, text="Ready")
+        self.status_label.grid(row=0, column=1, sticky="e")
+
+        body = ttk.PanedWindow(content, orient=tk.VERTICAL)
+        body.grid(row=1, column=0, sticky="nsew")
+
+        self.command_frame = ttk.Frame(body, padding=(0, 0, 0, 6))
+        self.command_frame.columnconfigure(0, weight=1)
+        self.command_frame.columnconfigure(1, weight=1)
+        body.add(self.command_frame, weight=2)
+
+        log_frame = ttk.Frame(body)
+        log_frame.columnconfigure(0, weight=1)
+        log_frame.rowconfigure(0, weight=1)
+        body.add(log_frame, weight=3)
+
+        self.log_text = tk.Text(
+            log_frame,
+            height=12,
+            wrap="word",
+            state="disabled",
+            bg="#111827",
+            fg="#e5e7eb",
+            insertbackground="#e5e7eb",
+        )
+        self.log_text.grid(row=0, column=0, sticky="nsew")
+
+        scrollbar = ttk.Scrollbar(log_frame, orient="vertical", command=self.log_text.yview)
+        scrollbar.grid(row=0, column=1, sticky="ns")
+        self.log_text.configure(yscrollcommand=scrollbar.set)
+        self._configure_log_tags()
+
+        input_bar = ttk.Frame(content)
+        input_bar.grid(row=2, column=0, sticky="ew", pady=(8, 0))
+        input_bar.columnconfigure(0, weight=1)
+
+        self.input_entry = ttk.Entry(input_bar)
+        self.input_entry.grid(row=0, column=0, sticky="ew", padx=(0, 6))
+        self.input_entry.bind("<Return>", lambda _event: self._send_input())
+
+        ttk.Button(input_bar, text="Send Input", command=self._send_input).grid(row=0, column=1, padx=(0, 6))
+        ttk.Button(input_bar, text="Stop", command=self._stop_process).grid(row=0, column=2, padx=(0, 6))
+        ttk.Button(input_bar, text="Clear", command=self._clear_log).grid(row=0, column=3)
+
+    def _show_section(self, section_name: str):
+        from tkinter import ttk
+
+        self.current_section = section_name
+        self.section_label.configure(text=section_name)
+
+        for child in self.command_frame.winfo_children():
+            child.destroy()
+
+        for index, command in enumerate(self.sections[section_name]):
+            row = index // 2
+            column = index % 2
+
+            container = ttk.Frame(self.command_frame, padding=6)
+            container.grid(row=row, column=column, sticky="nsew", padx=4, pady=4)
+            container.columnconfigure(0, weight=1)
+
+            button = ttk.Button(
+                container,
+                text=command.label,
+                command=lambda item=command: self._run_command(item),
+            )
+            button.grid(row=0, column=0, sticky="ew")
+
+            description = ttk.Label(container, text=command.description, wraplength=260)
+            description.grid(row=1, column=0, sticky="w", pady=(4, 0))
+
+    def _run_command(self, command: GuiCommand):
+        from tkinter import messagebox, simpledialog
+
+        if self.runner.is_running:
+            messagebox.showwarning("fdev", "A command is already running.")
+            return
+
+        extra_args_text = None
+        if command.argument_prompt:
+            extra_args_text = simpledialog.askstring(command.label, command.argument_prompt, parent=self.root)
+            if extra_args_text is None:
+                return
+
+        args = command.resolve_args(extra_args_text)
+
+        if command.confirm:
+            display = "fdev " + " ".join(args)
+            if not messagebox.askyesno("Confirm command", f"Run this command?\n\n{display}"):
+                return
+
+        subprocess_command = build_fdev_command(args)
+        self._append_log("\n$ fdev " + " ".join(args) + "\n")
+        self.status_label.configure(text="Running: " + command.label)
+
+        started = self.runner.start(
+            subprocess_command,
+            on_output=lambda text: self.root.after(0, self._append_log, text),
+            on_exit=lambda code: self.root.after(0, self._command_finished, code),
+        )
+        if not started:
+            messagebox.showwarning("fdev", "Could not start command.")
+
+    def _append_log(self, text: str):
+        self._ansi_buffer += text
+        safe_text = self._ansi_buffer
+
+        last_escape = safe_text.rfind("\033")
+        if last_escape != -1 and "m" not in safe_text[last_escape:]:
+            self._ansi_buffer = safe_text[last_escape:]
+            safe_text = safe_text[:last_escape]
+        else:
+            self._ansi_buffer = ""
+
+        if not safe_text:
+            return
+
+        segments, self._ansi_tag = parse_ansi_segments(safe_text, self._ansi_tag)
+
+        self.log_text.configure(state="normal")
+        for segment, tag in segments:
+            if tag:
+                self.log_text.insert("end", segment, tag)
+            else:
+                self.log_text.insert("end", segment)
+        self.log_text.see("end")
+        self.log_text.configure(state="disabled")
+
+    def _configure_log_tags(self):
+        self.log_text.tag_configure("black", foreground="#111827")
+        self.log_text.tag_configure("red", foreground="#ff6b6b")
+        self.log_text.tag_configure("green", foreground="#35d07f")
+        self.log_text.tag_configure("yellow", foreground="#f2d14f")
+        self.log_text.tag_configure("blue", foreground="#4da3ff")
+        self.log_text.tag_configure("magenta", foreground="#d38cff")
+        self.log_text.tag_configure("cyan", foreground="#4dd0e1")
+        self.log_text.tag_configure("white", foreground="#f8fafc")
+        self.log_text.tag_configure("bright_black", foreground="#94a3b8")
+        self.log_text.tag_configure("bright_red", foreground="#ff8787")
+        self.log_text.tag_configure("bright_green", foreground="#69e6a3")
+        self.log_text.tag_configure("bright_yellow", foreground="#f4e409")
+        self.log_text.tag_configure("bright_blue", foreground="#74b9ff")
+        self.log_text.tag_configure("bright_magenta", foreground="#e0aaff")
+        self.log_text.tag_configure("bright_cyan", foreground="#67e8f9")
+        self.log_text.tag_configure("bright_white", foreground="#ffffff")
+
+    def _clear_log(self):
+        self._ansi_buffer = ""
+        self._ansi_tag = None
+        self.log_text.configure(state="normal")
+        self.log_text.delete("1.0", "end")
+        self.log_text.configure(state="disabled")
+
+    def _send_input(self):
+        text = self.input_entry.get()
+        if not text:
+            return
+        if self.runner.send_input(text):
+            self._append_log("> " + text + "\n")
+            self.input_entry.delete(0, "end")
+        else:
+            self._append_log("[fdev] No running command can receive input.\n")
+
+    def _stop_process(self):
+        if self.runner.terminate():
+            self._append_log("[fdev] Stop requested.\n")
+
+    def _command_finished(self, exit_code: int):
+        self.status_label.configure(text=f"Finished: exit {exit_code}")
+        self._append_log(f"[fdev] Command finished with exit code {exit_code}.\n")
+
+    def _on_close(self):
+        from tkinter import messagebox
+
+        if self.runner.is_running:
+            if not messagebox.askyesno("fdev", "A command is still running. Stop it and close?"):
+                return
+            self.runner.terminate()
+        self.root.destroy()
+
+    def run(self):
+        self.root.mainloop()
+
+
+def launch_gui() -> int:
+    """Launch the fdev Tkinter dashboard."""
+    try:
+        import tkinter as tk
+    except ImportError:
+        print("Tkinter is not available in this Python installation.")
+        print("Install a Python build that includes Tkinter, then run: fdev")
+        return 1
+
+    root = tk.Tk()
+    app = FdevGui(root)
+    app.run()
+    return 0

{flutter_dev-0.1.4 → flutter_dev-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flutter-dev"
-version = "0.1.4"
+version = "0.1.5"
 description = "A cross-platform CLI toolkit for Flutter development workflows."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -28,6 +28,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: Build Tools",
   "Topic :: Utilities"
 ]

flutter_dev-0.1.5/tests/test_fdev_cli.py

@@ -0,0 +1,43 @@
+import sys
+import unittest
+from unittest.mock import patch
+
+import fdev
+
+
+class FdevCliTests(unittest.TestCase):
+    def test_no_command_launches_gui(self):
+        with patch.object(sys, "argv", ["fdev"]), patch.object(fdev, "launch_gui", return_value=0) as launch_gui:
+            result = fdev.main()
+
+        self.assertEqual(result, 0)
+        launch_gui.assert_called_once_with()
+
+    def test_help_command_prints_usage_without_launching_gui(self):
+        with (
+            patch.object(sys, "argv", ["fdev", "help"]),
+            patch.object(fdev, "launch_gui", return_value=0) as launch_gui,
+            patch.object(fdev, "show_usage", return_value=0) as show_usage,
+        ):
+            result = fdev.main()
+
+        self.assertEqual(result, 0)
+        show_usage.assert_called_once_with(exit_code=0)
+        launch_gui.assert_not_called()
+
+    def test_gui_subcommand_is_not_the_dashboard_entrypoint(self):
+        with (
+            patch.object(sys, "argv", ["fdev", "gui"]),
+            patch.object(fdev, "launch_gui", return_value=0) as launch_gui,
+            patch.object(fdev, "show_usage", return_value=1) as show_usage,
+        ):
+            with self.assertRaises(SystemExit) as raised:
+                fdev.main()
+
+        self.assertEqual(raised.exception.code, 1)
+        show_usage.assert_called_once_with()
+        launch_gui.assert_not_called()
+
+
+if __name__ == "__main__":
+    unittest.main()

flutter_dev-0.1.5/tests/test_gui.py

@@ -0,0 +1,145 @@
+import sys
+import unittest
+from pathlib import Path
+
+from managers.gui import (
+    GuiCommand,
+    parse_ansi_segments,
+    build_fdev_command,
+    get_gui_sections,
+)
+
+
+class GuiCatalogTests(unittest.TestCase):
+    def test_gui_sections_include_core_fdev_workflows(self):
+        sections = get_gui_sections()
+
+        self.assertIn("Dashboard", sections)
+        self.assertIn("Build", sections)
+        self.assertIn("Project", sections)
+        self.assertIn("Device", sections)
+        self.assertIn("Git", sections)
+        self.assertIn("Tools", sections)
+
+        dashboard_commands = [command.args for command in sections["Dashboard"]]
+        build_commands = [command.args for command in sections["Build"]]
+        device_commands = [command.args for command in sections["Device"]]
+
+        self.assertIn(["doctor"], dashboard_commands)
+        self.assertIn(["apk"], build_commands)
+        self.assertIn(["aab"], build_commands)
+        self.assertIn(["mirror"], device_commands)
+        self.assertIn(["clear-data"], device_commands)
+
+    def test_commands_that_need_user_arguments_are_marked(self):
+        sections = get_gui_sections()
+        all_commands = [
+            command
+            for commands in sections.values()
+            for command in commands
+        ]
+
+        commands_by_label = {command.label: command for command in all_commands}
+
+        self.assertTrue(commands_by_label["Create Page"].argument_prompt)
+        self.assertTrue(commands_by_label["Sync Branches"].argument_prompt)
+        self.assertTrue(commands_by_label["AI Switch"].argument_prompt)
+        self.assertTrue(commands_by_label["Git Switch"].argument_prompt)
+        self.assertTrue(commands_by_label["Git Remove"].argument_prompt)
+
+    def test_gui_catalog_covers_usage_commands_and_common_variants(self):
+        sections = get_gui_sections()
+        actual_args = {
+            tuple(command.args)
+            for commands in sections.values()
+            for command in commands
+        }
+
+        expected_args = {
+            ("apk",),
+            ("apk-split",),
+            ("aab",),
+            ("ipa",),
+            ("release-run",),
+            ("web-deploy",),
+            ("lang",),
+            ("db",),
+            ("setup",),
+            ("cleanup",),
+            ("cache-repair",),
+            ("page",),
+            ("arb-to-csv",),
+            ("csv-to-arb",),
+            ("install",),
+            ("uninstall",),
+            ("clear-data",),
+            ("install-scrcpy",),
+            ("mirror",),
+            ("mirror", "--wireless"),
+            ("mirror", "--no-top"),
+            ("datetime",),
+            ("pod",),
+            ("tag",),
+            ("commit",),
+            ("discard",),
+            ("sync",),
+            ("deploy",),
+            ("doctor",),
+            ("brew",),
+            ("merge",),
+            ("ai",),
+            ("ai", "groq"),
+            ("ai", "mistral"),
+            ("ai", "sambanova"),
+            ("ai", "openrouter"),
+            ("git",),
+            ("git", "status"),
+            ("git", "list"),
+            ("git", "switch"),
+            ("git", "add"),
+            ("git", "remove"),
+            ("git", "config"),
+        }
+
+        self.assertTrue(expected_args.issubset(actual_args), expected_args - actual_args)
+
+    def test_ansi_segments_convert_terminal_colors_to_gui_tags(self):
+        segments, final_tag = parse_ansi_segments(
+            "\033[0;34mTitle\033[0m plain \033[1;33mwarn\033[0m \033[0;31merror\033[0m"
+        )
+
+        self.assertEqual(
+            segments,
+            [
+                ("Title", "blue"),
+                (" plain ", None),
+                ("warn", "bright_yellow"),
+                (" ", None),
+                ("error", "red"),
+            ],
+        )
+        self.assertIsNone(final_tag)
+
+    def test_build_fdev_command_uses_current_python_and_repo_fdev_entrypoint(self):
+        command = build_fdev_command(["doctor"])
+
+        self.assertEqual(command[0], sys.executable)
+        self.assertEqual(Path(command[1]).name, "fdev.py")
+        self.assertEqual(command[2:], ["doctor"])
+
+    def test_gui_command_combines_base_args_and_extra_args(self):
+        gui_command = GuiCommand(
+            label="Sync Branches",
+            args=["sync"],
+            description="Sync branches",
+            argument_prompt="Branch names",
+        )
+
+        self.assertEqual(
+            gui_command.resolve_args("dev main"),
+            ["sync", "dev", "main"],
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()