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

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

@@ -2,6 +2,27 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.1.13 - 2026-07-22
+
+### Added
+
+- Added `fdev -v` and `fdev --version` for showing the installed package version.
+
+### Changed
+
+- Changed `fdev upgrade` to check PyPI before invoking pip, skip installation when already current, suppress routine pip dependency output, and report verified before→after versions after a successful upgrade.
+- Kept the terminal-restart reminder after an actual successful version change.
+
+## 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.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.11
+Version: 0.1.13
 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.13`, 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. |
@@ -241,9 +241,10 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 | --- | --- |
 | `fdev` | Shows command help. |
 | `fdev help` | Shows command help. |
+| `fdev -v` / `fdev --version` | Shows the version installed in the active fdev Python environment. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
 | `fdev init` | Creates or repairs the persistent AI `.env` with safe provider defaults and empty API keys. |
-| `fdev upgrade` | Shows the current version, Python environment, package location, and PyPI source, then upgrades with `python -m pip install --upgrade flutter-dev` and reports the resulting version. |
+| `fdev upgrade` | Checks the latest PyPI version first. If already current, skips pip and prints one up-to-date notice; otherwise upgrades quietly and reports the previous and installed versions. |
 | `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`. |
@@ -413,7 +414,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.
@@ -451,11 +452,12 @@ where fdev
 Use the built-in package management commands from the Python environment where `fdev` is installed:
 
 ```bash
+fdev -v
 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.
+The upgrade and delete commands print the detected OS and exact Python executable. Upgrade checks PyPI first and avoids running pip when the installed version is current. When pip is needed, both commands use the active executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`. On Windows, `fdev delete` and a required `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
 

{flutter_dev-0.1.11 → flutter_dev-0.1.13}/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.13`, 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. |
@@ -207,9 +207,10 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 | --- | --- |
 | `fdev` | Shows command help. |
 | `fdev help` | Shows command help. |
+| `fdev -v` / `fdev --version` | Shows the version installed in the active fdev Python environment. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
 | `fdev init` | Creates or repairs the persistent AI `.env` with safe provider defaults and empty API keys. |
-| `fdev upgrade` | Shows the current version, Python environment, package location, and PyPI source, then upgrades with `python -m pip install --upgrade flutter-dev` and reports the resulting version. |
+| `fdev upgrade` | Checks the latest PyPI version first. If already current, skips pip and prints one up-to-date notice; otherwise upgrades quietly and reports the previous and installed versions. |
 | `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`. |
@@ -379,7 +380,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.
@@ -417,11 +418,12 @@ where fdev
 Use the built-in package management commands from the Python environment where `fdev` is installed:
 
 ```bash
+fdev -v
 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.
+The upgrade and delete commands print the detected OS and exact Python executable. Upgrade checks PyPI first and avoids running pip when the installed version is current. When pip is needed, both commands use the active executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`. On Windows, `fdev delete` and a required `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
 

{flutter_dev-0.1.11 → flutter_dev-0.1.13}/fdev.py

@@ -73,6 +73,7 @@ from managers.git_account import (
 )
 from managers.package import (
     delete_fdev_command,
+    show_fdev_version,
     upgrade_fdev_command,
 )
 
@@ -102,7 +103,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")
@@ -124,6 +125,7 @@ def show_usage(exit_code=1):
     print("  brew         Interactive Homebrew package manager")
     print("  upgrade      Upgrade fdev from PyPI")
     print("  delete       Uninstall fdev from this computer")
+    print("  -v, --version Show the installed fdev version")
     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")
@@ -167,6 +169,9 @@ def main():
 
     command = sys.argv[1].lower()
 
+    if command in ("-v", "--version"):
+        return show_fdev_version()
+
     if command in ("apk", "apk-split", "aab", "ipa", "release-run", "install"):
         os.makedirs("build/app/outputs/flutter-apk", exist_ok=True)
         os.makedirs("build/app/outputs/bundle/release", exist_ok=True)

{flutter_dev-0.1.11 → flutter_dev-0.1.13}/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.13}/managers/package.py

@@ -9,9 +9,12 @@ import platform
 import subprocess
 import sys
 
+import requests
+
 from common_utils import BLUE, GREEN, RED, YELLOW, NC
 
 PACKAGE_NAME = "flutter-dev"
+PYPI_JSON_URL = f"https://pypi.org/pypi/{PACKAGE_NAME}/json"
 
 
 def get_os_info():
@@ -59,6 +62,32 @@ def _print_installed_package_info(version, package_location):
     print(f"{BLUE}Package location: {GREEN}{package_location}{NC}")
 
 
+def show_fdev_version():
+    """Print the version installed in the Python environment running fdev."""
+    version, _ = _get_installed_package_info()
+    if version == "not installed":
+        print(f"{RED}Could not determine the installed fdev version.{NC}")
+        return 1
+
+    print(f"fdev {version}")
+    return 0
+
+
+def _get_latest_pypi_version():
+    """Return the latest published PyPI version, or None when unavailable."""
+    try:
+        response = requests.get(
+            PYPI_JSON_URL,
+            headers={"Accept": "application/json"},
+            timeout=10,
+        )
+        response.raise_for_status()
+        version = response.json()["info"]["version"]
+        return version.strip() if isinstance(version, str) and version.strip() else None
+    except (requests.RequestException, KeyError, TypeError, ValueError):
+        return None
+
+
 def _build_pip_command(pip_args):
     return [sys.executable, "-m", "pip", *pip_args]
 
@@ -68,6 +97,23 @@ def _run_pip_direct(pip_args):
     return result.returncode
 
 
+def _run_pip_quiet(pip_args):
+    """Run pip without streaming routine dependency output to the terminal."""
+    result = subprocess.run(
+        _build_pip_command(pip_args),
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+    )
+    if result.returncode != 0:
+        if result.stdout:
+            print(f"{GREEN}Output:\n{result.stdout.strip()}{NC}")
+        if result.stderr:
+            print(f"{RED}Error Output:\n{result.stderr.strip()}{NC}")
+    return result.returncode
+
+
 def _build_windows_detached_command(pip_args):
     pip_command = subprocess.list2cmdline(_build_pip_command(pip_args))
     delayed_command = f"timeout /t 2 /nobreak > nul & {pip_command}"
@@ -158,12 +204,24 @@ def upgrade_fdev_command(argv=None):
 
     pip_args = ["install", "--upgrade", PACKAGE_NAME]
     print(f"{BLUE}Upgrade source: {GREEN}PyPI{NC}")
-    print(f"{YELLOW}Upgrading {PACKAGE_NAME} from PyPI...{NC}")
+    latest_version = _get_latest_pypi_version()
+
+    if latest_version == current_version:
+        print(f"{GREEN}✓ Already up to date: {current_version}{NC}")
+        return 0
+
+    if latest_version:
+        print(
+            f"{YELLOW}Upgrading {PACKAGE_NAME}: "
+            f"{current_version} → {latest_version}...{NC}"
+        )
+    else:
+        print(f"{YELLOW}Could not verify the latest PyPI version; checking with pip...{NC}")
 
     if os_key == "windows":
         return _run_windows_detached(pip_args, "Upgrade")
 
-    result = _run_pip_direct(pip_args)
+    result = _run_pip_quiet(pip_args)
     if result == 0:
         installed_version, installed_location = _get_installed_package_info()
         if current_version != installed_version:
@@ -171,14 +229,20 @@ def upgrade_fdev_command(argv=None):
                 f"{GREEN}✓ {PACKAGE_NAME} upgraded successfully: "
                 f"{current_version} → {installed_version}.{NC}"
             )
-        else:
+            if installed_location != package_location:
+                print(f"{BLUE}Installed at: {GREEN}{installed_location}{NC}")
+            print(f"{BLUE}Restart your terminal if the fdev command still uses the old version.{NC}")
+            return 0
+
+        if latest_version and latest_version != installed_version:
             print(
-                f"{GREEN}✓ {PACKAGE_NAME} upgrade completed. "
-                f"Installed version: {installed_version}.{NC}"
+                f"{RED}✗ Upgrade did not change the installed version. "
+                f"Installed: {installed_version}; PyPI: {latest_version}.{NC}"
             )
-        if installed_location != package_location:
-            print(f"{BLUE}Installed at: {GREEN}{installed_location}{NC}")
-        print(f"{BLUE}Restart your terminal if the fdev command still uses the old version.{NC}")
-    else:
-        print(f"{RED}✗ Failed to upgrade {PACKAGE_NAME}.{NC}")
+            return 1
+
+        print(f"{GREEN}✓ Already up to date: {installed_version}{NC}")
+        return 0
+
+    print(f"{RED}✗ Failed to upgrade {PACKAGE_NAME}.{NC}")
     return result

{flutter_dev-0.1.11 → flutter_dev-0.1.13}/pyproject.toml

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

flutter_dev-0.1.13/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 → flutter_dev-0.1.13}/tests/test_fdev_cli.py

@@ -26,6 +26,26 @@ class FdevCliTests(unittest.TestCase):
         self.assertEqual(result, 0)
         show_usage.assert_called_once_with(exit_code=0)
 
+    def test_short_version_flag_prints_installed_version(self):
+        with (
+            patch.object(sys, "argv", ["fdev", "-v"]),
+            patch.object(fdev, "show_fdev_version", return_value=0) as show_version,
+        ):
+            result = fdev.main()
+
+        self.assertEqual(result, 0)
+        show_version.assert_called_once_with()
+
+    def test_long_version_flag_prints_installed_version(self):
+        with (
+            patch.object(sys, "argv", ["fdev", "--version"]),
+            patch.object(fdev, "show_fdev_version", return_value=0) as show_version,
+        ):
+            result = fdev.main()
+
+        self.assertEqual(result, 0)
+        show_version.assert_called_once_with()
+
     def test_unknown_command_prints_usage_and_exits_with_error(self):
         with (
             patch.object(sys, "argv", ["fdev", "unknown"]),

{flutter_dev-0.1.11 → flutter_dev-0.1.13}/tests/test_package_commands.py

@@ -2,7 +2,7 @@ import io
 import subprocess
 import unittest
 from contextlib import redirect_stdout
-from unittest.mock import patch
+from unittest.mock import Mock, patch
 
 from managers import package
 
@@ -38,23 +38,96 @@ class PackageCommandTests(unittest.TestCase):
         run.assert_not_called()
 
     def test_upgrade_runs_pip_upgrade_in_current_python_environment(self):
+        with (
+            patch.object(package.platform, "system", return_value="Linux"),
+            patch.object(package.sys, "executable", "/venv/bin/python"),
+            patch.object(package, "_get_latest_pypi_version", return_value="0.1.13"),
+            patch.object(
+                package,
+                "_get_installed_package_info",
+                side_effect=[
+                    ("0.1.12", "/venv/lib/python/site-packages"),
+                    ("0.1.13", "/venv/lib/python/site-packages"),
+                ],
+            ),
+            patch.object(package, "_run_pip_quiet", return_value=0) as run,
+        ):
+            result = package.upgrade_fdev_command([])
+
+        self.assertEqual(result, 0)
+        run.assert_called_once_with(["install", "--upgrade", "flutter-dev"])
+
+    def test_upgrade_skips_pip_when_already_up_to_date(self):
+        output = io.StringIO()
+
+        with (
+            patch.object(package.platform, "system", return_value="Linux"),
+            patch.object(
+                package,
+                "_get_installed_package_info",
+                return_value=("0.1.12", "/venv/lib/python/site-packages"),
+            ),
+            patch.object(package, "_get_latest_pypi_version", return_value="0.1.12"),
+            patch.object(package, "_run_pip_quiet") as run,
+            redirect_stdout(output),
+        ):
+            result = package.upgrade_fdev_command([])
+
+        self.assertEqual(result, 0)
+        run.assert_not_called()
+        self.assertIn("✓ Already up to date: 0.1.12", output.getvalue())
+
+    def test_quiet_pip_hides_routine_success_output(self):
         completed = subprocess.CompletedProcess(
             ["/venv/bin/python", "-m", "pip", "install", "--upgrade", "flutter-dev"],
             0,
+            stdout="Requirement already satisfied: flutter-dev (0.1.12)\n",
+            stderr="",
         )
+        output = io.StringIO()
 
         with (
-            patch.object(package.platform, "system", return_value="Linux"),
             patch.object(package.sys, "executable", "/venv/bin/python"),
             patch.object(package.subprocess, "run", return_value=completed) as run,
+            redirect_stdout(output),
         ):
-            result = package.upgrade_fdev_command([])
+            result = package._run_pip_quiet(["install", "--upgrade", "flutter-dev"])
 
         self.assertEqual(result, 0)
+        self.assertEqual(output.getvalue(), "")
         run.assert_called_once_with(
-            ["/venv/bin/python", "-m", "pip", "install", "--upgrade", "flutter-dev"]
+            ["/venv/bin/python", "-m", "pip", "install", "--upgrade", "flutter-dev"],
+            capture_output=True,
+            text=True,
+            encoding="utf-8",
+            errors="replace",
         )
 
+    def test_latest_pypi_version_uses_package_json_metadata(self):
+        response = Mock()
+        response.json.return_value = {"info": {"version": "0.1.13"}}
+
+        with patch.object(package.requests, "get", return_value=response) as get:
+            version = package._get_latest_pypi_version()
+
+        self.assertEqual(version, "0.1.13")
+        response.raise_for_status.assert_called_once_with()
+        get.assert_called_once_with(
+            package.PYPI_JSON_URL,
+            headers={"Accept": "application/json"},
+            timeout=10,
+        )
+
+    def test_latest_pypi_version_returns_none_when_lookup_fails(self):
+        with patch.object(
+            package.requests,
+            "get",
+            side_effect=package.requests.RequestException("offline"),
+        ):
+            version = package._get_latest_pypi_version()
+
+        self.assertIsNone(version)
+
     def test_windows_delete_schedules_detached_uninstall(self):
         with (
             patch.object(package.platform, "system", return_value="Windows"),
@@ -100,16 +173,17 @@ class PackageCommandTests(unittest.TestCase):
         )
 
     def test_upgrade_prints_target_python_environment(self):
-        completed = subprocess.CompletedProcess(
-            ["/home/user/project/.venv/bin/python", "-m", "pip", "install", "--upgrade", "flutter-dev"],
-            0,
-        )
         output = io.StringIO()
 
         with (
             patch.object(package.platform, "system", return_value="Linux"),
             patch.object(package.sys, "executable", "/home/user/project/.venv/bin/python"),
-            patch.object(package.subprocess, "run", return_value=completed),
+            patch.object(
+                package,
+                "_get_installed_package_info",
+                return_value=("0.1.12", "/home/user/project/.venv/lib/python/site-packages"),
+            ),
+            patch.object(package, "_get_latest_pypi_version", return_value="0.1.12"),
             redirect_stdout(output),
         ):
             result = package.upgrade_fdev_command([])
@@ -118,6 +192,48 @@ class PackageCommandTests(unittest.TestCase):
         self.assertIn("Python environment:", output.getvalue())
         self.assertIn("/home/user/project/.venv/bin/python", output.getvalue())
 
+    def test_successful_upgrade_prints_before_and_after_versions(self):
+        output = io.StringIO()
+
+        with (
+            patch.object(package.platform, "system", return_value="Linux"),
+            patch.object(
+                package,
+                "_get_installed_package_info",
+                side_effect=[
+                    ("0.1.12", "/venv/lib/python/site-packages"),
+                    ("0.1.13", "/venv/lib/python/site-packages"),
+                ],
+            ),
+            patch.object(package, "_get_latest_pypi_version", return_value="0.1.13"),
+            patch.object(package, "_run_pip_quiet", return_value=0),
+            redirect_stdout(output),
+        ):
+            result = package.upgrade_fdev_command([])
+
+        self.assertEqual(result, 0)
+        self.assertIn("0.1.12 → 0.1.13", output.getvalue())
+        self.assertIn(
+            "Restart your terminal if the fdev command still uses the old version.",
+            output.getvalue(),
+        )
+
+    def test_show_fdev_version_prints_installed_version(self):
+        output = io.StringIO()
+
+        with (
+            patch.object(
+                package,
+                "_get_installed_package_info",
+                return_value=("0.1.13", "/venv/lib/python/site-packages"),
+            ),
+            redirect_stdout(output),
+        ):
+            result = package.show_fdev_version()
+
+        self.assertEqual(result, 0)
+        self.assertEqual(output.getvalue().strip(), "fdev 0.1.13")
+
     def test_command_help_returns_zero(self):
         with self.assertRaises(SystemExit) as raised:
             package.delete_fdev_command(["--help"])

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()