Add check for available upgrades

Author: daneah

CHANGELOG.md

@@ -13,6 +13,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Links to plugins on public PyPI
 
+### Added
+
+- Automatic check and notification of available upgrades
+
 ## [0.0.4] - 2025-04-10
 
 ### Added

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 requires-python = ">=3.9"
 name = "minimal-pba-cli"
-version = "0.0.4"
+version = "0.0.5"
 description = "A minimal command-line interface using plugin-based architecture"
 authors = [
     { name = "Dane Hillard", email = "[email protected]" }

src/minimal_pba_cli/cli.py

@@ -1,14 +1,17 @@
+import atexit
 import traceback
 import importlib
 from typing import Annotated
 
+import requests
 import typer
 from typer.main import get_group
 from trogon import Trogon
 from rich.console import Console
+from rich.panel import Panel
 
 from minimal_pba_cli.upgrade import upgrade
-from minimal_pba_cli.plugin import plugin, find_plugins
+from minimal_pba_cli.plugin import plugin, find_plugins, get_latest_version
 from minimal_pba_cli.customization import list_available_commands, create_command_wrapper
 
 
@@ -65,3 +68,31 @@ def _register_plugins(app: typer.Typer):
                 "[red]As an example, you can run [bold cyan]DISABLE_PLUGINS=true pba-cli plugin uninstall <plugin>[/bold cyan] to remove a problematic plugin or [bold cyan]DISABLE_PLUGINS=true pba-cli plugin install <plugin>[/bold cyan] to attempt to upgrade a plugin.[/red]\n"
             )
             continue
+
+
+def _upgrade_check() -> None:
+    try:
+        current_version, latest_version, is_upgrade = get_latest_version("minimal-pba-cli")
+    except requests.exceptions.RequestException:
+        typer.secho(
+            "Checking for minimal-pba-cli updates failed.",
+            fg=typer.colors.YELLOW,
+        )
+        return
+
+    if is_upgrade:
+        console = Console()
+        changelog_link = "[link=https://github.com/easy-as-python/minimal-pba-cli/blob/main/CHANGELOG.md]changelog[/link]"
+        console.print(
+            Panel(
+                f""":rocket: Update available!
+
+[yellow]{current_version}[/yellow] -> [bold green]{latest_version}[/bold green] ({changelog_link})
+
+Run [bold]pba-cli upgrade[/bold] to upgrade.""",
+                expand=False,
+                padding=(1, 10),
+            )
+        )
+
+atexit.register(_upgrade_check)