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

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

@@ -2,6 +2,28 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.1.7 - 2026-06-25
+
+### Fixed
+
+- Reworked the Tkinter dashboard to use classic Tk widgets with explicit colors so `fdev` stays visible on macOS Xcode/system Python runtimes that can render `ttk` widgets as a blank popup.
+- Silenced the macOS system Tk deprecation warning before launching the dashboard.
+
+## 0.1.6 - 2026-06-25
+
+### Added
+
+- Added `fdev upgrade` to update the local `flutter-dev` package from PyPI after detecting the current OS.
+- Added `fdev delete` to uninstall the local `flutter-dev` package after detecting the current OS and confirming the destructive action.
+
+### Changed
+
+- `fdev upgrade` and `fdev delete` now print the exact Python executable they target before running `sys.executable -m pip`.
+
+### Fixed
+
+- Reworked the Tkinter dashboard layout to avoid platform-sensitive paned-window sizing that could open a blank `fdev` popup after installing from PyPI.
+
 ## 0.1.5 - 2026-06-24
 
 ### Added

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.5
+Version: 0.1.7
 Summary: A cross-platform CLI toolkit for Flutter development workflows.
 Author: Royal Court BD
 License-Expression: MIT
@@ -39,10 +39,10 @@ Dynamic: license-file
 The package is published on PyPI as `flutter-dev` and installs console commands for day-to-day Flutter work:
 
 ```bash
-pip install flutter-dev
+python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.5`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.7`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -55,7 +55,7 @@ Current package metadata declares version `0.1.5`, Python `>=3.8`, MIT license,
 - 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.
+- Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
 ## Installation
 
@@ -71,7 +71,7 @@ Verify the CLI is available:
 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.
+`python -m pip install flutter-dev` installs the Python package, Python dependencies, and console scripts into the Python environment selected by `python`. 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`.
 
@@ -135,6 +135,9 @@ fdev
 # Show command help
 fdev help
 
+# Upgrade the fdev CLI from PyPI
+fdev upgrade
+
 # Check environment and optional tools
 fdev doctor
 
@@ -239,6 +242,8 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 | `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 upgrade` | Detects the OS, then upgrades the active Python environment's `flutter-dev` package from PyPI with `python -m pip install --upgrade flutter-dev`. |
+| `fdev delete` | Detects the OS, asks for confirmation, then uninstalls the active Python environment's `flutter-dev` package. Use `fdev delete --yes` to skip confirmation. |
 | `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`. |
 | `fdev brew` | Interactive Homebrew package manager for viewing packages, uninstalling with cleanup, clearing cache, and global cleanup. |
@@ -368,6 +373,7 @@ managers/mirror.py      scrcpy install, mirror, wireless ADB setup
 managers/git.py         commit, tag, discard, branch sync, deployment merge
 managers/git_account.py GitHub account manager around gh CLI
 managers/doctor.py      Environment diagnostics
+managers/package.py     PyPI self-upgrade and local uninstall commands
 managers/ai.py          AI provider status and switching
 managers/brew.py        Interactive Homebrew manager
 managers/merge.py       paths.txt to path_merge_files.txt merger
@@ -386,6 +392,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 upgrade` and `fdev delete` manage the local `flutter-dev` Python package, not the Flutter app on a device.
+- `fdev delete` removes the `fdev` command from the current Python environment after confirmation; reinstall with `python -m pip install flutter-dev`.
 - `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.
@@ -414,6 +422,27 @@ On Windows, use:
 where fdev
 ```
 
+### Upgrade Or Remove fdev
+
+Use the built-in package management commands from the Python environment where `fdev` is installed:
+
+```bash
+fdev upgrade
+fdev delete
+```
+
+Both commands print the detected OS and exact Python executable before running. They use that executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`, so the active venv/global Python that launched `fdev` is the environment that gets upgraded or deleted. On Windows, `fdev delete` and `fdev upgrade` schedule the same `sys.executable -m pip ...` operation in a delayed command process so the currently running console launcher can exit first.
+
+### Blank Dashboard On macOS
+
+If `fdev` prints an Xcode/system Tk warning or opens a blank dashboard, upgrade to `flutter-dev` 0.1.7 or newer:
+
+```bash
+fdev upgrade
+```
+
+`fdev` prints the Python executable it is using. If that path is `/Applications/Xcode.app/Contents/Developer/usr/bin/python3`, the CLI is running on Xcode's bundled Python and system Tk; 0.1.7 uses a more conservative Tk UI path for that runtime.
+
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.

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

@@ -5,10 +5,10 @@
 The package is published on PyPI as `flutter-dev` and installs console commands for day-to-day Flutter work:
 
 ```bash
-pip install flutter-dev
+python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.5`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.7`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -21,7 +21,7 @@ Current package metadata declares version `0.1.5`, Python `>=3.8`, MIT license,
 - 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.
+- Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
 ## Installation
 
@@ -37,7 +37,7 @@ Verify the CLI is available:
 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.
+`python -m pip install flutter-dev` installs the Python package, Python dependencies, and console scripts into the Python environment selected by `python`. 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`.
 
@@ -101,6 +101,9 @@ fdev
 # Show command help
 fdev help
 
+# Upgrade the fdev CLI from PyPI
+fdev upgrade
+
 # Check environment and optional tools
 fdev doctor
 
@@ -205,6 +208,8 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 | `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 upgrade` | Detects the OS, then upgrades the active Python environment's `flutter-dev` package from PyPI with `python -m pip install --upgrade flutter-dev`. |
+| `fdev delete` | Detects the OS, asks for confirmation, then uninstalls the active Python environment's `flutter-dev` package. Use `fdev delete --yes` to skip confirmation. |
 | `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`. |
 | `fdev brew` | Interactive Homebrew package manager for viewing packages, uninstalling with cleanup, clearing cache, and global cleanup. |
@@ -334,6 +339,7 @@ managers/mirror.py      scrcpy install, mirror, wireless ADB setup
 managers/git.py         commit, tag, discard, branch sync, deployment merge
 managers/git_account.py GitHub account manager around gh CLI
 managers/doctor.py      Environment diagnostics
+managers/package.py     PyPI self-upgrade and local uninstall commands
 managers/ai.py          AI provider status and switching
 managers/brew.py        Interactive Homebrew manager
 managers/merge.py       paths.txt to path_merge_files.txt merger
@@ -352,6 +358,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 upgrade` and `fdev delete` manage the local `flutter-dev` Python package, not the Flutter app on a device.
+- `fdev delete` removes the `fdev` command from the current Python environment after confirmation; reinstall with `python -m pip install flutter-dev`.
 - `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.
@@ -380,6 +388,27 @@ On Windows, use:
 where fdev
 ```
 
+### Upgrade Or Remove fdev
+
+Use the built-in package management commands from the Python environment where `fdev` is installed:
+
+```bash
+fdev upgrade
+fdev delete
+```
+
+Both commands print the detected OS and exact Python executable before running. They use that executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`, so the active venv/global Python that launched `fdev` is the environment that gets upgraded or deleted. On Windows, `fdev delete` and `fdev upgrade` schedule the same `sys.executable -m pip ...` operation in a delayed command process so the currently running console launcher can exit first.
+
+### Blank Dashboard On macOS
+
+If `fdev` prints an Xcode/system Tk warning or opens a blank dashboard, upgrade to `flutter-dev` 0.1.7 or newer:
+
+```bash
+fdev upgrade
+```
+
+`fdev` prints the Python executable it is using. If that path is `/Applications/Xcode.app/Contents/Developer/usr/bin/python3`, the CLI is running on Xcode's bundled Python and system Tk; 0.1.7 uses a more conservative Tk UI path for that runtime.
+
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.

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

@@ -73,6 +73,10 @@ from managers.git_account import (
 from managers.gui import (
     launch_gui,
 )
+from managers.package import (
+    delete_fdev_command,
+    upgrade_fdev_command,
+)
 
 
 def show_usage(exit_code=1):
@@ -118,6 +122,8 @@ def show_usage(exit_code=1):
     print(f"\n{BLUE}Utility Commands:{NC}")
     print("  doctor       Check environment health (tools, deps, config)")
     print("  brew         Interactive Homebrew package manager")
+    print("  upgrade      Upgrade fdev from PyPI")
+    print("  delete       Uninstall fdev from this computer")
     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")
@@ -142,6 +148,8 @@ def show_usage(exit_code=1):
     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 upgrade{NC}                   # Upgrade flutter-dev from PyPI")
+    print(f"  {GREEN}fdev delete{NC}                    # Remove flutter-dev/fdev from this computer")
     print(f"  {GREEN}fdev{NC}                           # Open small desktop dashboard")
 
     print(f"\n{BLUE}Note:{NC}")
@@ -259,6 +267,12 @@ def main():
     elif command == "brew":
         brew_manager()
 
+    # Package self-management commands
+    elif command == "upgrade":
+        sys.exit(upgrade_fdev_command(sys.argv[2:]))
+    elif command == "delete":
+        sys.exit(delete_fdev_command(sys.argv[2:]))
+
     # AI command
     elif command == "ai":
         if len(sys.argv) < 3:

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

@@ -30,8 +30,10 @@ managers/gui.py
 managers/localization.py
 managers/merge.py
 managers/mirror.py
+managers/package.py
 managers/project.py
 managers/web_deploy.py
 tests/test_fdev_cli.py
 tests/test_gui.py
-tests/test_localization.py
+tests/test_localization.py
+tests/test_package_commands.py

{flutter_dev-0.1.5 → flutter_dev-0.1.7}/managers/gui.py

@@ -5,6 +5,7 @@ Small Tkinter GUI for running fdev commands with live logs.
 
 from __future__ import annotations
 
+import os
 import shlex
 import subprocess
 import sys
@@ -37,6 +38,21 @@ ANSI_COLORS = {
     97: "bright_white",
 }
 
+UI_BG = "#f8fafc"
+SIDEBAR_BG = "#e5e7eb"
+PANEL_BG = "#ffffff"
+TEXT_FG = "#111827"
+MUTED_FG = "#475569"
+BUTTON_BG = "#e2e8f0"
+BUTTON_ACTIVE_BG = "#cbd5e1"
+LOG_BG = "#111827"
+LOG_FG = "#e5e7eb"
+
+
+def prepare_tk_environment():
+    """Prepare Tk for older macOS system Tk runtimes before importing tkinter."""
+    os.environ.setdefault("TK_SILENCE_DEPRECATION", "1")
+
 
 def _apply_ansi_codes(codes: List[int], current_tag: Optional[str]) -> Optional[str]:
     if not codes:
@@ -194,6 +210,8 @@ def get_gui_sections():
                 "Tools",
                 [
                     GuiCommand("Brew", ["brew"], "Open Homebrew package manager."),
+                    GuiCommand("Upgrade fdev", ["upgrade"], "Upgrade flutter-dev from PyPI."),
+                    GuiCommand("Delete fdev", ["delete"], "Uninstall flutter-dev from this computer.", confirm=True),
                     GuiCommand("Merge Files", ["merge"], "Merge paths listed in paths.txt."),
                     GuiCommand(
                         "AI Switch",
@@ -301,83 +319,127 @@ class FdevGui:
 
     def _build_widgets(self):
         import tkinter as tk
-        from tkinter import ttk
+
+        self.root.configure(bg=UI_BG)
 
         self.root.columnconfigure(1, weight=1)
         self.root.rowconfigure(0, weight=1)
 
-        sidebar = ttk.Frame(self.root, padding=(10, 10))
+        sidebar = tk.Frame(self.root, bg=SIDEBAR_BG, padx=10, pady=10)
         sidebar.grid(row=0, column=0, sticky="ns")
 
-        title = ttk.Label(sidebar, text="fdev", font=("TkDefaultFont", 16, "bold"))
+        title = tk.Label(
+            sidebar,
+            text="fdev",
+            font=("TkDefaultFont", 16, "bold"),
+            bg=SIDEBAR_BG,
+            fg=TEXT_FG,
+        )
         title.grid(row=0, column=0, sticky="w", pady=(0, 10))
 
         for index, section_name in enumerate(self.sections, start=1):
-            button = ttk.Button(
+            button = tk.Button(
                 sidebar,
                 text=section_name,
                 command=lambda name=section_name: self._show_section(name),
+                bg=BUTTON_BG,
+                fg=TEXT_FG,
+                activebackground=BUTTON_ACTIVE_BG,
+                activeforeground=TEXT_FG,
+                relief="raised",
+                bd=1,
+                padx=10,
+                pady=4,
             )
             button.grid(row=index, column=0, sticky="ew", pady=3)
 
-        content = ttk.Frame(self.root, padding=(8, 10, 10, 10))
+        content = tk.Frame(self.root, bg=UI_BG, padx=8, pady=10)
         content.grid(row=0, column=1, sticky="nsew")
         content.columnconfigure(0, weight=1)
         content.rowconfigure(1, weight=1)
 
-        header = ttk.Frame(content)
+        header = tk.Frame(content, bg=UI_BG)
         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 = tk.Label(
+            header,
+            text="",
+            font=("TkDefaultFont", 14, "bold"),
+            bg=UI_BG,
+            fg=TEXT_FG,
+        )
         self.section_label.grid(row=0, column=0, sticky="w")
 
-        self.status_label = ttk.Label(header, text="Ready")
+        self.status_label = tk.Label(header, text="Ready", bg=UI_BG, fg=MUTED_FG)
         self.status_label.grid(row=0, column=1, sticky="e")
 
-        body = ttk.PanedWindow(content, orient=tk.VERTICAL)
+        body = tk.Frame(content, bg=UI_BG)
         body.grid(row=1, column=0, sticky="nsew")
+        body.columnconfigure(0, weight=1)
+        body.rowconfigure(0, weight=0)
+        body.rowconfigure(1, weight=1)
 
-        self.command_frame = ttk.Frame(body, padding=(0, 0, 0, 6))
+        self.command_frame = tk.Frame(body, bg=UI_BG, pady=6)
+        self.command_frame.grid(row=0, column=0, sticky="ew")
         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 = tk.Frame(body, bg=UI_BG)
+        log_frame.grid(row=1, column=0, sticky="nsew", pady=(6, 0))
         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",
+            bg=LOG_BG,
+            fg=LOG_FG,
+            insertbackground=LOG_FG,
+            relief="sunken",
+            bd=1,
         )
         self.log_text.grid(row=0, column=0, sticky="nsew")
 
-        scrollbar = ttk.Scrollbar(log_frame, orient="vertical", command=self.log_text.yview)
+        scrollbar = tk.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 = tk.Frame(content, bg=UI_BG)
         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 = tk.Entry(input_bar, bg=PANEL_BG, fg=TEXT_FG, insertbackground=TEXT_FG)
         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)
+        tk.Button(
+            input_bar,
+            text="Send Input",
+            command=self._send_input,
+            bg=BUTTON_BG,
+            activebackground=BUTTON_ACTIVE_BG,
+        ).grid(row=0, column=1, padx=(0, 6))
+        tk.Button(
+            input_bar,
+            text="Stop",
+            command=self._stop_process,
+            bg=BUTTON_BG,
+            activebackground=BUTTON_ACTIVE_BG,
+        ).grid(row=0, column=2, padx=(0, 6))
+        tk.Button(
+            input_bar,
+            text="Clear",
+            command=self._clear_log,
+            bg=BUTTON_BG,
+            activebackground=BUTTON_ACTIVE_BG,
+        ).grid(row=0, column=3)
 
     def _show_section(self, section_name: str):
-        from tkinter import ttk
+        import tkinter as tk
 
         self.current_section = section_name
         self.section_label.configure(text=section_name)
@@ -389,18 +451,41 @@ class FdevGui:
             row = index // 2
             column = index % 2
 
-            container = ttk.Frame(self.command_frame, padding=6)
+            container = tk.Frame(
+                self.command_frame,
+                bg=PANEL_BG,
+                bd=1,
+                relief="solid",
+                padx=6,
+                pady=6,
+            )
             container.grid(row=row, column=column, sticky="nsew", padx=4, pady=4)
             container.columnconfigure(0, weight=1)
 
-            button = ttk.Button(
+            button = tk.Button(
                 container,
                 text=command.label,
                 command=lambda item=command: self._run_command(item),
+                bg=BUTTON_BG,
+                fg=TEXT_FG,
+                activebackground=BUTTON_ACTIVE_BG,
+                activeforeground=TEXT_FG,
+                relief="raised",
+                bd=1,
+                padx=8,
+                pady=4,
             )
             button.grid(row=0, column=0, sticky="ew")
 
-            description = ttk.Label(container, text=command.description, wraplength=260)
+            description = tk.Label(
+                container,
+                text=command.description,
+                wraplength=260,
+                bg=PANEL_BG,
+                fg=MUTED_FG,
+                justify="left",
+                anchor="w",
+            )
             description.grid(row=1, column=0, sticky="w", pady=(4, 0))
 
     def _run_command(self, command: GuiCommand):
@@ -518,6 +603,7 @@ class FdevGui:
 
 def launch_gui() -> int:
     """Launch the fdev Tkinter dashboard."""
+    prepare_tk_environment()
     try:
         import tkinter as tk
     except ImportError:

flutter_dev-0.1.7/managers/package.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""
+Package Manager - self-management commands for the installed fdev package.
+"""
+
+import argparse
+import platform
+import subprocess
+import sys
+
+from common_utils import BLUE, GREEN, RED, YELLOW, NC
+
+PACKAGE_NAME = "flutter-dev"
+
+
+def get_os_info():
+    """
+    Detect the operating system before package self-management actions.
+    Returns a tuple of (key, display_name).
+    """
+    system = platform.system()
+
+    if system == "Darwin":
+        return "macos", "macOS"
+    if system == "Linux":
+        return "linux", "Linux"
+    if system == "Windows":
+        return "windows", "Windows"
+
+    return "unknown", system or "Unknown"
+
+
+def _print_os_info(os_name):
+    print(f"{BLUE}Detected OS: {GREEN}{os_name}{NC}")
+
+
+def _print_python_environment():
+    print(f"{BLUE}Python environment: {GREEN}{sys.executable}{NC}")
+
+
+def _build_pip_command(pip_args):
+    return [sys.executable, "-m", "pip", *pip_args]
+
+
+def _run_pip_direct(pip_args):
+    result = subprocess.run(_build_pip_command(pip_args))
+    return result.returncode
+
+
+def _build_windows_detached_command(pip_args):
+    pip_command = subprocess.list2cmdline(_build_pip_command(pip_args))
+    delayed_command = f"timeout /t 2 /nobreak > nul & {pip_command}"
+    return [
+        "cmd",
+        "/c",
+        "start",
+        "fdev package command",
+        "cmd",
+        "/c",
+        delayed_command,
+    ]
+
+
+def _run_windows_detached(pip_args, action_label):
+    command = _build_windows_detached_command(pip_args)
+    creationflags = (
+        getattr(subprocess, "CREATE_NEW_PROCESS_GROUP", 0)
+        | getattr(subprocess, "DETACHED_PROCESS", 0)
+    )
+    subprocess.Popen(command, creationflags=creationflags)
+    print(f"{YELLOW}{action_label} has been scheduled in a new Windows command process.{NC}")
+    print(f"{YELLOW}Close this terminal after the command starts, then open a new one.{NC}")
+    return 0
+
+
+def _confirm_delete():
+    print(f"{RED}This will uninstall the local {PACKAGE_NAME} package and remove the fdev command.{NC}")
+    answer = input(f"Delete {GREEN}{PACKAGE_NAME}{NC} from this Python environment? (y/N): ")
+    return answer.strip().lower() == "y"
+
+
+def _delete_parser():
+    parser = argparse.ArgumentParser(
+        prog="fdev delete",
+        description="Uninstall the local flutter-dev package that provides fdev.",
+    )
+    parser.add_argument(
+        "-y",
+        "--yes",
+        action="store_true",
+        help="Skip confirmation and uninstall flutter-dev.",
+    )
+    return parser
+
+
+def _upgrade_parser():
+    return argparse.ArgumentParser(
+        prog="fdev upgrade",
+        description="Upgrade the local flutter-dev package from PyPI.",
+    )
+
+
+def delete_fdev_command(argv=None):
+    """Uninstall the local flutter-dev package from the active Python environment."""
+    args = _delete_parser().parse_args(argv)
+    os_key, os_name = get_os_info()
+    _print_os_info(os_name)
+    _print_python_environment()
+
+    if not args.yes and not _confirm_delete():
+        print(f"{YELLOW}Operation cancelled.{NC}")
+        return 1
+
+    pip_args = ["uninstall", "-y", PACKAGE_NAME]
+    print(f"{YELLOW}Uninstalling {PACKAGE_NAME} from the current Python environment...{NC}")
+
+    if os_key == "windows":
+        return _run_windows_detached(pip_args, "Uninstall")
+
+    result = _run_pip_direct(pip_args)
+    if result == 0:
+        print(f"{GREEN}✓ {PACKAGE_NAME} uninstalled successfully.{NC}")
+        print(f"{BLUE}Install again with: {GREEN}python -m pip install {PACKAGE_NAME}{NC}")
+    else:
+        print(f"{RED}✗ Failed to uninstall {PACKAGE_NAME}.{NC}")
+    return result
+
+
+def upgrade_fdev_command(argv=None):
+    """Upgrade the local flutter-dev package from PyPI in the active environment."""
+    _upgrade_parser().parse_args(argv)
+    os_key, os_name = get_os_info()
+    _print_os_info(os_name)
+    _print_python_environment()
+
+    pip_args = ["install", "--upgrade", PACKAGE_NAME]
+    print(f"{YELLOW}Upgrading {PACKAGE_NAME} from PyPI...{NC}")
+
+    if os_key == "windows":
+        return _run_windows_detached(pip_args, "Upgrade")
+
+    result = _run_pip_direct(pip_args)
+    if result == 0:
+        print(f"{GREEN}✓ {PACKAGE_NAME} upgraded successfully.{NC}")
+        print(f"{BLUE}Restart your terminal if the fdev command still uses the old version.{NC}")
+    else:
+        print(f"{RED}✗ Failed to upgrade {PACKAGE_NAME}.{NC}")
+    return result

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flutter-dev"
-version = "0.1.5"
+version = "0.1.7"
 description = "A cross-platform CLI toolkit for Flutter development workflows."
 readme = "README.md"
 requires-python = ">=3.8"

{flutter_dev-0.1.5 → flutter_dev-0.1.7}/tests/test_fdev_cli.py

@@ -38,6 +38,28 @@ class FdevCliTests(unittest.TestCase):
         show_usage.assert_called_once_with()
         launch_gui.assert_not_called()
 
+    def test_delete_command_routes_to_package_delete(self):
+        with (
+            patch.object(sys, "argv", ["fdev", "delete", "--yes"]),
+            patch.object(fdev, "delete_fdev_command", return_value=0) as delete_command,
+        ):
+            with self.assertRaises(SystemExit) as raised:
+                fdev.main()
+
+        self.assertEqual(raised.exception.code, 0)
+        delete_command.assert_called_once_with(["--yes"])
+
+    def test_upgrade_command_routes_to_package_upgrade(self):
+        with (
+            patch.object(sys, "argv", ["fdev", "upgrade"]),
+            patch.object(fdev, "upgrade_fdev_command", return_value=0) as upgrade_command,
+        ):
+            with self.assertRaises(SystemExit) as raised:
+                fdev.main()
+
+        self.assertEqual(raised.exception.code, 0)
+        upgrade_command.assert_called_once_with([])
+
 
 if __name__ == "__main__":
     unittest.main()

{flutter_dev-0.1.5 → flutter_dev-0.1.7}/tests/test_gui.py

@@ -1,9 +1,13 @@
 import sys
 import unittest
 from pathlib import Path
+from tkinter import TclError
+from unittest.mock import patch
 
 from managers.gui import (
+    FdevGui,
     GuiCommand,
+    prepare_tk_environment,
     parse_ansi_segments,
     build_fdev_command,
     get_gui_sections,
@@ -86,6 +90,8 @@ class GuiCatalogTests(unittest.TestCase):
             ("deploy",),
             ("doctor",),
             ("brew",),
+            ("upgrade",),
+            ("delete",),
             ("merge",),
             ("ai",),
             ("ai", "groq"),
@@ -140,6 +146,102 @@ class GuiCatalogTests(unittest.TestCase):
             ["sync", "dev", "main"],
         )
 
+    def test_prepare_tk_environment_silences_macos_system_tk_warning(self):
+        with patch.dict("os.environ", {}, clear=True):
+            prepare_tk_environment()
+
+            import os
+
+            self.assertEqual(os.environ["TK_SILENCE_DEPRECATION"], "1")
+
+    def test_dashboard_uses_stable_grid_layout_without_paned_window(self):
+        try:
+            import tkinter as tk
+        except ImportError:
+            self.skipTest("Tkinter is not available")
+
+        try:
+            root = tk.Tk()
+        except TclError as error:
+            self.skipTest(f"Tk display is not available: {error}")
+
+        try:
+            app = FdevGui(root)
+            root.update_idletasks()
+
+            widget_classes = {
+                widget.winfo_class()
+                for widget in _walk_widgets(root)
+            }
+
+            self.assertNotIn("TPanedwindow", widget_classes)
+            self.assertEqual(app.section_label.cget("text"), "Dashboard")
+            self.assertGreaterEqual(len(app.command_frame.winfo_children()), 3)
+            self.assertGreater(app.command_frame.winfo_width(), 100)
+            self.assertGreater(app.log_text.winfo_width(), 100)
+        finally:
+            root.destroy()
+
+    def test_dashboard_maps_initial_widgets_after_mainloop_starts(self):
+        try:
+            import tkinter as tk
+        except ImportError:
+            self.skipTest("Tkinter is not available")
+
+        try:
+            root = tk.Tk()
+        except TclError as error:
+            self.skipTest(f"Tk display is not available: {error}")
+
+        try:
+            app = FdevGui(root)
+            root.after(10, root.quit)
+            app.run()
+
+            self.assertTrue(app.command_frame.winfo_ismapped())
+            self.assertTrue(app.log_text.winfo_ismapped())
+            self.assertGreater(app.command_frame.winfo_width(), 100)
+            self.assertGreater(app.log_text.winfo_width(), 100)
+        finally:
+            root.destroy()
+
+    def test_dashboard_uses_classic_tk_widgets_for_system_tk_compatibility(self):
+        try:
+            import tkinter as tk
+        except ImportError:
+            self.skipTest("Tkinter is not available")
+
+        try:
+            root = tk.Tk()
+        except TclError as error:
+            self.skipTest(f"Tk display is not available: {error}")
+
+        try:
+            app = FdevGui(root)
+            root.update_idletasks()
+
+            widget_classes = {
+                widget.winfo_class()
+                for widget in _walk_widgets(root)
+            }
+
+            self.assertFalse(
+                {"TButton", "TEntry", "TFrame", "TLabel", "TScrollbar"} & widget_classes
+            )
+            self.assertIn("Button", widget_classes)
+            self.assertIn("Label", widget_classes)
+            self.assertIn("Entry", widget_classes)
+            self.assertIn("Scrollbar", widget_classes)
+            self.assertGreater(app.command_frame.winfo_width(), 100)
+        finally:
+            root.destroy()
+
+
+def _walk_widgets(widget):
+    yield widget
+    for child in widget.winfo_children():
+        yield from _walk_widgets(child)
+
 
 if __name__ == "__main__":
     unittest.main()

flutter_dev-0.1.7/tests/test_package_commands.py

@@ -0,0 +1,129 @@
+import io
+import subprocess
+import unittest
+from contextlib import redirect_stdout
+from unittest.mock import patch
+
+from managers import package
+
+
+class PackageCommandTests(unittest.TestCase):
+    def test_delete_yes_runs_pip_uninstall_in_current_python_environment(self):
+        completed = subprocess.CompletedProcess(
+            ["/venv/bin/python", "-m", "pip", "uninstall", "-y", "flutter-dev"],
+            0,
+        )
+
+        with (
+            patch.object(package.platform, "system", return_value="Darwin"),
+            patch.object(package.sys, "executable", "/venv/bin/python"),
+            patch.object(package.subprocess, "run", return_value=completed) as run,
+        ):
+            result = package.delete_fdev_command(["--yes"])
+
+        self.assertEqual(result, 0)
+        run.assert_called_once_with(
+            ["/venv/bin/python", "-m", "pip", "uninstall", "-y", "flutter-dev"]
+        )
+
+    def test_delete_cancelled_by_user_does_not_run_pip(self):
+        with (
+            patch.object(package.platform, "system", return_value="Linux"),
+            patch("builtins.input", return_value="n"),
+            patch.object(package.subprocess, "run") as run,
+        ):
+            result = package.delete_fdev_command([])
+
+        self.assertEqual(result, 1)
+        run.assert_not_called()
+
+    def test_upgrade_runs_pip_upgrade_in_current_python_environment(self):
+        completed = subprocess.CompletedProcess(
+            ["/venv/bin/python", "-m", "pip", "install", "--upgrade", "flutter-dev"],
+            0,
+        )
+
+        with (
+            patch.object(package.platform, "system", return_value="Linux"),
+            patch.object(package.sys, "executable", "/venv/bin/python"),
+            patch.object(package.subprocess, "run", return_value=completed) as run,
+        ):
+            result = package.upgrade_fdev_command([])
+
+        self.assertEqual(result, 0)
+        run.assert_called_once_with(
+            ["/venv/bin/python", "-m", "pip", "install", "--upgrade", "flutter-dev"]
+        )
+
+    def test_windows_delete_schedules_detached_uninstall(self):
+        with (
+            patch.object(package.platform, "system", return_value="Windows"),
+            patch.object(package.sys, "executable", r"C:\Python\python.exe"),
+            patch.object(package.subprocess, "Popen") as popen,
+        ):
+            result = package.delete_fdev_command(["--yes"])
+
+        self.assertEqual(result, 0)
+        popen.assert_called_once()
+        command = popen.call_args.args[0]
+        self.assertEqual(command[0], "cmd")
+        joined_command = " ".join(command)
+        self.assertIn("uninstall", joined_command)
+        self.assertIn("flutter-dev", joined_command)
+
+    def test_windows_detached_command_quotes_python_paths_with_spaces(self):
+        with patch.object(package.sys, "executable", r"C:\Program Files\Python312\python.exe"):
+            command = package._build_windows_detached_command(["install", "--upgrade", "flutter-dev"])
+
+        self.assertEqual(command[:3], ["cmd", "/c", "start"])
+        self.assertEqual(command[3], "fdev package command")
+        self.assertEqual(command[4:6], ["cmd", "/c"])
+        self.assertIn('"C:\\Program Files\\Python312\\python.exe"', command[6])
+        self.assertIn("-m pip install --upgrade flutter-dev", command[6])
+
+    def test_linux_delete_uses_running_python_not_python3_or_pip3(self):
+        completed = subprocess.CompletedProcess(
+            ["/home/user/project/.venv/bin/python", "-m", "pip", "uninstall", "-y", "flutter-dev"],
+            0,
+        )
+
+        with (
+            patch.object(package.platform, "system", return_value="Linux"),
+            patch.object(package.sys, "executable", "/home/user/project/.venv/bin/python"),
+            patch.object(package.subprocess, "run", return_value=completed) as run,
+        ):
+            result = package.delete_fdev_command(["--yes"])
+
+        self.assertEqual(result, 0)
+        run.assert_called_once_with(
+            ["/home/user/project/.venv/bin/python", "-m", "pip", "uninstall", "-y", "flutter-dev"]
+        )
+
+    def test_upgrade_prints_target_python_environment(self):
+        completed = subprocess.CompletedProcess(
+            ["/home/user/project/.venv/bin/python", "-m", "pip", "install", "--upgrade", "flutter-dev"],
+            0,
+        )
+        output = io.StringIO()
+
+        with (
+            patch.object(package.platform, "system", return_value="Linux"),
+            patch.object(package.sys, "executable", "/home/user/project/.venv/bin/python"),
+            patch.object(package.subprocess, "run", return_value=completed),
+            redirect_stdout(output),
+        ):
+            result = package.upgrade_fdev_command([])
+
+        self.assertEqual(result, 0)
+        self.assertIn("Python environment:", output.getvalue())
+        self.assertIn("/home/user/project/.venv/bin/python", output.getvalue())
+
+    def test_command_help_returns_zero(self):
+        with self.assertRaises(SystemExit) as raised:
+            package.delete_fdev_command(["--help"])
+
+        self.assertEqual(raised.exception.code, 0)
+
+
+if __name__ == "__main__":
+    unittest.main()