TonieToolbox 0.5.1__py3-none-any.whl → 0.6.0a2__py3-none-any.whl

TonieToolbox/tonie_file.py

@@ -18,14 +18,14 @@ from .logger import get_logger
 logger = get_logger('tonie_file')
 
 
-def toniefile_comment_add(buffer, length, comment_str):
+def toniefile_comment_add(buffer: bytearray, length: int, comment_str: str) -> int:
     """
     Add a comment string to an Opus comment packet buffer.
     
     Args:
-        buffer: Bytearray buffer to add comment to
-        length: Current position in the buffer
-        comment_str: Comment string to add
+        buffer (bytearray): Bytearray buffer to add comment to
+        length (int): Current position in the buffer
+        comment_str (str): Comment string to add
         
     Returns:
         int: New position in the buffer after adding comment
@@ -44,7 +44,7 @@ def toniefile_comment_add(buffer, length, comment_str):
     return length
 
 
-def check_identification_header(page):
+def check_identification_header(page) -> None:
     """
     Check if a page contains a valid Opus identification header.
     
@@ -77,16 +77,16 @@ def check_identification_header(page):
     logger.debug("Opus identification header is valid")
 
 
-def prepare_opus_tags(page, custom_tags=False, bitrate=64, vbr=True, opus_binary=None):
+def prepare_opus_tags(page, custom_tags: bool = False, bitrate: int = 64, vbr: bool = True, opus_binary: str = None) -> OggPage:
     """
     Prepare standard Opus tags for a Tonie file.
     
     Args:
         page: OggPage to modify
-        custom_tags: Whether to use custom TonieToolbox tags instead of default ones
-        bitrate: Actual bitrate used for encoding
-        vbr: Whether variable bitrate was used
-        opus_binary: Path to opusenc binary for version detection
+        custom_tags (bool): Whether to use custom TonieToolbox tags instead of default ones
+        bitrate (int): Actual bitrate used for encoding
+        vbr (bool): Whether variable bitrate was used
+        opus_binary (str | None): Path to opusenc binary for version detection
         
     Returns:
         OggPage: Modified page with Tonie-compatible Opus tags
@@ -162,19 +162,28 @@ def prepare_opus_tags(page, custom_tags=False, bitrate=64, vbr=True, opus_binary
     return page
 
 
-def copy_first_and_second_page(in_file, out_file, timestamp, sha, use_custom_tags=True, bitrate=64, vbr=True, opus_binary=None):
+def copy_first_and_second_page(
+    in_file,
+    out_file,
+    timestamp: int,
+    sha,
+    use_custom_tags: bool = True,
+    bitrate: int = 64,
+    vbr: bool = True,
+    opus_binary: str = None
+) -> None:
     """
     Copy and modify the first two pages of an Opus file for a Tonie file.
     
     Args:
         in_file: Input file handle
         out_file: Output file handle
-        timestamp: Timestamp to use for the Tonie file
+        timestamp (int): Timestamp to use for the Tonie file
         sha: SHA1 hash object to update with written data
-        use_custom_tags: Whether to use custom TonieToolbox tags
-        bitrate: Actual bitrate used for encoding
-        vbr: Whether VBR was used
-        opus_binary: Path to opusenc binary
+        use_custom_tags (bool): Whether to use custom TonieToolbox tags
+        bitrate (int): Actual bitrate used for encoding
+        vbr (bool): Whether VBR was used
+        opus_binary (str | None): Path to opusenc binary
     """
     logger.debug("Copying first and second pages with timestamp %d", timestamp)
     found = OggPage.seek_to_page_header(in_file)
@@ -202,7 +211,7 @@ def copy_first_and_second_page(in_file, out_file, timestamp, sha, use_custom_tag
     logger.debug("Second page written successfully")
 
 
-def skip_first_two_pages(in_file):
+def skip_first_two_pages(in_file) -> None:
     """
     Skip the first two pages of an Opus file.
     
@@ -235,7 +244,7 @@ def skip_first_two_pages(in_file):
     logger.debug("First two pages skipped successfully")
 
 
-def read_all_remaining_pages(in_file):
+def read_all_remaining_pages(in_file) -> list:
     """
     Read all remaining OGG pages from an input file.
     
@@ -260,19 +269,26 @@ def read_all_remaining_pages(in_file):
     return remaining_pages
 
 
-def resize_pages(old_pages, max_page_size, first_page_size, template_page, last_granule=0, start_no=2,
-                set_last_page_flag=False):
+def resize_pages(
+    old_pages: list,
+    max_page_size: int,
+    first_page_size: int,
+    template_page,
+    last_granule: int = 0,
+    start_no: int = 2,
+    set_last_page_flag: bool = False
+) -> list:
     """
     Resize OGG pages to fit Tonie requirements.
     
     Args:
-        old_pages: List of original OggPage objects
-        max_page_size: Maximum size for pages
-        first_page_size: Size for the first page
+        old_pages (list): List of original OggPage objects
+        max_page_size (int): Maximum size for pages
+        first_page_size (int): Size for the first page
         template_page: Template OggPage to use for creating new pages
-        last_granule: Last granule position
-        start_no: Starting page number
-        set_last_page_flag: Whether to set the last page flag
+        last_granule (int): Last granule position
+        start_no (int): Starting page number
+        set_last_page_flag (bool): Whether to set the last page flag
         
     Returns:
         list: List of resized OggPage objects
@@ -326,14 +342,14 @@ def resize_pages(old_pages, max_page_size, first_page_size, template_page, last_
     return new_pages
 
 
-def fix_tonie_header(out_file, chapters, timestamp, sha):
+def fix_tonie_header(out_file, chapters: list, timestamp: int, sha) -> None:
     """
     Fix the Tonie header in a file.
     
     Args:
         out_file: Output file handle
-        chapters: List of chapter page numbers
-        timestamp: Timestamp for the Tonie file
+        chapters (list): List of chapter page numbers
+        timestamp (int): Timestamp for the Tonie file
         sha: SHA1 hash object with file content
     """
     logger.info("Writing Tonie header with %d chapters and timestamp %d", len(chapters), timestamp)
@@ -362,25 +378,36 @@ def fix_tonie_header(out_file, chapters, timestamp, sha):
     logger.debug("Tonie header written successfully (size: %d bytes)", len(header))
 
 
-def create_tonie_file(output_file, input_files, no_tonie_header=False, user_timestamp=None,
-                     bitrate=96, vbr=True, ffmpeg_binary=None, opus_binary=None, keep_temp=False, auto_download=False, 
-                     use_custom_tags=True, no_mono_conversion=False):
+def create_tonie_file(
+    output_file: str,
+    input_files: list[str],
+    no_tonie_header: bool = False,
+    user_timestamp: str = None,
+    bitrate: int = 96,
+    vbr: bool = True,
+    ffmpeg_binary: str = None,
+    opus_binary: str = None,
+    keep_temp: bool = False,
+    auto_download: bool = False,
+    use_custom_tags: bool = True,
+    no_mono_conversion: bool = False
+) -> None:
     """
     Create a Tonie file from input files.
     
     Args:
-        output_file: Output file path
-        input_files: List of input file paths
-        no_tonie_header: Whether to omit the Tonie header
-        user_timestamp: Custom timestamp to use
-        bitrate: Bitrate for encoding in kbps
-        vbr: Whether to use variable bitrate encoding (True) or constant (False)
-        ffmpeg_binary: Path to ffmpeg binary
-        opus_binary: Path to opusenc binary
-        keep_temp: Whether to keep temporary opus files for testing
-        auto_download: Whether to automatically download dependencies if not found
-        use_custom_tags: Whether to use dynamic comment tags generated with toniefile_comment_add
-        no_mono_conversion: Whether to skip mono conversion during audio processing
+        output_file (str): Output file path
+        input_files (list[str]): List of input file paths
+        no_tonie_header (bool): Whether to omit the Tonie header
+        user_timestamp (str | None): Custom timestamp to use
+        bitrate (int): Bitrate for encoding in kbps
+        vbr (bool): Whether to use variable bitrate encoding (True) or constant (False)
+        ffmpeg_binary (str | None): Path to ffmpeg binary
+        opus_binary (str | None): Path to opusenc binary
+        keep_temp (bool): Whether to keep temporary opus files for testing
+        auto_download (bool): Whether to automatically download dependencies if not found
+        use_custom_tags (bool): Whether to use dynamic comment tags generated with toniefile_comment_add
+        no_mono_conversion (bool): Whether to skip mono conversion during audio processing
     """
     from .audio_conversion import get_opus_tempfile
     

TonieToolbox/tonies_json.py

@@ -29,7 +29,7 @@ class ToniesJsonHandlerv1:
         Initialize the handler.
         
         Args:
-            client: TeddyCloudClient instance to use for API communication
+            client (TeddyCloudClient | None): TeddyCloudClient instance to use for API communication
         """    
         self.client = client
         self.custom_json = []
@@ -40,7 +40,7 @@ class ToniesJsonHandlerv1:
         Load tonies.custom.json from the TeddyCloud server.
         
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """          
         if self.client is None:
             logger.error("Cannot load from server: no client provided")
@@ -71,10 +71,10 @@ class ToniesJsonHandlerv1:
         Load tonies.custom.json from a local file.
         
         Args:
-            file_path: Path to the tonies.custom.json file
+            file_path (str): Path to the tonies.custom.json file
             
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """
         try:
             if os.path.exists(file_path):
@@ -109,10 +109,10 @@ class ToniesJsonHandlerv1:
         Save tonies.custom.json to a local file.
         
         Args:
-            file_path: Path where to save the tonies.custom.json file
+            file_path (str): Path where to save the tonies.custom.json file
             
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """
         if not self.is_loaded:
             logger.error("Cannot save tonies.custom.json: data not loaded")
@@ -131,10 +131,13 @@ class ToniesJsonHandlerv1:
             logger.error("Error saving tonies.custom.json to file: %s", e)
             return False
     
-    def renumber_series_entries(self, series: str):
+    def renumber_series_entries(self, series: str) -> None:
         """
         Re-sort and re-number all entries for a series by year (chronological),
         with entries without a year coming last.
+        
+        Args:
+            series (str): Series name to renumber
         """
         # Collect all entries for the series
         series_entries = [entry for entry in self.custom_json if entry.get('series') == series]
@@ -167,12 +170,12 @@ class ToniesJsonHandlerv1:
         If an entry with the same series+episodes exists, the new hash will be added to it.
         
         Args:
-            taf_file: Path to the TAF file
-            input_files: List of input audio files used to create the TAF
-            artwork_url: URL of the uploaded artwork (if any)
+            taf_file (str): Path to the TAF file
+            input_files (list[str]): List of input audio files used to create the TAF
+            artwork_url (str | None): URL of the uploaded artwork (if any)
             
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """
         logger.trace("Entering add_entry_from_taf() with taf_file=%s, input_files=%s, artwork_url=%s", 
                     taf_file, input_files, artwork_url)
@@ -329,12 +332,12 @@ class ToniesJsonHandlerv1:
         2. For entries without years: assign the next available number after those with years
         
         Args:
-            series: Series name
-            episodes: Episodes name
-            year: Release year from metadata, if available
+            series (str): Series name
+            episodes (str): Episodes name
+            year (int | None): Release year from metadata, if available
             
         Returns:
-            Generated entry number as string
+            str: Generated entry number as string
         """
         logger.trace("Entering _generate_entry_no() with series='%s', episodes='%s', year=%s", 
                     series, episodes, year)
@@ -443,10 +446,10 @@ class ToniesJsonHandlerv1:
         Extract a year (1900-2099) from text.
         
         Args:
-            text: The text to extract the year from
+            text (str): The text to extract the year from
             
         Returns:
-            The extracted year as int, or None if no valid year found
+            int | None: The extracted year as int, or None if no valid year found
         """
         import re
         year_pattern = re.compile(r'(19\d{2}|20\d{2})')
@@ -467,11 +470,11 @@ class ToniesJsonHandlerv1:
         Format a number to match the existing entry number format (e.g., with leading zeros).
         
         Args:
-            number: The number to format
-            existing_entries: List of existing entries with their numbers
+            number (int): The number to format
+            existing_entries (list[dict]): List of existing entries with their numbers
             
         Returns:
-            Formatted number as string
+            str: Formatted number as string
         """
         max_digits = 1
         for entry in existing_entries:
@@ -492,7 +495,7 @@ class ToniesJsonHandlerv1:
         Generate a unique model number for a new entry.
         
         Returns:
-            Unique model number in the format "model-" followed by sequential number with zero padding
+            str: Unique model number in the format "model-" followed by sequential number with zero padding
         """
         logger.trace("Entering _generate_model_number()")
         highest_num = -1
@@ -525,10 +528,10 @@ class ToniesJsonHandlerv1:
         Determine the category in v1 format.
         
         Args:
-            metadata: Dictionary containing file metadata
+            metadata (dict): Dictionary containing file metadata
             
         Returns:
-            Category string in v1 format
+            str: Category string in v1 format
         """
         if 'genre' in metadata:
             genre_value = metadata['genre'].lower().strip()
@@ -551,10 +554,10 @@ class ToniesJsonHandlerv1:
         Find an entry in the custom JSON by TAF hash.
         
         Args:
-            taf_hash: SHA1 hash of the TAF file to find
+            taf_hash (str): SHA1 hash of the TAF file to find
             
         Returns:
-            Tuple of (entry, entry_index) if found, or (None, None) if not found
+            tuple[dict | None, int | None]: Tuple of (entry, entry_index) if found, or (None, None) if not found
         """
         logger.trace("Searching for entry with hash %s", taf_hash)
         
@@ -575,11 +578,11 @@ class ToniesJsonHandlerv1:
         Find an entry in the custom JSON by series and episodes.
         
         Args:
-            series: Series name to find
-            episodes: Episodes name to find
+            series (str): Series name to find
+            episodes (str): Episodes name to find
             
         Returns:
-            Tuple of (entry, entry_index) if found, or (None, None) if not found
+            tuple[dict | None, int | None]: Tuple of (entry, entry_index) if found, or (None, None) if not found
         """
         logger.trace("Searching for entry with series='%s', episodes='%s'", series, episodes)
         
@@ -596,10 +599,10 @@ class ToniesJsonHandlerv1:
         Extract metadata from audio files to use in the custom JSON entry.
         
         Args:
-            input_files: List of paths to audio files
+            input_files (list[str]): List of paths to audio files
             
         Returns:
-            Dictionary containing metadata extracted from files
+            dict: Dictionary containing metadata extracted from files
         """
         metadata = {}
         track_descriptions = []
@@ -638,10 +641,10 @@ class ToniesJsonHandlerv1:
         Convert data from v2 format to v1 format.
         
         Args:
-            v2_data: Data in v2 format
+            v2_data (list[dict]): Data in v2 format
             
         Returns:
-            Converted data in v1 format
+            list[dict]: Converted data in v1 format
         """
         v1_data = []
         
@@ -687,10 +690,10 @@ class ToniesJsonHandlerv1:
         Convert category from v2 format to v1 format.
         
         Args:
-            v2_category: Category in v2 format
+            v2_category (str): Category in v2 format
             
         Returns:
-            Category in v1 format
+            str: Category in v1 format
         """
         v2_to_v1_mapping = {
             "music": "music",
@@ -710,7 +713,7 @@ class ToniesJsonHandlerv2:
         Initialize the handler.
         
         Args:
-            client: TeddyCloudClient instance to use for API communication
+            client (TeddyCloudClient | None): TeddyCloudClient instance to use for API communication
         """    
         self.client = client
         self.custom_json = []
@@ -721,7 +724,7 @@ class ToniesJsonHandlerv2:
         Load tonies.custom.json from the TeddyCloud server.
         
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """          
         if self.client is None:
             logger.error("Cannot load from server: no client provided")
@@ -747,10 +750,10 @@ class ToniesJsonHandlerv2:
         Load tonies.custom.json from a local file.
         
         Args:
-            file_path: Path to the tonies.custom.json file
+            file_path (str): Path to the tonies.custom.json file
             
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """
         try:
             if os.path.exists(file_path):
@@ -780,10 +783,10 @@ class ToniesJsonHandlerv2:
         Save tonies.custom.json to a local file.
         
         Args:
-            file_path: Path where to save the tonies.custom.json file
+            file_path (str): Path where to save the tonies.custom.json file
             
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """
         if not self.is_loaded:
             logger.error("Cannot save tonies.custom.json: data not loaded")
@@ -809,12 +812,12 @@ class ToniesJsonHandlerv2:
         If an entry with the same series+episode exists, the new hash will be added to it.
         
         Args:
-            taf_file: Path to the TAF file
-            input_files: List of input audio files used to create the TAF
-            artwork_url: URL of the uploaded artwork (if any)
+            taf_file (str): Path to the TAF file
+            input_files (list[str]): List of input audio files used to create the TAF
+            artwork_url (str | None): URL of the uploaded artwork (if any)
             
         Returns:
-            True if successful, False otherwise
+            bool: True if successful, False otherwise
         """
         logger.trace("Entering add_entry_from_taf() with taf_file=%s, input_files=%s, artwork_url=%s", 
                     taf_file, input_files, artwork_url)
@@ -915,7 +918,7 @@ class ToniesJsonHandlerv2:
         Generate a unique article ID for a new entry.
         
         Returns:
-            Unique article ID in the format "tt-42" followed by sequential number starting from 0
+            str: Unique article ID in the format "tt-42" followed by sequential number starting from 0
         """
         logger.trace("Entering _generate_article_id()")
         highest_num = -1
@@ -948,10 +951,10 @@ class ToniesJsonHandlerv2:
         Extract metadata from audio files to use in the custom JSON entry.
         
         Args:
-            input_files: List of paths to audio files
+            input_files (list[str]): List of paths to audio files
             
         Returns:
-            Dictionary containing metadata extracted from files
+            dict: Dictionary containing metadata extracted from files
         """
         metadata = {}
         track_descriptions = []
@@ -1043,10 +1046,10 @@ class ToniesJsonHandlerv2:
         Find an entry in the custom JSON by TAF hash.
         
         Args:
-            taf_hash: SHA1 hash of the TAF file to find
+            taf_hash (str): SHA1 hash of the TAF file to find
             
         Returns:
-            Tuple of (entry, entry_index, data_index) if found, or (None, None, None) if not found
+            tuple[dict | None, int | None, int | None]: Tuple of (entry, entry_index, data_index) if found, or (None, None, None) if not found
         """
         logger.trace("Searching for entry with hash %s", taf_hash)
         
@@ -1071,11 +1074,11 @@ class ToniesJsonHandlerv2:
         Find an entry in the custom JSON by series and episode.
         
         Args:
-            series: Series name to find
-            episode: Episode name to find
+            series (str): Series name to find
+            episode (str): Episode name to find
             
         Returns:
-            Tuple of (entry, entry_index, data_index) if found, or (None, None, None) if not found
+            tuple[dict | None, int | None, int | None]: Tuple of (entry, entry_index, data_index) if found, or (None, None, None) if not found
         """
         logger.trace("Searching for entry with series='%s', episode='%s'", series, episode)
         
@@ -1096,10 +1099,10 @@ class ToniesJsonHandlerv2:
         Calculate the total runtime in minutes from a list of audio files.
 
         Args:
-            input_files: List of paths to audio files
+            input_files (list[str]): List of paths to audio files
 
         Returns:
-            Total runtime in minutes (rounded to the nearest minute)
+            int: Total runtime in minutes (rounded to the nearest minute)
         """
         logger.trace("Entering _calculate_runtime() with %d input files", len(input_files))
         total_runtime_seconds = 0
@@ -1166,14 +1169,14 @@ def fetch_and_update_tonies_json_v1(client: TeddyCloudClient, taf_file: Optional
     Fetch tonies.custom.json from server and merge with local file if it exists, then update with new entry in v1 format.
     
     Args:
-        client: TeddyCloudClient instance to use for API communication
-        taf_file: Path to the TAF file to add
-        input_files: List of input audio files used to create the TAF
-        artwork_url: URL of the uploaded artwork (if any)
-        output_dir: Directory where to save the tonies.custom.json file (defaults to './output')
+        client (TeddyCloudClient): TeddyCloudClient instance to use for API communication
+        taf_file (str | None): Path to the TAF file to add
+        input_files (list[str] | None): List of input audio files used to create the TAF
+        artwork_url (str | None): URL of the uploaded artwork (if any)
+        output_dir (str | None): Directory where to save the tonies.custom.json file (defaults to './output')
         
     Returns:
-        True if successful, False otherwise
+        bool: True if successful, False otherwise
     """
     logger.trace("Entering fetch_and_update_tonies_json_v1 with client=%s, taf_file=%s, input_files=%s, artwork_url=%s, output_dir=%s",
                 client, taf_file, input_files, artwork_url, output_dir)
@@ -1275,14 +1278,14 @@ def fetch_and_update_tonies_json_v2(client: TeddyCloudClient, taf_file: Optional
     Fetch tonies.custom.json from server and merge with local file if it exists, then update with new entry.
     
     Args:
-        client: TeddyCloudClient instance to use for API communication
-        taf_file: Path to the TAF file to add
-        input_files: List of input audio files used to create the TAF
-        artwork_url: URL of the uploaded artwork (if any)
-        output_dir: Directory where to save the tonies.custom.json file (defaults to './output')
+        client (TeddyCloudClient): TeddyCloudClient instance to use for API communication
+        taf_file (str | None): Path to the TAF file to add
+        input_files (list[str] | None): List of input audio files used to create the TAF
+        artwork_url (str | None): URL of the uploaded artwork (if any)
+        output_dir (str | None): Directory where to save the tonies.custom.json file (defaults to './output')
         
     Returns:
-        True if successful, False otherwise
+        bool: True if successful, False otherwise
     """
     logger.trace("Entering fetch_and_update_tonies_json with client=%s, taf_file=%s, input_files=%s, artwork_url=%s, output_dir=%s",
                 client, taf_file, input_files, artwork_url, output_dir)

TonieToolbox/version_handler.py

@@ -18,15 +18,14 @@ CACHE_FILE = os.path.join(CACHE_DIR, "version_cache.json")
 CACHE_EXPIRY = 86400  # 24 hours in seconds
 
 
-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)
@@ -88,14 +87,13 @@ 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
     """
@@ -133,16 +131,15 @@ 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
@@ -200,7 +197,7 @@ 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.
     
@@ -238,7 +235,7 @@ 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.
     

{tonietoolbox-0.5.1.dist-info → tonietoolbox-0.6.0a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TonieToolbox
-Version: 0.5.1
+Version: 0.6.0a2
 Summary: Create files for the Tonie box and interact with TeddyCloud servers
 Home-page: https://github.com/Quentendo64/TonieToolbox
 Author: Quentendo64
@@ -33,7 +33,7 @@ Dynamic: requires-python
 
 # TonieToolbox 🎵📦
 
-[![Publish to DockerHub](https://github.com/Quentendo64/TonieToolbox/actions/workflows/docker-publish.yml/badge.svg)](https://github.com/Quentendo64/TonieToolbox/actions)
+[![Publish to DockerHub](https://github.com/Quentendo64/TonieToolbox/actions/workflows/publish-to-docker.yml/badge.svg)](https://github.com/Quentendo64/TonieToolbox/actions)
 [![Publish to PyPI](https://github.com/Quentendo64/TonieToolbox/actions/workflows/publish-to-pypi.yml/badge.svg)](https://github.com/Quentendo64/TonieToolbox/actions)
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
@@ -225,7 +225,7 @@ docker run --rm -v "$(pwd)/input:/tonietoolbox/input" -v "$(pwd)/output:/tonieto
 docker run --rm -v "%cd%\input:/tonietoolbox/input" -v "%cd%\output:/tonietoolbox/output" quentendo64/tonietoolbox input/my-audio-file.mp3
 ```
 
-**Or using docker-compose**
+**Or using docker-compose:**
 
 ```shell
 docker-compose run --rm tonietoolbox input/my-audio-file.mp3