PyO3 とは?

公開:
💡 RustとPythonの間で、関数の呼び出しや値の受け渡しをつなぐライブラリ
📌 このページのポイント
PythonからRustの処理を呼ぶ例 Python add(2, 3) 呼び出す側 5 Rust 公開した関数 2 + 3 結果 5 値を渡す PyO3 結果を返す 言語間の値と呼び出しをつなぐ 事前に拡張モジュールのビルド・導入が必要
足し算を公開する拡張モジュールの概念例です。PyO3は値の受け渡しを支えます。RustへPythonを組み込む使い方もあります。
ひよこ ひよこ
Pythonのアプリから、Rustで書いた関数を呼べるの?
ペンギン先生 ペンギン先生
PyO3を使ってPythonの拡張モジュールを作る方法があるよ。Pythonから渡した値をRust側で受け取り、処理結果をPythonへ返せるんだ。
ひよこ ひよこ
Rustのソースを置くだけでimportできる?
ペンギン先生 ペンギン先生
呼び出す関数やモジュールをPyO3で公開する形にして、ビルドとインストールが必要だよ。公式の入門例ではmaturinというツールでその作業を進めるんだ。
ひよこ ひよこ
反対に、RustのアプリでPythonの処理を使うこともできる?
ペンギン先生 ペンギン先生
できるよ。Pythonの実行環境をRustのプログラムに組み込み、Pythonコードを実行する使い方もある。必要なPythonのライブラリなど、組み込み用のビルド条件を整えるんだ。
ひよこ ひよこ
一度作った拡張モジュールは、どのPCにも配れる?
ペンギン先生 ペンギン先生
対象のOSやCPU、Pythonの条件を合わせる必要があるよ。複数のPythonバージョンで使えるようにする選択肢もあるけれど、一つの成果物がどの環境でも動くという意味ではないんだ。
もっと詳しく知りたい人へ

複数のPythonがあると、どれを使ってビルドする?

PyO3は通常、有効な仮想環境、Python 3としてのpython、python3の順に探します。別のPythonを指定したい場合は環境変数PYO3_PYTHONを使います。選んだPythonが、使用するPyO3のバージョンでサポートされていることも確認してください。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「PyO3」って出てきたら「RustとPythonの処理をつなぐライブラリ」と思えばだいたいOK!

参考資料

← 用語集にもどる