flutter-dev 0.1.10__tar.gz → 0.1.12__tar.gz

{flutter_dev-0.1.10 → flutter_dev-0.1.12}/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.1.12 - 2026-07-22
+
+### Changed
+
+- Updated the PyPI workflow to use Node.js 24-native `actions/upload-artifact@v7`.
+
+### Fixed
+
+- Fixed `fdev clear-data` to verify that the current project app is installed before clearing it, and to fall back to a confirmed foreground-app clear when the project app is missing or the direct clear fails.
+
+## 0.1.11 - 2026-07-22
+
+### Added
+
+- Added Python regression coverage for project-root and outside-project `fdev clear-data` behavior.
+
+### Changed
+
+- Changed `fdev clear-data` to target the current project's Android package without confirmation when run from a Flutter project root, matching `fdev uninstall`; outside a project it still confirms before clearing the foreground app.
+- Updated the PyPI publishing workflow to run on pushes to the `deployment` branch as well as manual dispatches.
+
 ## 0.1.10 - 2026-07-16
 
 ### Added

{flutter_dev-0.1.10 → flutter_dev-0.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.10
+Version: 0.1.12
 Summary: A cross-platform CLI toolkit for Flutter development workflows.
 Author: Royal Court BD
 License-Expression: MIT
@@ -42,14 +42,14 @@ 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.10`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.12`, 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.
+- Android device helpers for APK install, app uninstall, project/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.
@@ -201,7 +201,7 @@ Android APK/AAB build commands rename output files using the Android app label a
 | --- | --- |
 | `fdev install` | Installs a built APK from `build/app/outputs/flutter-apk`, prefers `arm64-v8a`, retries after uninstall on failure, then launches the app. |
 | `fdev uninstall` | In a Flutter project root, uninstalls by package/bundle id. Outside a project, detects the foreground app and asks for confirmation. |
-| `fdev clear-data` | Detects the foreground app and runs `adb shell pm clear <package>` on Android. Confirmation is skipped when it matches the current Flutter project; otherwise the default-Yes safety prompt is shown. iOS prints manual options. |
+| `fdev clear-data` | In a Flutter project root, clears the installed project's Android package data without confirmation; if it is missing or the clear fails, falls back to the foreground app with a default-Yes safety prompt. Outside a project, always detects and confirms the foreground app. iOS prints manual options. |
 | `fdev install-scrcpy` | Installs `scrcpy` using the best supported package manager for the current platform. |
 | `fdev mirror` | Launches `scrcpy` for a selected Android device. |
 | `fdev mirror --wireless` | Guides wireless ADB setup using a USB-connected Android device. |
@@ -390,7 +390,7 @@ core/constants.py       Shared regex patterns, paths, and build command constant
 core/state.py           Selected Android device state
 managers/build.py       APK/AAB/IPA/release-run build workflow
 managers/project.py     setup, cleanup, lang, db, pod, cache repair
-managers/app.py         install, uninstall, foreground app data clearing
+managers/app.py         install, uninstall, project/foreground app data clearing
 managers/device.py      ADB device detection and selection
 managers/mirror.py      scrcpy install, mirror, wireless ADB setup
 managers/git.py         commit, tag, discard, branch sync, deployment merge
@@ -413,7 +413,7 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev tag` updates `pubspec.yaml`, creates a commit, creates a Git tag, and pushes both.
 - `fdev discard` removes tracked changes and untracked files after confirmation.
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
-- `fdev clear-data` skips confirmation only when the foreground Android app matches the current Flutter project's package ID; otherwise it uses a default-Yes `[Y/n]` confirmation.
+- `fdev clear-data` clears the installed current project's Android package without confirmation when run from a Flutter project root. If that package is missing or cannot be cleared, and whenever the command runs outside a project, it targets the foreground app after a default-Yes `[Y/n]` 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 upgrade` reports the installed version and location before upgrading, then shows the before→after version when the active process can verify it immediately.

{flutter_dev-0.1.10 → flutter_dev-0.1.12}/README.md

@@ -8,14 +8,14 @@ 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.10`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.12`, 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.
+- Android device helpers for APK install, app uninstall, project/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.
@@ -167,7 +167,7 @@ Android APK/AAB build commands rename output files using the Android app label a
 | --- | --- |
 | `fdev install` | Installs a built APK from `build/app/outputs/flutter-apk`, prefers `arm64-v8a`, retries after uninstall on failure, then launches the app. |
 | `fdev uninstall` | In a Flutter project root, uninstalls by package/bundle id. Outside a project, detects the foreground app and asks for confirmation. |
-| `fdev clear-data` | Detects the foreground app and runs `adb shell pm clear <package>` on Android. Confirmation is skipped when it matches the current Flutter project; otherwise the default-Yes safety prompt is shown. iOS prints manual options. |
+| `fdev clear-data` | In a Flutter project root, clears the installed project's Android package data without confirmation; if it is missing or the clear fails, falls back to the foreground app with a default-Yes safety prompt. Outside a project, always detects and confirms the foreground app. iOS prints manual options. |
 | `fdev install-scrcpy` | Installs `scrcpy` using the best supported package manager for the current platform. |
 | `fdev mirror` | Launches `scrcpy` for a selected Android device. |
 | `fdev mirror --wireless` | Guides wireless ADB setup using a USB-connected Android device. |
@@ -356,7 +356,7 @@ core/constants.py       Shared regex patterns, paths, and build command constant
 core/state.py           Selected Android device state
 managers/build.py       APK/AAB/IPA/release-run build workflow
 managers/project.py     setup, cleanup, lang, db, pod, cache repair
-managers/app.py         install, uninstall, foreground app data clearing
+managers/app.py         install, uninstall, project/foreground app data clearing
 managers/device.py      ADB device detection and selection
 managers/mirror.py      scrcpy install, mirror, wireless ADB setup
 managers/git.py         commit, tag, discard, branch sync, deployment merge
@@ -379,7 +379,7 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev tag` updates `pubspec.yaml`, creates a commit, creates a Git tag, and pushes both.
 - `fdev discard` removes tracked changes and untracked files after confirmation.
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
-- `fdev clear-data` skips confirmation only when the foreground Android app matches the current Flutter project's package ID; otherwise it uses a default-Yes `[Y/n]` confirmation.
+- `fdev clear-data` clears the installed current project's Android package without confirmation when run from a Flutter project root. If that package is missing or cannot be cleared, and whenever the command runs outside a project, it targets the foreground app after a default-Yes `[Y/n]` 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 upgrade` reports the installed version and location before upgrading, then shows the before→after version when the active process can verify it immediately.

{flutter_dev-0.1.10 → flutter_dev-0.1.12}/fdev.py

@@ -102,7 +102,7 @@ def show_usage(exit_code=1):
     print(f"\n{BLUE}Device Commands:{NC}")
     print("  install      Install built APK on connected device")
     print("  uninstall    Uninstall app from connected device")
-    print("  clear-data   Clear data of currently running foreground app")
+    print("  clear-data   Clear project app data with confirmed foreground fallback")
     print("  install-scrcpy Install scrcpy for Android screen mirroring")
     print("  mirror       Launch scrcpy screen mirror (auto-detect device)")
     print("    --wireless Setup wireless ADB connection")

{flutter_dev-0.1.10 → flutter_dev-0.1.12}/flutter_dev.egg-info/SOURCES.txt

@@ -34,6 +34,7 @@ managers/package.py
 managers/project.py
 managers/web_deploy.py
 tests/test_ai_config.py
+tests/test_app_commands.py
 tests/test_fdev_cli.py
 tests/test_localization.py
 tests/test_package_commands.py

{flutter_dev-0.1.10 → flutter_dev-0.1.12}/managers/app.py

@@ -186,12 +186,65 @@ def get_current_foreground_app():
 
 def clear_app_data():
     """
-    Automatically clear data of currently running foreground app
-    Works for both Android and iOS on all operating systems (macOS, Linux, Windows)
+    Clear app data from a connected device.
+
+    In a Flutter project root, clear the project's installed Android package
+    without confirmation. If it is not installed or cannot be cleared, fall
+    back to the foreground app with confirmation. Outside a project root,
+    always detect and confirm before clearing the foreground app.
     """
-    print(f"{YELLOW}Clearing app data for foreground app...{NC}\n")
+    print(f"{YELLOW}Clearing app data...{NC}\n")
 
-    # Get current foreground app
+    # Match uninstall behavior in a Flutter project: target the installed
+    # project package first, then fall back to the foreground app if needed.
+    if is_flutter_project_root() and get_all_connected_devices():
+        print(f"{GREEN}✓ Flutter project detected{NC}\n")
+        print(f"{BLUE}Android device detected{NC}")
+
+        if not ensure_device_connected("Device selection failed!"):
+            return False
+
+        package_name = get_package_name()
+        if not package_name:
+            print(f"{RED}Cannot proceed without package name{NC}")
+            return False
+
+        print(f"{BLUE}Package name: {package_name}{NC}\n")
+
+        if is_app_installed(package_name):
+            print(f"{GREEN}✓ App is installed on device{NC}\n")
+            success = _clear_android_package_data(package_name)
+            if success:
+                return True
+
+            print(f"\n{YELLOW}⚠️  Could not clear data for {package_name}{NC}")
+        else:
+            print(f"{YELLOW}⚠️  Project app is not installed on device{NC}")
+
+        print(f"{YELLOW}   Detecting foreground app instead...{NC}\n")
+
+    return _clear_foreground_app_data()
+
+
+def _clear_android_package_data(package_name):
+    """Clear one Android package and report the command result."""
+    success = run_flutter_command(
+        build_adb_cmd(["shell", "pm", "clear", package_name]),
+        "Clearing app data...                                ",
+    )
+
+    if success:
+        print(f"\n{GREEN}✓ App data cleared successfully!{NC}")
+        print(f"{BLUE}You can now relaunch the app from the device{NC}")
+    else:
+        print(f"\n{RED}✗ Failed to clear app data!{NC}")
+        print(f"{YELLOW}Make sure the app package name is correct{NC}")
+
+    return success
+
+
+def _clear_foreground_app_data():
+    """Detect the foreground app and clear it only after confirmation."""
     platform_type, package_name = get_current_foreground_app()
 
     if not platform_type:
@@ -207,45 +260,15 @@ def clear_app_data():
     print(f"{BLUE}Platform: {platform_type.upper()}{NC}")
     print(f"{BLUE}App: {package_name}{NC}\n")
 
-    # Skip confirmation only when the foreground app matches the current
-    # Flutter project's Android package. Otherwise, keep the safety prompt.
-    project_package = get_package_name() if is_flutter_project_root() else None
-    is_current_project_app = (
-        platform_type == "android"
-        and project_package is not None
-        and project_package == package_name
-    )
-
-    if is_current_project_app:
-        print(f"{GREEN}✓ Foreground app matches the current Flutter project{NC}\n")
-    else:
-        if project_package and platform_type == "android":
-            print(f"{YELLOW}⚠️  Foreground app does not match the current Flutter project{NC}")
-            print(f"{BLUE}Project package: {project_package}{NC}\n")
-
-        user_input = input(
-            f"Clear data for {GREEN}{package_name}{NC}? [Y/n]: "
-        ).strip().lower()
-        if user_input in ("n", "no"):
-            print(f"{YELLOW}Operation cancelled{NC}")
-            return False
+    user_input = input(
+        f"Clear data for {GREEN}{package_name}{NC}? [Y/n]: "
+    ).strip().lower()
+    if user_input in ("n", "no"):
+        print(f"{YELLOW}Operation cancelled{NC}")
+        return False
 
-    # Clear data based on platform
     if platform_type == "android":
-        # Clear app data on Android
-        success = run_flutter_command(
-            build_adb_cmd(["shell", "pm", "clear", package_name]),
-            f"Clearing app data...                                "
-        )
-
-        if success:
-            print(f"\n{GREEN}✓ App data cleared successfully!{NC}")
-            print(f"{BLUE}You can now relaunch the app from the device{NC}")
-        else:
-            print(f"\n{RED}✗ Failed to clear app data!{NC}")
-            print(f"{YELLOW}Make sure the app package name is correct{NC}")
-
-        return success
+        return _clear_android_package_data(package_name)
 
     elif platform_type == "ios":
         # iOS doesn't support direct app data clearing via command line

{flutter_dev-0.1.10 → flutter_dev-0.1.12}/pyproject.toml

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

flutter_dev-0.1.12/tests/test_app_commands.py

@@ -0,0 +1,161 @@
+import unittest
+from unittest.mock import patch
+
+from managers import app
+
+
+class ClearAppDataTests(unittest.TestCase):
+    def test_project_root_clears_project_package_without_confirmation(self):
+        with (
+            patch.object(app, "is_flutter_project_root", return_value=True),
+            patch.object(app, "get_all_connected_devices", return_value=["device-1"]),
+            patch.object(app, "ensure_device_connected", return_value=True),
+            patch.object(app, "get_package_name", return_value="com.example.app"),
+            patch.object(app, "is_app_installed", return_value=True),
+            patch.object(
+                app,
+                "build_adb_cmd",
+                return_value=["adb", "shell", "pm", "clear", "com.example.app"],
+            ),
+            patch.object(app, "run_flutter_command", return_value=True) as run_command,
+            patch.object(app, "get_current_foreground_app") as foreground_app,
+            patch("builtins.input") as user_input,
+        ):
+            result = app.clear_app_data()
+
+        self.assertTrue(result)
+        foreground_app.assert_not_called()
+        user_input.assert_not_called()
+        run_command.assert_called_once_with(
+            ["adb", "shell", "pm", "clear", "com.example.app"],
+            "Clearing app data...                                ",
+        )
+
+    def test_missing_project_app_falls_back_to_confirmed_foreground_app(self):
+        with (
+            patch.object(app, "is_flutter_project_root", return_value=True),
+            patch.object(app, "get_all_connected_devices", return_value=["device-1"]),
+            patch.object(app, "ensure_device_connected", return_value=True),
+            patch.object(app, "get_package_name", return_value="com.example.app"),
+            patch.object(app, "is_app_installed", return_value=False),
+            patch.object(
+                app,
+                "get_current_foreground_app",
+                return_value=("android", "com.example.foreground"),
+            ) as foreground_app,
+            patch.object(
+                app,
+                "build_adb_cmd",
+                return_value=[
+                    "adb",
+                    "shell",
+                    "pm",
+                    "clear",
+                    "com.example.foreground",
+                ],
+            ),
+            patch.object(app, "run_flutter_command", return_value=True) as run_command,
+            patch("builtins.input", return_value="") as user_input,
+        ):
+            result = app.clear_app_data()
+
+        self.assertTrue(result)
+        foreground_app.assert_called_once_with()
+        user_input.assert_called_once()
+        run_command.assert_called_once_with(
+            ["adb", "shell", "pm", "clear", "com.example.foreground"],
+            "Clearing app data...                                ",
+        )
+
+    def test_failed_project_clear_falls_back_to_confirmed_foreground_app(self):
+        def adb_command(parts):
+            return ["adb", *parts]
+
+        with (
+            patch.object(app, "is_flutter_project_root", return_value=True),
+            patch.object(app, "get_all_connected_devices", return_value=["device-1"]),
+            patch.object(app, "ensure_device_connected", return_value=True),
+            patch.object(app, "get_package_name", return_value="com.example.app"),
+            patch.object(app, "is_app_installed", return_value=True),
+            patch.object(
+                app,
+                "get_current_foreground_app",
+                return_value=("android", "com.example.foreground"),
+            ),
+            patch.object(app, "build_adb_cmd", side_effect=adb_command),
+            patch.object(
+                app,
+                "run_flutter_command",
+                side_effect=[False, True],
+            ) as run_command,
+            patch("builtins.input", return_value="") as user_input,
+        ):
+            result = app.clear_app_data()
+
+        self.assertTrue(result)
+        user_input.assert_called_once()
+        self.assertEqual(run_command.call_count, 2)
+        self.assertEqual(
+            run_command.call_args_list[0].args[0],
+            ["adb", "shell", "pm", "clear", "com.example.app"],
+        )
+        self.assertEqual(
+            run_command.call_args_list[1].args[0],
+            ["adb", "shell", "pm", "clear", "com.example.foreground"],
+        )
+
+    def test_missing_project_app_foreground_fallback_can_be_cancelled(self):
+        with (
+            patch.object(app, "is_flutter_project_root", return_value=True),
+            patch.object(app, "get_all_connected_devices", return_value=["device-1"]),
+            patch.object(app, "ensure_device_connected", return_value=True),
+            patch.object(app, "get_package_name", return_value="com.example.app"),
+            patch.object(app, "is_app_installed", return_value=False),
+            patch.object(
+                app,
+                "get_current_foreground_app",
+                return_value=("android", "com.example.foreground"),
+            ),
+            patch.object(app, "run_flutter_command") as run_command,
+            patch("builtins.input", return_value="n") as user_input,
+        ):
+            result = app.clear_app_data()
+
+        self.assertFalse(result)
+        user_input.assert_called_once()
+        run_command.assert_not_called()
+
+    def test_outside_project_confirms_before_clearing_foreground_app(self):
+        with (
+            patch.object(app, "is_flutter_project_root", return_value=False),
+            patch.object(
+                app,
+                "get_current_foreground_app",
+                return_value=("android", "com.example.foreground"),
+            ),
+            patch.object(
+                app,
+                "build_adb_cmd",
+                return_value=[
+                    "adb",
+                    "shell",
+                    "pm",
+                    "clear",
+                    "com.example.foreground",
+                ],
+            ),
+            patch.object(app, "run_flutter_command", return_value=True) as run_command,
+            patch("builtins.input", return_value="") as user_input,
+        ):
+            result = app.clear_app_data()
+
+        self.assertTrue(result)
+        user_input.assert_called_once()
+        run_command.assert_called_once_with(
+            ["adb", "shell", "pm", "clear", "com.example.foreground"],
+            "Clearing app data...                                ",
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()