Metadata-Version: 2.1
Name: python-brainfuck
Version: 0.9.1
Summary: Brainfuck to Python AST compilation and integration
Home-page: https://github.com/koirikivi/brainfuck
Author: Rainer Koirikivi
Author-email: rainer@koirikivi.fi
License: MIT
Description: brainfuck.py - seamless usage of Brainfuck in Python code
        =========================================================
        
        brainfuck.py compiles Brainfuck programs to Python AST, enabling the
        integration of industial-strength Brainfuck programs with Python code. Example:
        
        ```python
        >>> import brainfuck
        >>> hello = brainfuck.to_function("""
            ++++++++[>++++[>++>+++>+++>+<<<<-]>+>+>->>+[<]<-]>>
            .>---.+++++++..+++.>>.<-.<.+++.------.--------.>>+.>++.
            """)
        >>> hello()
        'Hello World!\n'
        ```
        
        For convenience, an import hook is also provided:
        
        ```python
        >>> brainfuck.install_import_hook()
        >>> # Note: programs is a python package (with __init__.py
            # and a brainfuck file named rot13.bf)
        >>> from programs import rot13  
        >>> rot13.rot13("brainfuck")
        'oenvashpx'
        >>> # The module can also be called directly
        >>> rot13("foobar")
        'sbbone'
        ```
        
        
        Installation
        ------------
        
        ```
        $ pip install python-brainfuck
        ```
        
        OR
        
        ```
        $ git clone git@github.com:koirikivi/brainfuck.git
        $ cd brainfuck
        $ python setup.py install
        ```
        
        OR just copy ``brainfuck.py`` 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 test_brainfuck.py``
        
        
        TODO
        ----
        
        - 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)
        
        
        License
        -------
        
        MIT (programs in the programs-directory may be licensed differently)
        
Keywords: python brainfuck ast compiler integration
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Compilers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Description-Content-Type: text/markdown
