# RustPython
A Python Interpreter written in Rust :snake: :scream: :metal:.

[![Build Status](https://travis-ci.org/RustPython/RustPython.svg?branch=master)](https://travis-ci.org/RustPython/RustPython)

# Usage (Not implemented yet)

To test RustPython, do the following:

    $ git clone https://github.com/RustPython/RustPython
    $ cd RustPython
    $ cargo run demo.py
    42

Or use the interactive shell:

    $ cargo run
    Welcome to rustpython
    >>>>> 2+2
    4

Or use pip to install extra modules:

    $ cargo run -m pip install requests

# Goals

- Full python environment entirely in Rust (not CPython bindings)
- A clean implementation without compatibility hacks

# Code organization

    - parser: python lexing, parsing and ast
    - vm: python virtual machine
    - src: using the other subcrates to bring rustpython to life.

The files in the top level directory are from [windelbouwman/rspython][rspython] which contains an implementation of the parser and vm in `src/`

An alternative implementation of python virtual machine that are compatible with CPython parser are from [shinglyu/RustPython][rustpython] and is located in the `VM/` folder.

We are in the process of merging the two implementation to form a single implementation.

# Community

Chat with us on [gitter][gitter].

# Credit

The initial work was based on [windelbouwman/rspython](https://github.com/windelbouwman/rspython) and [shinglyu/RustPython](https://github.com/shinglyu/RustPython)

[rspython]: https://github.com/windelbouwman/rspython
[rustpython]: https://github.com/shinglyu/RustPython
[gitter]: https://gitter.im/rustpython/Lobby