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

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

@@ -2,6 +2,13 @@
 
 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.6
+Version: 0.1.7
 Summary: A cross-platform CLI toolkit for Flutter development workflows.
 Author: Royal Court BD
 License-Expression: MIT
@@ -42,7 +42,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.6`, 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
 
@@ -433,6 +433,16 @@ 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.6 → flutter_dev-0.1.7}/README.md

@@ -8,7 +8,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.6`, 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
 
@@ -399,6 +399,16 @@ 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.6 → 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:
@@ -303,52 +319,73 @@ 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.Frame(content)
+        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)
 
-        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)
@@ -358,31 +395,51 @@ class FdevGui:
             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)
@@ -394,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):
@@ -523,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.6 → flutter_dev-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flutter-dev"
-version = "0.1.6"
+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.6 → flutter_dev-0.1.7}/tests/test_gui.py

@@ -2,10 +2,12 @@ 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,
@@ -144,6 +146,14 @@ 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
@@ -172,6 +182,60 @@ class GuiCatalogTests(unittest.TestCase):
         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