Function cmd_dump

tools/save_editor.py:600–645

(args: argparse.Namespace)

# ---------------------------------------------------------------------------

def cmd_dump(args: argparse.Namespace) -> int:
    path = Path(args.file) if args.file else default_save_path()
    data = read_save(path)
    if data is None:
        print(f"No save file at: {path}")
        return 1
    print(f"Save file: {path}")
    print(f"  signature        : 0x{data.signature:X}  (expected 0x{SIGNATURE:X})")
    print(f"  stored checksum  : {data.checksum}")
    body = data.pack()[:CHECKSUM_OFFSET]
    expected = compute_checksum(body)
    print(f"  computed checksum: {expected}  ({'OK' if expected == data.checksum else 'BAD'})")
    print(f"  boot count       : {data.boot}")
    print(f"  unlock_mask      : 0x{data.unlock_mask:02X}")
    for name, bit in UNLOCK_BITS.items():
        on = "✓" if data.unlock_mask & (1 << bit) else " "
        print(f"      [{on}] {name}")
    print(f"  fighter_mask     : 0x{data.fighter_mask:04X}")
    for i, name in enumerate(FIGHTERS):
        on = "✓" if data.fighter_mask & (1 << i) else (
            "·" if name in {"Mario", "Fox", "DonkeyKong", "Samus", "Link",
                            "Yoshi", "Kirby", "Pikachu"} else " ")
        print(f"      [{on}] {name}")
    print(f"  ground_mask      : 0x{data.ground_mask:04X}")
    for i, name in enumerate(STAGES):
        on = "✓" if data.ground_mask & (1 << i) else " "
        print(f"      [{on}] {name}")
    print(f"  vs_total_battles : {data.vs_total_battles}")
    print(f"  vs_itemswitch    : {data.vs_itemswitch_battles}")
    print(f"  spgame_difficulty: {data.spgame_difficulty}")
    print(f"  spgame_stocks    : {data.spgame_stock_count}")
    print(f"  sound mode       : {'stereo' if data.sound_mono_or_stereo else 'mono'}")
    print(f"  screen flash on  : {bool(data.is_allow_screenflash)}")
    print(f"  screen offset    : ({data.screen_adjust_h}, {data.screen_adjust_v})")
    print(f"  error_flags      : 0x{data.error_flags:02X}")
    print(f"  characters_fkind : {data.characters_fkind} ({FIGHTERS[data.characters_fkind] if data.characters_fkind < NUM_FIGHTERS else '?'})")
    print()
    print("  1P records:")
    print(f"  {'fighter':<14} {'cleared':>7} {'best-diff':>9} {'hiscore':>8} "
          f"{'BTT(tics)':>9} {'BTT-tasks':>9} {'BTP(tics)':>9} {'BTP-tasks':>9}")
    for i, r in enumerate(data.spgame_records):
        print(f"  {FIGHTERS[i]:<14} {r.is_spgame_complete:>7} "
              f"{r.spgame_best_difficulty:>9} {r.spgame_hiscore:>8} "
              f"{r.bonus1_time:>9} {r.bonus1_task_count:>9} "
              f"{r.bonus2_time:>9} {r.bonus2_task_count:>9}")
    return 0


def cmd_write(args: argparse.Namespace) -> int: