236. Protocolo de interfaz del mapper

Crea MapperInterface como un protocolo para los límites bus/mapper.

Lección 236 de 356 · tests/chapter_03_ppu_memory_and_graphics_data/test_236_mapper_interface_protocol.py

Archivo a crear

emulator/cartridge/mapper_interface.py

Protocolo a implementar

MapperInterface

Por qué existe este ayudante

PpuBus no debería depender directamente de Mapper000. Mapper000 es solo un mapper de cartucho. Los mappers posteriores pueden conmutar bancos de PRG/CHR de forma distinta, pero PpuBus solo debería necesitar una pequeña interfaz:

read_prg(addr)
read_chr(addr)

Esto mantiene a PpuBus consciente de los mappers sin hacerlo específico de Mapper000.

¿Qué es un Protocol? Un Protocol describe los métodos que debe proporcionar un objeto. Una clase no necesita heredar del Protocol explícitamente. Si tiene los métodos correctos, coincide con el protocolo de forma estructural.

Pseudocódigo de implementación sugerido

from typing import Protocol


class MapperInterface(Protocol):
    def read_prg(self, addr: int) -> int:
        ...

    def read_chr(self, addr: int) -> int:
        ...

Nota futura

Cuando se implementen las escrituras en CHR RAM, este protocolo podría crecer

write_chr(addr, value)

No lo exijas todavía, porque Mapper000 no implementa escrituras en CHR en esta etapa.

Ejecutar esta lección

uv run pytest tests/chapter_03_ppu_memory_and_graphics_data/test_236_mapper_interface_protocol.py -v

from pathlib import Path from emulator.cartridge.mapper_interface import MapperInterface def test_mapper_interface_file_exists(): """ Objective: Create emulator/cartridge/mapper_interface.py. """ assert Path("emulator/cartridge/mapper_interface.py").exists() def test_mapper_interface_is_protocol_with_required_methods(): """ Objective: Define the small mapper surface area needed by CpuBus/PpuBus. """ assert getattr(MapperInterface, "_is_protocol", False) is True assert hasattr(MapperInterface, "read_prg") assert hasattr(MapperInterface, "read_chr") def test_structural_mapper_can_be_used_without_inheriting_protocol(): """ Objective: Show why Protocol is useful: a mapper only needs matching methods. """ class ExampleMapper: def read_prg(self, addr: int) -> int: return 0xEA def read_chr(self, addr: int) -> int: return 0x12 mapper: MapperInterface = ExampleMapper() assert mapper.read_prg(0x8000) == 0xEA assert mapper.read_chr(0x0000) == 0x12