Esolang Interpreters

Interpreters and generators for esoteric languages. Current work is in the roadmap; contracts and known boundaries are in limitations.

Use

just install-dev
esolangs list
esolangs run Suffolk program.txt
esolangs generate Suffolk "Hello, World!"
just test

The Python API is esolangs.run, generate, and list_languages. Use --width for command-oriented generated programs; grids and newline-sensitive languages retain their own layout.

Examples

esolangs generate 123 "Hi!" emits 76 characters drawn from two digits:

2122221121121121121122212222221121121121121121121121122122221121121121121121

esolangs run 123 on that prints Hi!. tests/test_readme_example.py executes it, so the block cannot drift.

Ready-to-run programs are committed under examples/: examples/hello-world/ holds a "Hello, World!" for each of the 52 languages with a text generator; examples/boolean/ holds a truth-table program for each of the 69 languages with a boolean generator. Both regenerate via scripts/write_examples.py.

Implemented languages

Line remains a standalone PNG-language tool under extra/line; run just test-line for its suite.

Generators

Boolean generators accept a most-significant-input-first binary truth table.

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. 69 of the languages have such a generator, some covering only a documented subset of tables.

Text generators are available through esolangs generate; see esolangs list for support. Regenerate committed examples with python scripts/write_examples.py.

Contributing

Read the contribution guide, then run just test. The project is GPL v3; see LICENSE.