advent-of-code/adventofcode/intcode/README.md

Intcode

Interpreter for the Intcode programming language used in Advent of Code 2019.

Installation

The package is automatically installed with the adventofcode package:

pip install -e .

Usage

from adventofcode.intcode import interpret_intcode, Interpreter

# Simple execution
result = interpret_intcode([1, 0, 0, 0, 99])
print(result.memory)  # [2, 0, 0, 0, 99]

# With stdin
result = interpret_intcode([3, 0, 99, 0], stdin=[42])
print(result.stdout)  # [42]

# For more control, use the Interpreter class
interpreter = Interpreter([3, 9, 8, 9, 10, 9, 4, 9, 99, -1, 8])
interpreter.stdin = [8]
interpreter.interpret()
print(interpreter.stdout)  # [1]

API

interpret_intcode(program, stdin=[])

Execute an Intcode program and return the Interpreter object.

• program: List of integers representing the Intcode program
• stdin: List of integers to use as input

class Interpreter

Intcode interpreter with more control options.

• stdin: List of integers for input
• stdout: List of integers for output
• memory: The program memory
• halted: Boolean indicating if the program has halted
• interpret(break_on_input=False, break_on_output=True): Run the interpreter

Enums

• Operation: ADDITION, MULTIPLICATION, INPUT, OUTPUT, JMP_IF_TRUE, JMP_IF_FALSE, LESS_THAN, EQUALS, BASE, TERMINATION
• Mode: POSITION, IMMEDIATE, RELATIVE