55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
rust-cpython [](https://travis-ci.org/dgrunwald/rust-cpython)
|
|
====================
|
|
|
|
[Rust](http://www.rust-lang.org/) bindings for the [python](https://www.python.org/) interpreter.
|
|
|
|
* [Documentation](http://dgrunwald.github.io/rust-cpython/doc/cpython/)
|
|
* Cargo package: [cpython](https://crates.io/crates/cpython)
|
|
|
|
---
|
|
|
|
Copyright (c) 2015 Daniel Grunwald.
|
|
Rust-cpython is licensed under the [MIT license](http://opensource.org/licenses/MIT).
|
|
Python is licensed under the [Python License](https://docs.python.org/2/license.html).
|
|
|
|
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](https://crates.io/crates/cpython) so you can use it like this (in your `Cargo.toml`):
|
|
|
|
```toml
|
|
[dependencies.cpython]
|
|
version = "*"
|
|
```
|
|
|
|
Example program displaying the value of `sys.version`:
|
|
|
|
```rust
|
|
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").unwrap().extract().unwrap();
|
|
|
|
let os = py.import("os").unwrap();
|
|
let getenv = os.get("getenv").unwrap();
|
|
let user: String = getenv.call(("USER",), None).unwrap().extract().unwrap();
|
|
|
|
println!("Hello {}, I'm Python {}", user, version);
|
|
}
|
|
```
|
|
|