mirror of
https://github.com/Virtual-World-RE/NeoGF.git
synced 2024-11-15 08:45:33 +01:00
09581855ff
Added 10 custom exceptions and tests for it; std documentation added
360 lines
15 KiB
Python
360 lines
15 KiB
Python
#!/usr/bin/env python3
|
|
from pathlib import Path
|
|
import os
|
|
import shutil
|
|
from time import time
|
|
from gcmtool import Gcm
|
|
from gcmtool import InvalidDVDMagicError, InvalidUnpackFolderError, InvalidPackIsoError, InvalidFSTSizeError, DolSizeOverflowError, InvalidRootFileFolderCountError, InvalidFSTFileSizeError, FSTDirNotFoundError, FSTFileNotFoundError, BadAlignError
|
|
|
|
|
|
__version__ = "0.0.8"
|
|
__author__ = "rigodron, algoflash, GGLinnk"
|
|
__license__ = "MIT"
|
|
__status__ = "developpement"
|
|
|
|
|
|
##################################################
|
|
# Set roms_path with your ROMs (at the root of the ROM folder)
|
|
# Extract all files from file system using dolphin emu - put it in f"{dolphin_unpack_path}/root/"
|
|
# Extract boot.dol and apploader.img using dolphin emu - put it in f"{dolphin_unpack_path}/sys/"
|
|
##################################################
|
|
roms_path = Path("../ROM")
|
|
dolphin_unpack_path = Path("dolphin_unpack")
|
|
|
|
# Created tmp paths
|
|
unpack_path = Path("unpack")
|
|
unpack2_path = Path("unpack2")
|
|
repack_path = Path("repack")
|
|
# if there is a way to create symlinks on GCM filesystem, it could create strange situations
|
|
|
|
|
|
def test_storage():
|
|
total, used, free = shutil.disk_usage("/")
|
|
if free - 10**10 < 3 * sum(path.stat().st_size for path in roms_path.glob('*') if path.is_file()):
|
|
raise Exception("Error - Not enought free space on the disk to run tests.")
|
|
|
|
|
|
def print_paths_differences(folder1_paths:list, folder2_paths:list):
|
|
backup_paths = folder2_paths.copy()
|
|
for path in folder1_paths:
|
|
if path in folder2_paths:
|
|
folder2_paths.remove(path)
|
|
for path in backup_paths:
|
|
if path in folder1_paths:
|
|
folder1_paths.remove(path)
|
|
print("folder1 diff:")
|
|
for path in folder1_paths:
|
|
print(path)
|
|
print("folder2 diff:")
|
|
for path in folder2_paths:
|
|
print(path)
|
|
|
|
|
|
def compare_files(file1_path:Path, file2_path:Path):
|
|
"Compare two files."
|
|
CLUSTER_LEN = 131072
|
|
with file1_path.open("rb") as file1, file2_path.open("rb") as file2:
|
|
# Init
|
|
bytes1 = file1.read(CLUSTER_LEN)
|
|
bytes2 = file2.read(CLUSTER_LEN)
|
|
while bytes1 or bytes2: # continue if bytes1 and bytes2 have a len > 0
|
|
if bytes1 != bytes2:
|
|
return False
|
|
bytes1 = file1.read(CLUSTER_LEN)
|
|
bytes2 = file2.read(CLUSTER_LEN)
|
|
return True
|
|
|
|
|
|
def compare_GCM(folder1: Path, folder2: Path):
|
|
"""
|
|
Compare two GCM
|
|
-> raise an exception if there is a difference
|
|
"""
|
|
folder1_root_paths = list((folder1 / "root").glob("**/*"))
|
|
folder1_file_count = len(folder1_root_paths)
|
|
print(f"compare \"{folder1}\" - \"{folder2}\" ({folder1_file_count} files)")
|
|
if folder1_file_count == 0:
|
|
raise Exception(f"Error - Empty folder: {folder1}")
|
|
|
|
len1 = len(folder1.parts)
|
|
len2 = len(folder2.parts)
|
|
# 1. Compare names of filesystems
|
|
folder1_paths = [Path(*path.parts[len1:]) for path in folder1_root_paths]
|
|
folder2_paths = [Path(*path.parts[len2:]) for path in (folder2 / "root").glob('**/*')]
|
|
if folder1_paths != folder2_paths:
|
|
print_paths_differences(folder1_paths, folder2_paths)
|
|
raise Exception(f"Error - Folders \"{folder1}\" and \"{folder2}\" are different (not the same folders or files names).")
|
|
# 2. Compare sys files content
|
|
if not compare_files(folder1 / "sys" / "apploader.img", folder2 / "sys" / "apploader.img"):
|
|
raise Exception(f"Error - \"{folder1 / 'sys/apploader.bin'}\" and \"{folder2 / 'sys/apploader.bin'}\" are different.")
|
|
if not compare_files(folder1 / "sys" / "boot.dol", folder2 / "sys" / "boot.dol"):
|
|
raise Exception(f"Error - \"{folder1 / 'sys/boot.bin'}\" and \"{folder2 / 'sys/boot.bin'}\" are different.")
|
|
|
|
for path1 in folder1_root_paths:
|
|
if path1.is_file():
|
|
path2 = folder2/Path(*path1.parts[len1:])
|
|
if not compare_files(path1, path2):
|
|
raise Exception(f"Error - \"{path1}\" and \"{path2}\" are different.")
|
|
|
|
|
|
##################################################
|
|
# gcmtool.py commands wrappers
|
|
##################################################
|
|
def gcmtool_unpack(iso_path:Path, folder_path:Path):
|
|
if os.system(f"python gcmtool.py -u \"{iso_path}\" \"{folder_path}\"") != 0:
|
|
raise Exception("Error while unpacking GCM.")
|
|
def gcmtool_pack(folder_path:Path, iso_path:Path):
|
|
if os.system(f"python gcmtool.py -p \"{folder_path}\" \"{iso_path}\"") != 0:
|
|
raise Exception("Error while packing GCM.")
|
|
def gcmtool_rebuild_fst(folder_path:Path):
|
|
if os.system(f"python gcmtool.py -r \"{folder_path}\"") != 0:
|
|
raise Exception("Error while rebuilding FST.")
|
|
def gcmtool_stats(path:Path):
|
|
if os.system(f"python gcmtool.py -s \"{path}\" > NUL") != 0:
|
|
raise Exception("Error while getting stats.")
|
|
|
|
|
|
TEST_COUNT = 5
|
|
|
|
start = time()
|
|
print("###############################################################################")
|
|
print("# Checking tests folder")
|
|
print("###############################################################################")
|
|
# Check if tests folders exist
|
|
if unpack_path.is_dir() or unpack2_path.is_dir() or repack_path.is_dir():
|
|
raise Exception(f"Error - Please remove:\n-{unpack_path}\n-{unpack2_path}\n-{repack_path}")
|
|
|
|
test_storage()
|
|
print("###############################################################################")
|
|
print(f"# TEST 1/{TEST_COUNT}")
|
|
print("# Comparing roms_path->unpack->[unpack_path] ROMs with [dolphin_unpack_path]")
|
|
print("###############################################################################")
|
|
# unpack ROM in unpack_path
|
|
unpack_path.mkdir(parents=True)
|
|
for iso_path in roms_path.glob("*"):
|
|
if iso_path.is_file():
|
|
gcmtool_unpack(iso_path, unpack_path / iso_path.name)
|
|
|
|
# compare unpack_path dolphin_unpack_path
|
|
for folder_path in unpack_path.glob("*"):
|
|
compare_GCM(folder_path, dolphin_unpack_path / folder_path.name)
|
|
|
|
print("###############################################################################")
|
|
print(f"# TEST 2/{TEST_COUNT}")
|
|
print("# Testing stats on folders & isos")
|
|
print("###############################################################################")
|
|
for iso_path in roms_path.glob("*"):
|
|
if iso_path.is_file():
|
|
gcmtool_stats(iso_path)
|
|
|
|
for folder_path in unpack_path.glob("*"):
|
|
gcmtool_stats(folder_path)
|
|
|
|
print("###############################################################################")
|
|
print(f"# TEST 3/{TEST_COUNT}")
|
|
print("# Comparing [unpack_path]->pack->unpack->[unpack2_path]")
|
|
print("###############################################################################")
|
|
# repack unpack_path repack_path
|
|
repack_path.mkdir()
|
|
unpack_paths = list(unpack_path.glob("*"))
|
|
for folder_path in unpack_paths:
|
|
gcmtool_pack(folder_path, repack_path / folder_path.name)
|
|
|
|
# unpack repack_path unpack2_path
|
|
unpack2_path.mkdir()
|
|
for iso_path in repack_path.glob("*"):
|
|
gcmtool_unpack(iso_path, unpack2_path / iso_path.name)
|
|
|
|
# remove repack_path
|
|
shutil.rmtree(repack_path)
|
|
|
|
# compare unpack_path unpack2_path
|
|
for folder_path in unpack_paths:
|
|
compare_GCM(folder_path, unpack2_path / folder_path.name)
|
|
|
|
# remove unpack2_path
|
|
shutil.rmtree(unpack2_path)
|
|
|
|
print("###############################################################################")
|
|
print(f"# TEST 4/{TEST_COUNT}")
|
|
print("# Comparing [unpack_path]->rebuild_fst->repack->unpack->[unpack2_path]")
|
|
print("###############################################################################")
|
|
# rebuild unpack_path FSTs
|
|
unpack_paths = list(unpack_path.glob("*"))
|
|
for folder_path in unpack_paths:
|
|
gcmtool_rebuild_fst(folder_path)
|
|
|
|
# repack unpack_path repack_path
|
|
repack_path.mkdir()
|
|
for folder_path in unpack_paths:
|
|
gcmtool_pack(folder_path, repack_path / folder_path.name)
|
|
|
|
# unpack repack_path unpack2_path
|
|
unpack2_path.mkdir()
|
|
for iso_path in repack_path.glob("*"):
|
|
gcmtool_unpack(iso_path, unpack2_path / iso_path.name)
|
|
|
|
# compare unpack_path unpack2_path
|
|
for folder_path in unpack_path.glob("*"):
|
|
compare_GCM(folder_path, unpack2_path / folder_path.name)
|
|
|
|
# remove unpack2_path
|
|
shutil.rmtree(unpack_path)
|
|
shutil.rmtree(unpack2_path)
|
|
|
|
print("###############################################################################")
|
|
print(f"# TEST 5/{TEST_COUNT}")
|
|
print("# Testing exceptions.")
|
|
print("###############################################################################")
|
|
gcm = Gcm()
|
|
first_repacked = list(repack_path.glob("*"))[0]
|
|
# change DVD magic
|
|
with first_repacked.open("rb+") as first_repacked_file:
|
|
first_repacked_file.seek(0x1c)
|
|
first_repacked_file.write(b"\xC2\x33\x9F\x3E")
|
|
|
|
try:
|
|
gcm.unpack(first_repacked, unpack2_path / first_repacked.name)
|
|
raise Exception("Error - InvalidDVDMagicError should have been triggered.")
|
|
except InvalidDVDMagicError:
|
|
print("Correct InvalidDVDMagicError triggered.")
|
|
|
|
# restore DVD magic
|
|
with first_repacked.open("rb+") as first_repacked_file:
|
|
first_repacked_file.seek(0x1c)
|
|
first_repacked_file.write(b"\xC2\x33\x9F\x3D")
|
|
|
|
(unpack2_path / first_repacked.stem).mkdir(parents=True)
|
|
try:
|
|
gcm.unpack(first_repacked, unpack2_path / first_repacked.stem)
|
|
raise Exception("Error - InvalidUnpackFolderError should have been triggered.")
|
|
except InvalidUnpackFolderError:
|
|
print("Correct InvalidUnpackFolderError triggered.")
|
|
|
|
shutil.rmtree(unpack2_path)
|
|
|
|
unpack_path.mkdir()
|
|
first_unpacked = unpack_path / "Final Fantasy - Crystal Chronicles (Europe) (En,Fr,De,Es,It).iso"
|
|
gcmtool_unpack(roms_path / first_unpacked.name, first_unpacked)
|
|
try:
|
|
gcm.pack(first_unpacked, first_repacked)
|
|
raise Exception("Error - InvalidPackIsoError should have been triggered.")
|
|
except InvalidPackIsoError:
|
|
print("Correct InvalidPackIsoError triggered.")
|
|
|
|
fst_data = (first_unpacked / "sys/fst.bin").read_bytes()
|
|
(first_unpacked / "sys/fst.bin").write_bytes(fst_data + b"\x00")
|
|
try:
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "except.iso"))
|
|
raise Exception("Error - InvalidFSTSizeError should have been triggered.")
|
|
except InvalidFSTSizeError:
|
|
print("Correct InvalidFSTSizeError triggered.")
|
|
(first_unpacked / "sys/fst.bin").write_bytes(fst_data)
|
|
|
|
(first_unpacked / "root/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").mkdir()
|
|
try:
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "except.iso"))
|
|
raise Exception("Error - InvalidRootFileFolderCountError should have been triggered.")
|
|
except InvalidRootFileFolderCountError:
|
|
print("Correct InvalidRootFileFolderCountError triggered.")
|
|
(first_unpacked / "root/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").rmdir()
|
|
|
|
first_unpacked_file = None
|
|
first_unpacked_dir = None
|
|
for path in (first_unpacked / "root").glob("*"):
|
|
if path.is_file() and first_unpacked_file is None:
|
|
first_unpacked_file = path
|
|
elif path.is_dir() and first_unpacked_dir is None:
|
|
first_unpacked_dir = path
|
|
if first_unpacked_file is not None and first_unpacked_dir is not None:
|
|
break
|
|
|
|
first_unpacked_file_data = first_unpacked_file.read_bytes()
|
|
first_unpacked_file.write_bytes(first_unpacked_file_data + b"\x00")
|
|
try:
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "except.iso"))
|
|
raise Exception("Error - InvalidFSTFileSizeError should have been triggered.")
|
|
except InvalidFSTFileSizeError:
|
|
print("Correct InvalidFSTFileSizeError triggered.")
|
|
first_unpacked_file.write_bytes(first_unpacked_file_data)
|
|
|
|
new_dir = first_unpacked_dir.rename(first_unpacked_dir.parent / (first_unpacked_dir.name +"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"))
|
|
try:
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "except.iso"))
|
|
raise Exception("Error - FSTDirNotFoundError should have been triggered.")
|
|
except FSTDirNotFoundError:
|
|
print("Correct FSTDirNotFoundError triggered.")
|
|
new_dir.rename(first_unpacked_dir)
|
|
|
|
new_file = first_unpacked_file.rename(first_unpacked_file.parent / (first_unpacked_file.name +"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"))
|
|
try:
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "except.iso"))
|
|
raise Exception("Error - FSTFileNotFoundError should have been triggered.")
|
|
except FSTFileNotFoundError:
|
|
print("Correct FSTFileNotFoundError triggered.")
|
|
new_file.rename(first_unpacked_file)
|
|
|
|
try:
|
|
gcm.stats(first_unpacked, 0x800)
|
|
raise Exception("Error - BadAlignError should have been triggered.")
|
|
except BadAlignError:
|
|
print("Correct BadAlignError triggered.")
|
|
|
|
#| 0001ec00 | 0023f9a0 | 00220da0 | boot.dol
|
|
#| 0023fa00 | 00276058 | 00036658 | fst.bin
|
|
# dol size for overflowing on FST + 1: 0023fa00 - 0001ec00 = 220e00
|
|
backup_dol_data = (first_unpacked / "sys/boot.dol").read_bytes()
|
|
with (first_unpacked / "sys/boot.dol").open("rb+") as bootdol_file:
|
|
bootdol_file.seek(0x220e00)
|
|
bootdol_file.write(b"\x00")
|
|
try:
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "except.iso"))
|
|
raise Exception("Error - DolSizeOverflowError should have been triggered.")
|
|
except DolSizeOverflowError:
|
|
print("Correct DolSizeOverflowError triggered.")
|
|
(first_unpacked / "sys/boot.dol").write_bytes(backup_dol_data)
|
|
|
|
with (first_unpacked / "sys/boot.dol").open("rb+") as bootdol_file:
|
|
bootdol_file.seek(0x220dff)
|
|
bootdol_file.write(b"\x00")
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "ok1.iso"))
|
|
print("Correct pack with max dol size before FST.")
|
|
|
|
# patch boot.bin to put fst before dol and make dol overflow on first file
|
|
# fst_len = 00036658 and new offset 0001ec00
|
|
with (first_unpacked / "sys/boot.bin").open("rb+") as bootbin:
|
|
bootbin.seek(0x420) # dol offset
|
|
bootbin.write(b"\x00\x05\x53\x00") # after the FST
|
|
# now seeked on FST offset
|
|
bootbin.write(b"\x00\x01\xEC\x00") # replace the dol
|
|
#| 0001ec00 | 00055258 | 00036658 | fst.bin
|
|
#| 00055300 | ? | ? | boot.dol
|
|
#| 00278000 | 005111de | 002991de | game.MAP
|
|
# max dol size = 00278000 - 00055300 = 222D00
|
|
with (first_unpacked / "sys/boot.dol").open("rb+") as bootdol_file:
|
|
bootdol_file.seek(0x222cff)
|
|
bootdol_file.write(b"\x00")
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "ok2.iso"))
|
|
print("Correct pack with max dol size before first file.")
|
|
|
|
with (first_unpacked / "sys/boot.dol").open("rb+") as first_unpacked_file:
|
|
first_unpacked_file.seek(0x222d00)
|
|
first_unpacked_file.write(b"\x00")
|
|
try:
|
|
gcm.pack(first_unpacked, repack_path / (first_unpacked.stem + "except.iso"))
|
|
raise Exception("Error - DolSizeOverflowError should have been triggered.")
|
|
except DolSizeOverflowError:
|
|
print("Correct DolSizeOverflowError triggered.")
|
|
|
|
# Remove tests folders
|
|
print("###############################################################################")
|
|
print(f"# Cleaning test folders.")
|
|
print("###############################################################################")
|
|
shutil.rmtree(repack_path)
|
|
shutil.rmtree(unpack_path)
|
|
|
|
end = time()
|
|
print("###############################################################################")
|
|
print(f"# All tests are OK - elapsed time: {end - start}")
|
|
print("###############################################################################")
|