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

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.11
+Version: 0.1.12
 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.11`, 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
 
@@ -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` | In a Flutter project root, clears the project's Android package data without confirmation. Outside a project, detects the foreground app and shows a default-Yes safety prompt. 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. |
@@ -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` targets the current project's Android package without confirmation when run from a Flutter project root. Outside a project, it targets the foreground app after 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.11 → flutter_dev-0.1.12}/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.11`, 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
 
@@ -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` | In a Flutter project root, clears the project's Android package data without confirmation. Outside a project, detects the foreground app and shows a default-Yes safety prompt. 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. |
@@ -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` targets the current project's Android package without confirmation when run from a Flutter project root. Outside a project, it targets the foreground app after 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.11 → 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 project app data, or foreground app data outside a project")
+    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.11 → flutter_dev-0.1.12}/managers/app.py

@@ -188,14 +188,15 @@ def clear_app_data():
     """
     Clear app data from a connected device.
 
-    In a Flutter project root, clear the project's Android package without a
-    confirmation prompt. Outside a project root, detect the foreground app and
-    require confirmation before clearing its data.
+    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...{NC}\n")
 
-    # Match uninstall behavior in a Flutter project: target the project's
-    # package directly instead of whichever app happens to be in the foreground.
+    # 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}")
@@ -210,21 +211,40 @@ def clear_app_data():
 
         print(f"{BLUE}Package name: {package_name}{NC}\n")
 
-        success = run_flutter_command(
-            build_adb_cmd(["shell", "pm", "clear", package_name]),
-            "Clearing app data...                                "
-        )
+        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
 
-        if success:
-            print(f"\n{GREEN}✓ App data cleared successfully!{NC}")
-            print(f"{BLUE}You can now relaunch the app from the device{NC}")
+            print(f"\n{YELLOW}⚠️  Could not clear data for {package_name}{NC}")
         else:
-            print(f"\n{RED}✗ Failed to clear app data!{NC}")
-            print(f"{YELLOW}Make sure the app package name is correct{NC}")
+            print(f"{YELLOW}⚠️  Project app is not installed on device{NC}")
 
-        return success
+        print(f"{YELLOW}   Detecting foreground app instead...{NC}\n")
 
-    # Get current foreground app
+    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:
@@ -247,22 +267,8 @@ def clear_app_data():
         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.11 → flutter_dev-0.1.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flutter-dev"
-version = "0.1.11"
+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()

flutter_dev-0.1.11/tests/test_app_commands.py

@@ -1,66 +0,0 @@
-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,
-                "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_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()