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

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

@@ -2,6 +2,35 @@
 
 All notable changes to this project are documented in this file.
 
+## 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
+
+- 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.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.4
+Version: 0.1.6
 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
@@ -38,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.4`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.6`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -52,8 +53,9 @@ 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.
+- Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
 ## Installation
 
@@ -69,7 +71,9 @@ 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`.
 
 ### Install From Source
 
@@ -118,12 +122,22 @@ 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
+
+# Upgrade the fdev CLI from PyPI
+fdev upgrade
+
 # Check environment and optional tools
 fdev doctor
 
@@ -225,7 +239,11 @@ 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 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. |
@@ -355,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
@@ -373,7 +392,10 @@ 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 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.
 
 ## Troubleshooting
@@ -400,6 +422,17 @@ 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.
+
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.

{flutter_dev-0.1.4 → flutter_dev-0.1.6}/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.4`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.6`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -19,8 +19,9 @@ 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.
+- Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
 ## Installation
 
@@ -36,7 +37,9 @@ 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`.
 
 ### Install From Source
 
@@ -85,12 +88,22 @@ 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
+
+# Upgrade the fdev CLI from PyPI
+fdev upgrade
+
 # Check environment and optional tools
 fdev doctor
 
@@ -192,7 +205,11 @@ 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 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. |
@@ -322,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
@@ -340,7 +358,10 @@ 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 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.
 
 ## Troubleshooting
@@ -367,6 +388,17 @@ 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.
+
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.

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

@@ -70,11 +70,19 @@ from managers.brew import (
 from managers.git_account import (
     git_account_manager,
 )
+from managers.gui import (
+    launch_gui,
+)
+from managers.package import (
+    delete_fdev_command,
+    upgrade_fdev_command,
+)
 
 
-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 +122,9 @@ 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("  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")
     print("               Usage: fdev ai [groq|mistral|sambanova|openrouter]")
@@ -137,10 +148,13 @@ 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 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}")
     print(f"  {YELLOW}Multiple devices detected?{NC} Tool will prompt you to select one.")
-    sys.exit(1)
+    return exit_code
 
 
 def main():
@@ -151,10 +165,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()
@@ -250,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:
@@ -262,7 +285,7 @@ def main():
         git_account_manager(sys.argv[2:])
 
     else:
-        show_usage()
+        sys.exit(show_usage())
 
 
 if __name__ == "__main__":
@@ -272,4 +295,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.6}/flutter_dev.egg-info/SOURCES.txt

@@ -26,9 +26,14 @@ 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/package.py
 managers/project.py
 managers/web_deploy.py
-tests/test_localization.py
+tests/test_fdev_cli.py
+tests/test_gui.py
+tests/test_localization.py
+tests/test_package_commands.py