PyO3 是一个强大的工具，它为 Rust 开发者提供了一种与 Python 世界无缝交互的方式。无论你想用 Rust 编写 Python 模块，还是将 Python 集成到 Rust 程序中，PyO3 都能满足你的需求。
PyO3 的优势：
• 高效便捷： PyO3 允许你直接在 Rust 代码中调用 Python 函数，并使用 Python 对象。
• 灵活强大： PyO3 提供了丰富的 API，可以让你轻松创建 Python 模块、定义类和方法、处理异常等。
• 安全可靠： PyO3 充分利用了 Rust 的安全特性，确保你的代码安全、可靠。
• 活跃社区： PyO3 拥有活跃的社区和完善的文档，你可以轻松找到解决问题的帮助。
使用场景：
• 用 Rust 编写 Python 模块： 如果你需要用 Rust 的性能优势来加速你的 Python 代码，PyO3 是你最好的选择。例如，你可以使用 Rust 实现计算密集型的算法，然后将其作为 Python 模块使用。
• 将 Python 集成到 Rust 程序： 如果你需要在 Rust 程序中使用 Python 的库或功能，PyO3 可以让你轻松实现。例如，你可以使用 Python 的数据分析库进行数据处理，然后将结果返回给你的 Rust 程序。
如何开始使用 PyO3：
一、用 Rust 编写 Python 模块
PyO3 提供了多种方式来创建 Python 模块。其中最简单的方式是使用 maturin 工具。maturin 可以帮助你快速创建、构建和发布 Rust 驱动的 Python 包。
1. 安装
maturin：
python -m venv .env
source .env/bin/activate
pip install maturin1. 初始化项目：
maturin init --bindings pyo31. 编写 Rust 代码：
在 src/lib.rs 文件中编写你的 Rust 代码，使用 pyo3 提供的宏来定义 Python 函数和类。
use pyo3::prelude::*;
#[pyfunction]
fnsum_as_string(a:usize, b:usize)->PyResult<String>{
Ok((a + b).to_string())
}
#[pymodule]
fnstring_sum(m:&PyModule)->PyResult<()>{
m.add_function(wrap_pyfunction!(sum_as_string, m)?)?;
Ok(())
}1. 构建和发布：
maturin develop二、将 Python 集成到 Rust 程序
使用 PyO3，你可以在 Rust 程序中嵌入 Python 解释器，并调用 Python 代码。
1. 安装 Python 开发包：
sudo apt install python3-dev2. 添加依赖项：
在 Cargo.toml 文件中添加 pyo3 依赖项，并启用 auto-initialize 特性。
[dependencies]
pyo3 = { version = "0.22.2", features = ["auto-initialize"] }3. 编写 Rust 代码：
使用 Python::with_gil 获取 Python 全局解释器锁，然后就可以使用 pyo3 API 调用 Python 代码。
use pyo3::prelude::*;
use pyo3::types::IntoPyDict;
use pyo3::ffi::c_str;
fnmain()->PyResult<()>{
Python::with_gil(|py|{
letsys= py.import("sys")?;
letversion:String= sys.getattr("version")?.extract()?;
letlocals=[("os", py.import("os")?)].into_py_dict(py);
letcode= c_str!("os.getenv('USER') or os.getenv('USERNAME') or 'Unknown'");
letuser:String= py.eval(code,None,Some(&locals))?.extract()?;
println!("Hello {}, I'm Python {}", user, version);
Ok(())
})
}总结：
PyO3 是一个强大的工具，它可以帮助 Rust 开发者轻松地与 Python 世界交互。无论是编写 Python 模块还是在 Rust 程序中嵌入 Python，PyO3 都能提供高效、灵活、安全可靠的解决方案。
项目地址： https://github.com/PyO3/pyo3
