Skip to main content

Brainfuck to Python AST compilation and integration

Project description - seamless usage of Brainfuck in Python code compiles Brainfuck programs to Python AST, enabling the integration of industial-strength Brainfuck programs with Python code. Example:

>>> import brainfuck
>>> hello = brainfuck.to_function("""
>>> hello()
'Hello World!\n'

For convenience, an import hook is also provided:

>>> brainfuck.install_import_hook()
>>> # Note: programs is a python package (with
    # and a brainfuck file named
>>> from programs import rot13  
>>> rot13.rot13("brainfuck")
>>> # The module can also be called directly
>>> rot13("foobar")


$ pip install python-brainfuck


$ git clone
$ cd brainfuck
$ python install

OR just copy somewhere in your PYTHONPATH.

Platform support

Latest versions of Python 2, 3 and PyPy are supported and tested. Other Python versions that have support for the ast module should work too, but are not tested.

Unit tests

Run tests with $ python


  • Optimizations for the brainfuck-generated AST (this is a big one!)
  • More tests
  • Running tests with tox
  • Python AST to brainfuck compilation (may take some time)


MIT (programs in the programs-directory may be licensed differently)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for python-brainfuck, version 0.9.1
Filename, size File type Python version Upload date Hashes
Filename, size python_brainfuck-0.9.1-py2.py3-none-any.whl (5.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size python-brainfuck-0.9.1.tar.gz (6.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page