215. Dataclass de la ROM iNES

añade

Lección 215 de 356 · tests/chapter_02_rom_loading/test_215_ines_rom_dataclass.py

añade emulator/cartridge/ines.py::INesRom.

Por qué existe este paso

Este resultado inmutable del analizador mantiene juntos la cabecera interpretada y las secciones de programa y gráficos extraídas, de modo que parse_ines_rom no necesite devolver valores sueltos. Se construye sobre el modelo de cabecera y el analizador de las lecciones 213-214.

Implementación sugerida tras parse_ines_header:

@dataclass(frozen=True)
class INesRom:
    header: INesHeader
    prg_rom: bytes
    chr_rom: bytes

Invariantes: el orden de los campos es header, prg_rom, chr_rom; ambas cargas útiles son de tipo bytes; y la dataclass es inmutable (frozen) porque describe el contenido del archivo. No confundas este resultado a nivel de formato con el Cartridge orientado al emulador.

Fuera de alcance para este paso

1. Lesson 216 calculates offsets, skips trainers, and validates payload size.
2. Lesson 217 introduces the emulator-facing `Cartridge`.
3. Lessons 218-219 implement mapper address translation.

Ejecutar esta lección

uv run pytest tests/chapter_02_rom_loading/test_215_ines_rom_dataclass.py -v

Implementación de ejemplo

Por qué existe este paso

@dataclass(frozen=True)
class INesRom:
    header: INesHeader
    prg_rom: bytes
    chr_rom: bytes

Ver código del testtest_215_ines_rom_dataclass.py

import dataclasses
import importlib


def test_ines_rom_class_exists_and_is_frozen_dataclass():
    """
    Objective:
    Create INesRom as a frozen dataclass.

    Why frozen:
    Parsed ROM sections are facts extracted from the file. They should not be
    mutated by the parser result object.
    """
    ines = importlib.import_module("emulator.cartridge.ines")

    assert hasattr(ines, "INesRom")
    assert dataclasses.is_dataclass(ines.INesRom)
    assert ines.INesRom.__dataclass_params__.frozen is True


def test_ines_rom_has_required_fields_in_order():
    """Objective: INesRom stores header, PRG ROM, and CHR ROM."""
    ines = importlib.import_module("emulator.cartridge.ines")

    assert list(ines.INesRom.__dataclass_fields__) == [
        "header",
        "prg_rom",
        "chr_rom",
    ]


def test_ines_rom_can_store_header_prg_and_chr_bytes():
    """
    Objective:
    INesRom should group parsed metadata with extracted ROM byte sections.
    """
    ines = importlib.import_module("emulator.cartridge.ines")
    header = ines.INesHeader(1, 1, 0, False, 0x00, 0x00)

    rom = ines.INesRom(
        header=header,
        prg_rom=bytes([0xA9, 0x42]),
        chr_rom=bytes([0x00, 0x01]),
    )

    assert rom.header is header
    assert rom.prg_rom == bytes([0xA9, 0x42])
    assert rom.chr_rom == bytes([0x00, 0x01])

Funciones de test (3)

test_ines_rom_class_exists_and_is_frozen_dataclass
test_ines_rom_has_required_fields_in_order
test_ines_rom_can_store_header_prg_and_chr_bytes