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

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.12
+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.12`, 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
 
@@ -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`. |
@@ -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.12 → 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.12`, 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
 
@@ -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`. |
@@ -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.12 → 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,
 )
 
@@ -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.12 → 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.12 → flutter_dev-0.1.13}/pyproject.toml

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