Esolang Interpreters

Interpreters and Boolean generators for 81 esoteric languages: 78 text and 3 raster.

generate builds a truth-table program; run executes it on one input row.

Concepts

The task is uniform across languages: compute a Boolean function from its truth table, then verify the answer by running the generated program. generate turns a table into a program; encode_inputs builds the stdin one input row needs; run executes it; read_answer returns the 0/1 bit. describe reports how a language takes its input and where its answer lands. Languages that embed their inputs in the source return a template to fill with instantiate instead.

Quickstart

A table lists outputs for inputs 00, 01, 10, 11 in order, so 0110 is XOR:

pip install esolangs
esolangs generate brainfuck 0110 > xor.bf
for i in 00 01 10 11; do printf $i | esolangs run --timeout 5 brainfuck xor.bf; echo " <- $i"; done
# 0 <- 00
# 1 <- 01
# 1 <- 10
# 0 <- 11

Start with the CLI or Python API. The usage guide covers inputs, templates, answers, and debugging. Limitations records contracts; the roadmap tracks open work.

Command line

python -m pip install esolangs

esolangs --help
esolangs list
esolangs generate brainfuck 0110 > bf.txt
printf '01' | esolangs debug --steps 20 --watch-cell 0 brainfuck bf.txt

• Suffolk:

  esolangs generate Suffolk 0110 > program.txt
  printf '01' | esolangs run Suffolk program.txt
  

• Polynomial needs the optional mathematics extra: pip install 'esolangs[math]'.

PNG loading and saving need pip install 'esolangs[image]'; in-memory raster programs need neither extra.

Python API

import esolangs

program = esolangs.generate("brainfuck", "0110")
stdin = esolangs.encode_inputs("brainfuck", [0, 1])
output = esolangs.run("brainfuck", program, stdin=stdin, max_steps=10_000)
assert esolangs.read_answer("brainfuck", output) == "1"

Use max_steps to bound commands, or timeout to bound wall time. On Windows or worker threads, use isolated=True, timeout=5; isolation also supports max_output and Linux-only max_memory limits.

• Suffolk source may run as brainfuck with a wrong answer.

Use encode_inputs to build stdin.

Examples

esolangs generate FALSE 0110 emits 22 characters computing XOR:

^1&$[^'0=_.]?0=[^1&.]?

Feeding it the two adjacent input characters prints their XOR.

Ready-to-run programs for each of the 78 languages with a boolean generator live in each language's directory.

Implemented languages

Familiar languages include:

• brainfuck
• Befunge
• Piet
• INTERCAL
• Malbolge

See the complete language catalog.

Generators

The truth table is a binary string of length 2**n, most-significant input first; its length implies n, so it isn't passed separately. 78 of the languages have such a generator, some covering only a documented subset of tables.

esolangs list --details marks generators (gen), templates (tmpl), and committed examples (ex). See the usage guide for input conventions and benchmarking.

Contributing

See contributing for setup, verification and the execution path. The project is GPL v3; see LICENSE.