TonieToolbox 0.5.0a1__py3-none-any.whl → 0.6.0__py3-none-any.whl

TonieToolbox/version_handler.py

@@ -1,3 +1,4 @@
+#!/usr/bin/python3
 """
 Version handler to check if the latest version of TonieToolbox is being used.
 """
@@ -17,18 +18,17 @@ CACHE_DIR = os.path.join(os.path.expanduser("~"), ".tonietoolbox")
 CACHE_FILE = os.path.join(CACHE_DIR, "version_cache.json")
 CACHE_EXPIRY = 86400  # 24 hours in seconds
 
+logger = get_logger(__name__)
 
-def get_pypi_version(force_refresh=False):
+def get_pypi_version(force_refresh: bool = False) -> tuple[str, str | None]:
     """
     Get the latest version of TonieToolbox from PyPI.
     
     Args:
-        force_refresh: If True, ignore the cache and fetch directly from PyPI
-        
+        force_refresh (bool): If True, ignore the cache and fetch directly from PyPI
     Returns:
-        tuple: (latest_version, None) on success, (current_version, error_message) on failure
+        tuple[str, str | None]: (latest_version, None) on success, (current_version, error_message) on failure
     """
-    logger = get_logger("version_handler")
     logger.debug("Checking for latest version (force_refresh=%s)", force_refresh)
     logger.debug("Current version: %s", __version__)
     
@@ -88,18 +88,16 @@ def get_pypi_version(force_refresh=False):
         return __version__, f"Unexpected error checking for updates: {str(e)}"
 
 
-def compare_versions(v1, v2):
+def compare_versions(v1: str, v2: str) -> int:
     """
     Compare two version strings according to PEP 440.
     
     Args:
-        v1: First version string
-        v2: Second version string
-        
+        v1 (str): First version string
+        v2 (str): Second version string
     Returns:
         int: -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
     """
-    logger = get_logger("version_handler")
     logger.debug("Comparing versions: '%s' vs '%s'", v1, v2)
     
     try:   
@@ -133,22 +131,20 @@ def compare_versions(v1, v2):
             return 1
 
 
-def check_for_updates(quiet=False, force_refresh=False):
+def check_for_updates(quiet: bool = False, force_refresh: bool = False) -> tuple[bool, str, str, bool]:
     """
     Check if the current version of TonieToolbox is the latest.
     
     Args:
-        quiet: If True, will not log any information messages and skip user confirmation
-        force_refresh: If True, bypass cache and check PyPI directly
-        
+        quiet (bool): If True, will not log any information messages and skip user confirmation
+        force_refresh (bool): If True, bypass cache and check PyPI directly
     Returns:
-        tuple: (is_latest, latest_version, message, update_confirmed)
+        tuple[bool, str, str, bool]: (is_latest, latest_version, message, update_confirmed)
             is_latest: boolean indicating if the current version is the latest
             latest_version: string with the latest version
             message: string message about the update status or error
             update_confirmed: boolean indicating if the user confirmed the update
     """
-    logger = get_logger("version_handler")
     current_version = __version__
     update_confirmed = False
     
@@ -200,14 +196,13 @@ def check_for_updates(quiet=False, force_refresh=False):
     return is_latest, latest_version, message, update_confirmed
 
 
-def install_update():
+def install_update() -> bool:
     """
     Try to install the update using pip, pip3, or pipx.
     
     Returns:
         bool: True if the update was successfully installed, False otherwise
     """
-    logger = get_logger("version_handler")
     import subprocess
     import sys
     
@@ -238,14 +233,13 @@ def install_update():
     return False
 
 
-def clear_version_cache():
+def clear_version_cache() -> bool:
     """
     Clear the version cache file to force a refresh on next check.
     
     Returns:
         bool: True if cache was cleared, False otherwise
     """
-    logger = get_logger("version_handler")
     
     try:
         if os.path.exists(CACHE_FILE):