インストール

juiz コマンドの入れ方は 2 通りあります。使う言語で選んでください。

使う言語	入れ方	Rust のツールチェーン
Python だけ	pip install juiz-cli	不要
Rust・C++(Python も併用可)	cargo install juiz_app	必要

Python だけを使う場合

PyPI の juiz-cli を入れると、juiz コマンドと、Process を書くための pyjuiz(import juiz)の両方が入ります。Rust のツールチェーンは要りません。

必要なもの:

• Python 3.10 以降
• Linux(x86_64・aarch64)、macOS(Apple シリコン・Intel)、Windows(x86_64)のいずれか

python3 -m venv .venv
source .venv/bin/activate        # Windows では .venv\Scripts\activate
pip install juiz-cli
juiz --help

juiz コマンドは venv の中に入ります。以降は、この venv を有効にしたターミナルで juiz を実行してください。

注意

pip で入れた juiz は、juiz の CI でビルドしたものです。手元でビルドした Rust のプラグイン(Rust で書いた Process や、QUIC ブローカーなど)は、コンパイラの版がそろわないため読み込めません。 Rust や C++ でも書く場合は、次の cargo install juiz_app を使ってください。

Rust・C++ を使う場合

必要なもの:

• Linux または macOS
• Rust 1.81 以降(rustup でインストール)
• C++ で機能要素を書く場合: CMake と C++17 対応のコンパイラ
• Python で機能要素も書く場合: Python 3 と開発用ヘッダー(Ubuntu なら sudo apt install python3-dev python3-venv)

crates.io で公開されている juiz_app をインストールします。

cargo install juiz_app

juiz コマンドが ~/.cargo/bin に入ります。

Python の Process も使う

この juiz で Python の Process も動かすときは、PyPI の pyjuiz だけ を追加します。 juiz コマンドはビルド時に見つけた Python を組み込むので、同じ Python で venv を作ってください。

python3 -m venv .venv
source .venv/bin/activate
pip install pyjuiz

注意

この venv には juiz-cli を入れないでください。juiz コマンドが 2 つになり、どちらが動くかが PATH の順番で決まってしまいます。

言語ごとのパッケージ

Rust

機能要素は juiz_sdk クレートで書きます。Cargo.toml で共有ライブラリとしてビルドする設定にします。 juiz_sdk の版は、cargo install juiz_app で入れた juiz と合わせてください。版が食い違うプラグインは、読み込むときにエラーで止まります。

[lib]
crate-type = ["cdylib"]

[dependencies]
juiz_sdk = "0.0.17"

Python

pyjuiz のデコレータ(from juiz import juiz_process など)で書きます。pyjuiz は juiz-cli と一緒に入ります。cargo install juiz_app を使う場合は、上のとおり pyjuiz だけを入れます。

C++

C++ 向けのヘッダー juiz/juiz.h は juiz リポジトリの bindings/cppjuiz/include にあります。

ソースからビルドする

開発版を使う場合はリポジトリをクローンしてビルドします。

git clone https://github.com/OpenJUIZ/juiz.git
cd juiz
cargo build
cargo install --path juiz_app