【まちゅりん】

maturin とは?

最終更新:
💡 Rustのコードを、Python用のパッケージに組み立てるツール
📌 このページのポイント
Rustの成果物をPython用に組み立てる Rust ソース maturin ビルド build develop .whl 配布用ファイル 現在の仮想環境 モジュールを導入 公開は別の操作 開発中に試す
buildはwheelを作り、developは現在の仮想環境へ導入します。PyO3などを使った言語連携のコードを、maturinがビルドする関係です。
ひよこ ひよこ
Rustで書いた処理を、Pythonから使いたいんだ。
ペンギン先生 ペンギン先生
PyO3でPythonから呼べる形を用意し、maturinでビルドする方法があるよ。Rustのコードを組み立てて、Pythonのパッケージとして扱えるようにするんだ。
ひよこ ひよこ
まだ配らず、自分の環境だけで試すには?
ペンギン先生 ペンギン先生
開発用のPython仮想環境を有効にしてmaturin developを使うよ。その環境へビルドしたモジュールが入る。Rustのコードを変えたら、もう一度実行して作り直すんだ。
ひよこ ひよこ
ほかの人に配るファイルを作るには?
ペンギン先生 ペンギン先生
maturin buildでwheelという配布ファイルを作るよ。標準の保存先はtarget/wheels。できたwheelを対象の環境で確かめ、その後に公開先へアップロードする流れだね。
ひよこ ひよこ
PyO3とmaturinは、同じものではないんだね?
ペンギン先生 ペンギン先生
そう。PyO3はRustとPythonの間で値や呼び出しをつなぐライブラリ、maturinは成果物を組み立てる道具だよ。maturinにはPyO3以外の連携方式や、Rustの実行ファイルをパッケージにする用途もあるんだ。
もっと詳しく知りたい人へ

developで動けば、配布用wheelの確認は省いてよい?

省かないでください。公式ガイドは、developではbuild後にpipでインストールする場合の全機能を扱えないと説明しています。配布する場合は、作ったwheelを対象の環境へインストールして確認します。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「maturin」って出てきたら「Rustで作ったものをPython用に組み立てる道具」と思えばだいたいOK!

参考資料

← 用語集にもどる