mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-04-13 12:22:33 -05:00
0a272dc4e9
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).
82 lines
2.2 KiB
Python
82 lines
2.2 KiB
Python
"""Abstract base class for platform exporters."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from abc import ABC, abstractmethod
|
|
|
|
|
|
class BaseExporter(ABC):
|
|
"""Base class for exporting truth data to native platform formats."""
|
|
|
|
@staticmethod
|
|
@abstractmethod
|
|
def platform_name() -> str:
|
|
"""Return the platform identifier this exporter targets."""
|
|
|
|
@abstractmethod
|
|
def export(
|
|
self,
|
|
truth_data: dict,
|
|
output_path: str,
|
|
scraped_data: dict | None = None,
|
|
) -> None:
|
|
"""Export truth data to the native platform format."""
|
|
|
|
@abstractmethod
|
|
def validate(self, truth_data: dict, output_path: str) -> list[str]:
|
|
"""Validate exported file against truth data, return list of issues."""
|
|
|
|
@staticmethod
|
|
def _is_pattern(name: str) -> bool:
|
|
"""Check if a filename is a placeholder pattern (not a real file)."""
|
|
return "<" in name or ">" in name or "*" in name
|
|
|
|
@staticmethod
|
|
def _dest(fe: dict) -> str:
|
|
"""Get destination path for a file entry, falling back to name."""
|
|
return fe.get("path") or fe.get("destination") or fe.get("name", "")
|
|
|
|
@staticmethod
|
|
def _display_name(
|
|
sys_id: str,
|
|
scraped_sys: dict | None = None,
|
|
) -> str:
|
|
"""Get display name for a system from scraped data or slug."""
|
|
if scraped_sys:
|
|
name = scraped_sys.get("name")
|
|
if name:
|
|
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",
|
|
}
|
|
parts = sys_id.replace("-", " ").split()
|
|
result = []
|
|
for p in parts:
|
|
if p.lower() in _UPPER:
|
|
result.append(p.upper())
|
|
else:
|
|
result.append(p.capitalize())
|
|
return " ".join(result)
|