227. Fábrica por defecto de PPU en CpuBus

Añadir una PPU por defecto a CpuBus.

Lección 227 de 356 · tests/chapter_03_ppu_memory_and_graphics_data/test_227_cpu_bus_ppu_default_factory.py

Archivo a actualizar

emulator/bus/cpu_bus.py

Qué añadir

CpuBus should own a PPU instance.

Por qué existe este paso

La CPU de la NES se comunica con la PPU mediante registros mapeados en memoria. Antes de que CpuBus pueda enrutar lecturas/escrituras en $2000-$3FFF, el bus necesita un objeto PPU al que reenviar esos accesos.

Decisión de diseño importante

Usa default_factory en lugar de PPU() directamente en el campo de la dataclass.

Por qué

Cada CpuBus debe obtener su propia instancia de PPU. Compartir una única PPU mutable entre instancias de bus crearía un acoplamiento oculto entre pruebas e instancias del emulador.

Pseudocódigo de implementación sugerido

from dataclasses import dataclass, field
from emulator.ppu.ppu import PPU


@dataclass
class CpuBus:
    ...
    ppu: PPU = field(default_factory=PPU)

Ejecutar esta lección

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

Implementación de ejemplo

Pseudocódigo de implementación sugerido

from dataclasses import dataclass, field
from emulator.ppu.ppu import PPU


@dataclass
class CpuBus:
    ...
    ppu: PPU = field(default_factory=PPU)

Ver código del testtest_227_cpu_bus_ppu_default_factory.py

from emulator.bus.cpu_bus import CpuBus
from emulator.ppu.ppu import PPU


def test_cpu_bus_has_default_ppu_instance():
    """
    Objective:
    CpuBus should have a PPU available by default.
    """
    bus = CpuBus()

    assert isinstance(bus.ppu, PPU)


def test_each_cpu_bus_gets_its_own_ppu_instance():
    """
    Objective:
    Avoid shared mutable PPU state between CpuBus instances.

    Why:
    If two buses accidentally share the same PPU, one test or emulator instance
    could change PPU state observed by another. That kind of hidden coupling is
    difficult to debug.
    """
    first_bus = CpuBus()
    second_bus = CpuBus()

    assert first_bus.ppu is not second_bus.ppu


def test_cpu_bus_allows_injecting_specific_ppu_instance():
    """
    Objective:
    Tests and future emulator orchestration should be able to provide a specific
    PPU instance.

    Why:
    This makes integration tests easier because they can inspect the exact PPU
    object connected to the bus.
    """
    ppu = PPU()

    bus = CpuBus(ppu=ppu)

    assert bus.ppu is ppu

Funciones de test (3)

test_cpu_bus_has_default_ppu_instance
test_each_cpu_bus_gets_its_own_ppu_instance
test_cpu_bus_allows_injecting_specific_ppu_instance