maturin 简单试用

前边也简单介绍了maturin 是pyo3 推荐的rust python 模块开发首选工具,以下是一个简单的试用

项目准备

• 初始化项目

mkdir  first

cd first

python -m venv venv

source venv/bin/activate

pip install maturin

maturin init

• 项目结构

├── Cargo.lock

├── Cargo.toml

├── app.py

├── pyproject.toml

└── src

    └── lib.rs

• 代码简单说明
  app.py 是调用开发的模块的，src/lib.rs 是基于pyo3 开发的模块，属于一个动态链接库，pyproject.toml 是推荐的python pip 包开发定义（新版本的）
  src/lib.rs

 

use pyo3::prelude::*;

 

/// Formats the sum of two numbers as string.

// 函数定义

#[pyfunction]

fn sum_as_string(a: usize, b: usize) -> PyResult<String> {

    Ok((a + b).to_string())

}

 

/// A Python module implemented in Rust.   

#[pymodule]

fn first(_py: Python, m: &PyModule) -> PyResult<()> {

    //  注册函数

    m.add_function(wrap_pyfunction!(sum_as_string, m)?)?;

    Ok(())

}

Cargo.toml cargo 配置，主要是pyo3 依赖以及模块类型说明（动态链接库）

[package]

name = "first"

version = "0.1.0"

edition = "2021"

 

[lib]

name = "first"

crate-type = ["cdylib"]

 

[dependencies]

pyo3 = "0.20.0"

pyproject.toml pip 模块定义(定义了后端使用maturin)

[build-system]

requires = ["maturin>=1.4,<2.0"]

build-backend = "maturin"

 

[project]

name = "first"

requires-python = ">=3.8"

classifiers = [

    "Programming Language :: Rust",

    "Programming Language :: Python :: Implementation :: CPython",

    "Programming Language :: Python :: Implementation :: PyPy",

]

dynamic = ["version"]

 

[tool.maturin]

features = ["pyo3/extension-module"]

app.py 主要是对于模块的使用

import first;

result = first.sum_as_string(1,3)

print(result)

构建

maturin 提供了不少命令，我们主要使用的是init ,develop,build,publish 等一些命令

• 开发模式

maturin develop

• 构建

maturin build  --releases

• 运行效果

python app.py

一些问题

• Caused by: Both VIRTUAL_ENV and CONDA_PREFIX are set. Please unset one of them

比如同时使用了虚拟环境，而且电脑也安装了conda 就会提示这个，解决方法，可以临时移除conda 的环境变量
如下

说明

以上是基于cli 工具提供的简单示例，实际上rust 与python 的交互设计的方面很多，可以好好研究下pyo3 rust 包

参考资料

https://www.maturin.rs/
https://github.com/PyO3/maturin
https://github.com/PyO3/pyo3