"""Run the retained Proton 7 script safely on Python 3.14.

Proton 7 predates Python's tar extraction-filter API.  The known-good v41
runtime used this compatibility shim; keeping it in the harness makes the
exact launch recipe inspectable and reproducible.
"""

from __future__ import annotations

from pathlib import Path
import runpy
import sys
import tarfile
from typing import Sequence


def main(argv: Sequence[str] | None = None) -> None:
	arguments = list(sys.argv[1:] if argv is None else argv)
	if not arguments:
		raise SystemExit("usage: proton_compat.py /path/to/proton [arguments...]")
	proton = Path(arguments[0]).expanduser().resolve(strict=True)
	proton_directory = str(proton.parent)
	if proton_directory not in sys.path:
		sys.path.insert(0, proton_directory)
	if hasattr(tarfile, "fully_trusted_filter"):
		tarfile.TarFile.extraction_filter = staticmethod(tarfile.fully_trusted_filter)
	sys.argv = [str(proton), *arguments[1:]]
	runpy.run_path(str(proton), run_name="__main__")


if __name__ == "__main__":
	main()