Rust bindings for the python interpreter.
Copyright (c) 2015-2016 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 * Python 3.5
Supported Rust version: * Rust 1.13.0 or later * On Windows, we require rustc 1.15.0-nightly
To use cpython, add this to your Cargo.toml:
toml
[dependencies]
cpython = "0.1"
Example program displaying the value of sys.version:
```rust extern crate cpython;
use cpython::{Python, PyDict, PyResult};
fn main() { let gil = Python::acquire_gil(); hello(gil.python()).unwrap(); }
fn hello(py: Python) -> PyResult<()> { let sys = py.import("sys")?; let version: String = sys.get(py, "version")?.extract(py)?;
let locals = PyDict::new(py);
locals.set_item(py, "os", py.import("os")?)?;
let user: String = py.eval("os.getenv('USER') or os.getenv('USERNAME')", None, Some(&locals))?.extract(py)?;
println!("Hello {}, I'm Python {}", user, version);
Ok(())
} ```
Example library with python bindings:
The following two files will build with cargo build, and will generate a python-compatible library.
On Mac OS, you will need to rename the output from *.dynlib to *.so.
On Windows, you will need to rename the output from *.dll to *.pyd.
Cargo.toml:
```toml
[lib]
name = "rust2py"
crate-type = ["cdylib"]
[dependencies.cpython] path = "../.." features = ["extension-module"] ```
src/lib.rs
```rust
use cpython::{PyResult, Python};
// add bindings to the generated python module
// N.B: names: "librust2py" must be the name of the .so or .pyd file
pymoduleinitializer!(librust2py, initlibrust2py, PyInitlibrust2py, |py, m| {
try!(m.add(py, "doc", "This module is implemented in Rust."));
try!(m.add(py, "sumasstring", pyfn!(py, sumasstring_py(a: i64, b:i64))));
Ok(())
});
// logic implemented as a normal rust function fn sumasstring(a:i64, b:i64) -> String { format!("{}", a + b).to_string() }
// rust-cpython aware function. All of our python interface could be
// declared in a separate module.
// Note that the pyfn!() macro automatically converts the arguments from
// Python objects to Rust values; and the Rust return value back into a Python object.
fn sumasstringpy(: Python, a:i64, b:i64) -> PyResult