208. Instrucción nop

implementar la operación NOP.

Lección 208 de 356 · tests/chapter_01_cpu/test_208_instruction_nop.py

Por qué existe este paso

En este paso, añade `emulator/cpu/instructions.py::nop`. La no-operación explícita proporciona a la instrucción oficial una función invocable, dejando las cuestiones de obtención del opcode a CPU.step.

Implementación sugerida

def nop(cpu: CPU):
    pass

Invariante: una llamada directa no cambia ningún registro, bit de P, S, PC ni la memoria. El error conceptual habitual es incrementar PC dentro de `nop`; el despacho ya ha obtenido el opcode, y la operación en sí no posee ningún byte.

Fuera de alcance: importar NOP y mapear el opcode oficial $EA en `emulator/cpu/opcodes.py::OPCODE_TABLE` corresponde al paso 209. No se introducen variantes no oficiales de NOP, cambios de temporización ni funciones de trazado posteriores.

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_208_instruction_nop.py -v

Implementación de ejemplo

Implementación sugerida

def nop(cpu: CPU):
    pass

Ver código del testtest_208_instruction_nop.py

from emulator.cpu.instructions import nop
from tests.helpers import make_cpu


def test_nop_does_not_modify_registers():
    """Objective: NOP does not modify A, X, or Y."""
    cpu = make_cpu()
    cpu.a = 0x11
    cpu.x = 0x22
    cpu.y = 0x33

    nop(cpu)

    assert cpu.a == 0x11
    assert cpu.x == 0x22
    assert cpu.y == 0x33


def test_nop_does_not_modify_stack_pointer():
    """Objective: NOP does not touch S."""
    cpu = make_cpu()
    cpu.s = 0xFD

    nop(cpu)

    assert cpu.s == 0xFD


def test_nop_does_not_modify_program_counter_when_called_directly():
    """
    Objective:
    nop(cpu) itself does not change PC.

    CPU.step() changes PC when it fetches the opcode. The instruction function
    should not add another increment.
    """
    cpu = make_cpu()
    cpu.pc = 0x8001

    nop(cpu)

    assert cpu.pc == 0x8001


def test_nop_does_not_modify_status_flags():
    """Objective: NOP preserves the processor status register P."""
    cpu = make_cpu()
    cpu.p = 0b1100_1111

    nop(cpu)

    assert cpu.p == 0b1100_1111


def test_nop_does_not_modify_memory():
    """Objective: NOP does not read/write data memory as part of instruction logic."""
    cpu = make_cpu()
    cpu.bus.write(0x0002, 0x42)

    nop(cpu)

    assert cpu.bus.read(0x0002) == 0x42

Funciones de test (5)

test_nop_does_not_modify_registers
test_nop_does_not_modify_stack_pointer
test_nop_does_not_modify_program_counter_when_called_directly
test_nop_does_not_modify_status_flags
test_nop_does_not_modify_memory