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

flutter_dev-0.1.5/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+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
+
+- Added `fdev arb-to-csv` to export Flutter ARB localization files from `lib/l10n` into `translations.csv` by default.
+- Added `fdev csv-to-arb` to generate `app_<locale>.arb` files into `lib/l10n` from `translations.csv` by default.
+- Added Python regression coverage for ARB/CSV conversion, locale parsing, default paths, and ARB metadata preservation.
+
+### Changed
+
+- Documented the ARB/CSV localization workflow in the README command reference and quick-start examples.
+
+## 0.1.3 - 2026-06-08
+
+### Fixed
+
+- Fixed CocoaPods command execution for `fdev pod` and `fdev ipa` so pod subcommands keep their arguments on macOS and Linux.
+
+## 0.1.2 - 2026-06-07
+
+### Changed
+
+- Bumped package version to 0.1.2.
+
+## 0.1.1 - 2026-05-19
+
+### Added
+
+- Added `fdev install-scrcpy` for platform-specific scrcpy installation.
+- Added prompt-based scrcpy installation when `fdev mirror` cannot find `scrcpy`.
+- Added PyPI Trusted Publishing workflow and package metadata.
+- Added `CHANGELOG.md` release history.
+
+### Changed
+
+- Updated `fdev doctor` to suggest `fdev install-scrcpy` when scrcpy is missing.
+- Updated package author and license branding to Royal Court BD.
+- Updated package repository URLs to `royalcourtbd/flutter-development-tools`.
+
+### Fixed
+
+- Prevented private `.env` files from being included in package artifacts.
+- Made PyPI console scripts safer by removing import-time side effects.
+
+## 0.1.0 - 2026-05-18
+
+### Added
+
+- Initial public PyPI package setup for Flutter Development Tools.
+- Added console scripts for `fdev`, `create-page`, `gemini-api`, and `git-diff-editor`.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.2
+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,16 +42,18 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.1`, 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
 
 - Flutter build automation for APK, split APK, AAB, IPA, release install, and Firebase web deploy.
 - Project maintenance helpers for `flutter clean`, dependency refresh, `build_runner`, localization generation, analysis, formatting, cache repair, and CocoaPods.
+- Localization CSV helpers for exporting ARB files to translator-friendly CSV files and generating ARB files back from CSV.
 - Android device helpers for APK install, app uninstall, foreground app data clearing, screen mirroring with `scrcpy`, wireless ADB setup, and Date & Time settings.
 - 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.
 
@@ -70,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
@@ -117,18 +122,31 @@ 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
 
 # Generate localization files
 fdev lang
 
+# Export ARB translations from lib/l10n to translations.csv
+fdev arb-to-csv
+
+# Generate ARB files in lib/l10n from translations.csv
+fdev csv-to-arb
+
 # Run build_runner
 fdev db
 
@@ -167,6 +185,8 @@ Android APK/AAB build commands rename output files using the Android app label a
 | `fdev setup` | Runs clean, dependency upgrade, `build_runner`, localization generation, another dependency upgrade, `flutter analyze`, and `dart format .`. |
 | `fdev cleanup` | Runs clean, pub get, `dart fix --apply`, `dart format .`, and `flutter pub upgrade --major-versions`. |
 | `fdev lang` | Runs `flutter gen-l10n`. |
+| `fdev arb-to-csv` | Exports `lib/l10n/*.arb` into `translations.csv` by default. Use `-d/--directory` and `-o/--output` to override paths. |
+| `fdev csv-to-arb` | Generates `app_<locale>.arb` files into `lib/l10n` from `translations.csv` by default. Use `-i/--input` and `-o/--output-dir` to override paths. |
 | `fdev db` | Runs `dart run build_runner build --delete-conflicting-outputs`. |
 | `fdev cache-repair` | Runs `flutter pub cache repair`. |
 | `fdev pod` | Updates CocoaPods from the `ios/` directory after removing `Podfile.lock` when present. |
@@ -216,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`. |
@@ -364,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
@@ -450,6 +473,7 @@ For local packaging checks:
 
 ```bash
 python -m pip install --upgrade build twine
+rm -rf dist build flutter_dev.egg-info
 python -m build
 python -m twine check dist/*
 ```

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

@@ -8,16 +8,18 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.1`, 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
 
 - Flutter build automation for APK, split APK, AAB, IPA, release install, and Firebase web deploy.
 - Project maintenance helpers for `flutter clean`, dependency refresh, `build_runner`, localization generation, analysis, formatting, cache repair, and CocoaPods.
+- Localization CSV helpers for exporting ARB files to translator-friendly CSV files and generating ARB files back from CSV.
 - Android device helpers for APK install, app uninstall, foreground app data clearing, screen mirroring with `scrcpy`, wireless ADB setup, and Date & Time settings.
 - 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.
 
@@ -37,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
@@ -84,18 +88,31 @@ 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
 
 # Generate localization files
 fdev lang
 
+# Export ARB translations from lib/l10n to translations.csv
+fdev arb-to-csv
+
+# Generate ARB files in lib/l10n from translations.csv
+fdev csv-to-arb
+
 # Run build_runner
 fdev db
 
@@ -134,6 +151,8 @@ Android APK/AAB build commands rename output files using the Android app label a
 | `fdev setup` | Runs clean, dependency upgrade, `build_runner`, localization generation, another dependency upgrade, `flutter analyze`, and `dart format .`. |
 | `fdev cleanup` | Runs clean, pub get, `dart fix --apply`, `dart format .`, and `flutter pub upgrade --major-versions`. |
 | `fdev lang` | Runs `flutter gen-l10n`. |
+| `fdev arb-to-csv` | Exports `lib/l10n/*.arb` into `translations.csv` by default. Use `-d/--directory` and `-o/--output` to override paths. |
+| `fdev csv-to-arb` | Generates `app_<locale>.arb` files into `lib/l10n` from `translations.csv` by default. Use `-i/--input` and `-o/--output-dir` to override paths. |
 | `fdev db` | Runs `dart run build_runner build --delete-conflicting-outputs`. |
 | `fdev cache-repair` | Runs `flutter pub cache repair`. |
 | `fdev pod` | Updates CocoaPods from the `ios/` directory after removing `Podfile.lock` when present. |
@@ -183,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`. |
@@ -331,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
@@ -417,6 +439,7 @@ For local packaging checks:
 
 ```bash
 python -m pip install --upgrade build twine
+rm -rf dist build flutter_dev.egg-info
 python -m build
 python -m twine check dist/*
 ```

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

@@ -47,6 +47,10 @@ from managers.mirror import (
 from managers.merge import (
     merge_files,
 )
+from managers.localization import (
+    arb_to_csv_command,
+    csv_to_arb_command,
+)
 from managers.ai import (
     show_ai_status,
     switch_ai_service,
@@ -66,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")
@@ -86,6 +94,8 @@ def show_usage():
     print("  cleanup      Clean project and get dependencies")
     print("  cache-repair Repair pub cache")
     print("  page         Create page structure (usage: fdev page <page_name>)")
+    print("  arb-to-csv   Export ARB localization files to CSV")
+    print("  csv-to-arb   Generate ARB localization files from CSV")
 
     print(f"\n{BLUE}Device Commands:{NC}")
     print("  install      Install built APK on connected device")
@@ -108,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]")
@@ -129,10 +140,13 @@ def show_usage():
     print(f"  {GREEN}fdev git{NC}                       # Interactive GitHub account manager")
     print(f"  {GREEN}fdev git switch royalcourtbd{NC}   # Switch to a specific GH account")
     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():
@@ -143,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()
@@ -172,6 +189,10 @@ def main():
         repair_cache()
     elif command == "cleanup":
         cleanup_project()
+    elif command == "arb-to-csv":
+        sys.exit(arb_to_csv_command(sys.argv[2:]))
+    elif command == "csv-to-arb":
+        sys.exit(csv_to_arb_command(sys.argv[2:]))
 
     # Device commands
     elif command == "install":
@@ -250,7 +271,7 @@ def main():
         git_account_manager(sys.argv[2:])
 
     else:
-        show_usage()
+        sys.exit(show_usage())
 
 
 if __name__ == "__main__":
@@ -260,4 +281,4 @@ if __name__ == "__main__":
         sys.exit(0)
 
     signal.signal(signal.SIGINT, signal_handler)
-    main()
+    sys.exit(main())

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

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

{flutter_dev-0.1.2 → flutter_dev-0.1.5}/managers/build.py

@@ -56,7 +56,7 @@ def run_flutter_command(cmd_list, description, env=None):
         env: Optional environment variables dict (default: inherits current env)
     """
     # Windows compatibility for shell commands
-    shell_needed = (is_windows() and cmd_list[0] in ['timeout', 'start', 'flutter', 'dart']) or cmd_list[0] == 'pod'
+    shell_needed = is_windows() and cmd_list[0] in ['timeout', 'start', 'flutter', 'dart']
 
     process = subprocess.Popen(
         cmd_list,