RustPython is an open-source Python 3 interpreter written entirely in Rust, designed to provide a clean and efficient implementation without relying on CPython bindings.
It offers a robust platform for running Python code in various environments, including WebAssembly (WASM) and embedded Rust applications.
Key Features And Usage
- Python 3 Compatibility: RustPython supports Python 3.12 and aims to provide a full Python environment implemented in Rust.
- WebAssembly Support: The interpreter can be compiled into a standalone WASI module, enabling Python code execution in web browsers or other WASI-compatible environments.
- Interactive Shell: Users can launch an interactive Python shell using the command
$ cargo run --release
, allowing immediate execution of Python commands. - JIT Compiler: RustPython includes an experimental Just-In-Time (JIT) compiler that converts Python functions into native machine code for faster execution. This feature can be enabled using the
jit
flag during compilation. - Embedding in Rust Applications: Developers can integrate RustPython into Rust projects to enable Python scripting capabilities, making it ideal for applications requiring dynamic logic adjustments.
To use RustPython, the latest stable version of Rust must be installed. After cloning the repository (git clone https://github.com/RustPython/RustPython
), users can build and run the interpreter locally.
For Windows users, setting the RUSTPYTHONPATH
environment variable is necessary to specify the library path.
Additionally, RustPython can be installed via Cargo or Conda (though Conda packages may be outdated). For HTTPS requests and package management with pip
, enabling the SSL feature is required.
- WebAssembly Compilation:
- Compile using:
bash cargo build --target wasm32-wasip1 --features="freeze-stdlib"
- Run with tools like Wasmer or WAPM.
- JIT Compilation:
- Enable with:
bash cargo run --features jit
- Compile functions dynamically using
__jit__()
in Python scripts.
- Documentation Generation:
- Generate local documentation with
cargo doc
.
RustPython has been utilized in various projects, including:
- GreptimeDB: A distributed time-series database.
- pyckitup: A game engine.
- Ruff: A fast Python linter written in Rust.
While still under development and not fully production-ready, RustPython is a versatile tool for developers seeking to merge Python’s flexibility with Rust’s performance and safety.