chore: lint and format entire codebase

Run ruff check --fix: remove unused imports (F401), fix f-strings
without placeholders (F541), remove unused variables (F841), fix
duplicate dict key (F601).

Run isort --profile black: normalize import ordering across all files.

Run ruff format: apply consistent formatting (black-compatible) to
all 58 Python files.

3 intentional E402 remain (imports after require_yaml() must execute
after yaml is available).

scripts/exporter/base_exporter.py

@@ -38,7 +38,8 @@ class BaseExporter(ABC):
 
     @staticmethod
     def _display_name(
-        sys_id: str, scraped_sys: dict | None = None,
+        sys_id: str,
+        scraped_sys: dict | None = None,
     ) -> str:
         """Get display name for a system from scraped data or slug."""
         if scraped_sys:
@@ -47,9 +48,28 @@ class BaseExporter(ABC):
                 return name
         # Fallback: convert slug to display name with acronym handling
         _UPPER = {
-            "3do", "cdi", "cpc", "cps1", "cps2", "cps3", "dos", "gba",
-            "gbc", "hle", "msx", "nes", "nds", "ngp", "psp", "psx",
-            "sms", "snes", "stv", "tvc", "vb", "zx",
+            "3do",
+            "cdi",
+            "cpc",
+            "cps1",
+            "cps2",
+            "cps3",
+            "dos",
+            "gba",
+            "gbc",
+            "hle",
+            "msx",
+            "nes",
+            "nds",
+            "ngp",
+            "psp",
+            "psx",
+            "sms",
+            "snes",
+            "stv",
+            "tvc",
+            "vb",
+            "zx",
         }
         parts = sys_id.replace("-", " ").split()
         result = []

scripts/exporter/batocera_exporter.py

@@ -11,8 +11,6 @@ from pathlib import Path
 from .base_exporter import BaseExporter
 
 
-
-
 class Exporter(BaseExporter):
     """Export truth data to Batocera batocera-systems format."""
 
@@ -44,7 +42,9 @@ class Exporter(BaseExporter):
                 continue
 
             native_id = native_map.get(sys_id, sys_id)
-            scraped_sys = scraped_data.get("systems", {}).get(sys_id) if scraped_data else None
+            scraped_sys = (
+                scraped_data.get("systems", {}).get(sys_id) if scraped_data else None
+            )
             display_name = self._display_name(sys_id, scraped_sys)
 
             # Build md5 lookup from scraped data for this system
@@ -74,9 +74,7 @@ class Exporter(BaseExporter):
                 # Original format requires md5 for every entry — skip without
                 if not md5:
                     continue
-                bios_parts.append(
-                    f'{{ "md5": "{md5}", "file": "bios/{dest}" }}'
-                )
+                bios_parts.append(f'{{ "md5": "{md5}", "file": "bios/{dest}" }}')
 
             bios_str = ", ".join(bios_parts)
             line = (

scripts/exporter/emudeck_exporter.py

@@ -156,7 +156,9 @@ class Exporter(BaseExporter):
                         continue
                     md5 = fe.get("md5", "")
                     if isinstance(md5, list):
-                        md5s.extend(m for m in md5 if m and re.fullmatch(r"[a-f0-9]{32}", m))
+                        md5s.extend(
+                            m for m in md5 if m and re.fullmatch(r"[a-f0-9]{32}", m)
+                        )
                     elif md5 and re.fullmatch(r"[a-f0-9]{32}", md5):
                         md5s.append(md5)
                 if md5s:
@@ -195,7 +197,8 @@ class Exporter(BaseExporter):
             # Only flag if the system has usable data for the function type
             if cfg["pattern"] == "md5":
                 has_md5 = any(
-                    fe.get("md5") and isinstance(fe.get("md5"), str)
+                    fe.get("md5")
+                    and isinstance(fe.get("md5"), str)
                     and re.fullmatch(r"[a-f0-9]{32}", fe["md5"])
                     for fe in sys_data["files"]
                 )

scripts/exporter/recalbox_exporter.py

@@ -15,8 +15,6 @@ from pathlib import Path
 from .base_exporter import BaseExporter
 
 
-
-
 class Exporter(BaseExporter):
     """Export truth data to Recalbox es_bios.xml format."""
 
@@ -51,7 +49,9 @@ class Exporter(BaseExporter):
                 continue
 
             native_id = native_map.get(sys_id, sys_id)
-            scraped_sys = scraped_data.get("systems", {}).get(sys_id) if scraped_data else None
+            scraped_sys = (
+                scraped_data.get("systems", {}).get(sys_id) if scraped_data else None
+            )
             display_name = self._display_name(sys_id, scraped_sys)
 
             lines.append(f'  <system fullname="{display_name}" platform="{native_id}">')
@@ -85,7 +85,9 @@ class Exporter(BaseExporter):
 
                 # Build cores string from _cores
                 cores_list = fe.get("_cores", [])
-                core_str = ",".join(f"libretro/{c}" for c in cores_list) if cores_list else ""
+                core_str = (
+                    ",".join(f"libretro/{c}" for c in cores_list) if cores_list else ""
+                )
 
                 attrs = [f'path="{path}"']
                 if md5:
@@ -97,7 +99,7 @@ class Exporter(BaseExporter):
                 if core_str:
                     attrs.append(f'core="{core_str}"')
 
-                lines.append(f'    <bios {" ".join(attrs)} />')
+                lines.append(f"    <bios {' '.join(attrs)} />")
 
             lines.append("  </system>")
 
@@ -125,6 +127,9 @@ class Exporter(BaseExporter):
                 if name.startswith("_") or self._is_pattern(name):
                     continue
                 dest = self._dest(fe)
-                if name.lower() not in exported_paths and dest.lower() not in exported_paths:
+                if (
+                    name.lower() not in exported_paths
+                    and dest.lower() not in exported_paths
+                ):
                     issues.append(f"missing: {name}")
         return issues

scripts/exporter/retrobat_exporter.py

@@ -15,8 +15,6 @@ from pathlib import Path
 from .base_exporter import BaseExporter
 
 
-
-
 class Exporter(BaseExporter):
     """Export truth data to RetroBat batocera-systems.json format."""
 
@@ -47,7 +45,9 @@ class Exporter(BaseExporter):
                 continue
 
             native_id = native_map.get(sys_id, sys_id)
-            scraped_sys = scraped_data.get("systems", {}).get(sys_id) if scraped_data else None
+            scraped_sys = (
+                scraped_data.get("systems", {}).get(sys_id) if scraped_data else None
+            )
             display_name = self._display_name(sys_id, scraped_sys)
             bios_files: list[OrderedDict] = []
 
@@ -70,7 +70,9 @@ class Exporter(BaseExporter):
 
             if bios_files:
                 if native_id in output:
-                    existing_files = {e.get("file") for e in output[native_id]["biosFiles"]}
+                    existing_files = {
+                        e.get("file") for e in output[native_id]["biosFiles"]
+                    }
                     for entry in bios_files:
                         if entry.get("file") not in existing_files:
                             output[native_id]["biosFiles"].append(entry)

scripts/exporter/retrodeck_exporter.py

@@ -170,7 +170,9 @@ class Exporter(BaseExporter):
                 if native_id in manifest:
                     # Merge into existing component (multiple truth systems
                     # may map to the same native ID)
-                    existing_names = {e["filename"] for e in manifest[native_id]["bios"]}
+                    existing_names = {
+                        e["filename"] for e in manifest[native_id]["bios"]
+                    }
                     for entry in bios_entries:
                         if entry["filename"] not in existing_names:
                             manifest[native_id]["bios"].append(entry)

scripts/exporter/systemdat_exporter.py

@@ -58,16 +58,18 @@ class Exporter(BaseExporter):
         ]
         if version:
             lines.append(f"\tversion {version}")
-        lines.extend([
-            '\tauthor "libretro"',
-            '\thomepage "https://github.com/libretro/libretro-database/blob/master/dat/System.dat"',
-            '\turl "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/System.dat"',
-            ")",
-            "",
-            "game (",
-            '\tname "System"',
-            '\tcomment "System"',
-        ])
+        lines.extend(
+            [
+                '\tauthor "libretro"',
+                '\thomepage "https://github.com/libretro/libretro-database/blob/master/dat/System.dat"',
+                '\turl "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/System.dat"',
+                ")",
+                "",
+                "game (",
+                '\tname "System"',
+                '\tcomment "System"',
+            ]
+        )
 
         systems = truth_data.get("systems", {})
         for sys_id in sorted(systems):