lastgenre: Type alias GenresWithLabel

Author: JOJ0

beetsplug/lastgenre/__init__.py

@@ -42,6 +42,10 @@
     """Genre hierarchy as list of paths from general to specific.
     Example: [['electronic', 'house'], ['electronic', 'techno']]"""
 
+    GenresWithLabel = tuple[list[str], str]
+    """A pair of (genre list, label) returned by a genre resolution stage.
+    The label is used for logging and describes the source and filtering applied."""
+
 
 # Canonicalization tree processing.
 
@@ -442,7 +446,7 @@ def _combine_resolve_and_log(
         return self._resolve_genres(combined, artist=artist)
 
     @cached_property
-    def fallback(self) -> tuple[list[str], str]:
+    def fallback(self) -> GenresWithLabel:
         """Return the configured fallback genre and label."""
         if fallback := self.config["fallback"].get():
             return [fallback], "fallback"
@@ -454,7 +458,7 @@ def _try_resolve_stage(
         keep_genres: list[str],
         new_genres: list[str],
         artist: str | None = None,
-    ) -> tuple[list[str], str] | None:
+    ) -> GenresWithLabel | None:
         """Try to resolve genres for a given stage and log the result.
 
         If any newly fetched genres and/or existing genres are resolved, return
@@ -474,7 +478,7 @@ def _try_resolve_stage(
 
     def _try_resolve_existing_genres(
         self, obj: LibModel, genres: list[str]
-    ) -> tuple[list[str], str] | None:
+    ) -> GenresWithLabel | None:
         """Handle existing genres when not forcing.
 
         Clean up existing genres if enabled, or return them unchanged. Return
@@ -487,11 +491,11 @@ def _try_resolve_existing_genres(
                 "cleanup", keep_genres, [], artist=self._artist_for_filter(obj)
             )
 
-        return genres, "keep any, no-force"
+        return genres, "keep any, no-force"  # type: ignore
 
     def _try_resolve_original_fallback(
         self, obj: LibModel, genres: list[str], keep_genres: list[str]
-    ) -> tuple[list[str], str] | None:
+    ) -> GenresWithLabel | None:
         """Attempt to fall back to existing original genres if configured.
 
         ``genres`` are the original unchanged values and are checked as-is
@@ -533,9 +537,7 @@ def _fetch_va_genres(self, album: Album) -> list[str]:
 
         return []
 
-    def _fetch_artist_stage(
-        self, obj: LibModel
-    ) -> tuple[str, list[str], str | None]:
+    def _fetch_artist_stage(self, obj: LibModel) -> GenresWithLabel:
         """Fetch artist genres for an Item or Album object.
 
         Return a tuple of ``(stage_label, genres, stage_artist)``.
@@ -572,7 +574,7 @@ def _fetch_artist_stage(
 
         return "most popular track", [], None
 
-    def _get_genre(self, obj: LibModel) -> tuple[list[str], str]:
+    def _get_genre(self, obj: LibModel) -> GenresWithLabel:
         """Get the final genre list for an Album or Item object.
 
         `self.sources` specifies allowed genre sources. Starting with the first