pyo3/README.md

rust-cpython

Rust bindings for the python interpreter.

• Documentation
• Cargo package: cpython

---

Copyright (c) 2015 Daniel Grunwald. Rust-cpython is licensed under the MIT license. Python is licensed under the Python License.

Supported Python versions:

• Python 2.7
• Python 3.3
• Python 3.4

Supported Rust version:

• Rust nightly only :(

Usage

cpython is available on crates.io so you can use it like this (in your Cargo.toml):

[dependencies.cpython]
version = "*"

Example program displaying the value of sys.version:

extern crate cpython;

use cpython::{PythonObject, Python};
use cpython::ObjectProtocol; //for call method

fn main() {
    let gil = Python::acquire_gil();
    let py = gil.python();

    let sys = py.import("sys").unwrap();
    let version: String = sys.get("version", py).unwrap().extract(py).unwrap();

    let os = py.import("os").unwrap();
    let getenv = os.get("getenv", py).unwrap();
    let user: String = getenv.call(("USER",), None, py).unwrap().extract(py).unwrap();

    println!("Hello {}, I'm Python {}", user, version);
}