just¶
just ... プロジェクト固有のコマンドを保存して実行するための、Rust 製のコマンドランナー。
- リポジトリ: https://github.com/casey/just
- マニュアル: https://just.systems/man/en/
- ライセンス: CC0-1.0
- 2026-11-21 時点の最新リリースは 1.59.0
About¶
コマンド(recipe と呼ぶ)を justfile というファイルに書き、just <recipe> で実行する。
構文は GNU make に似ているが、ビルドシステムではなく、コマンドランナーとして作られている。
make との主な違い:
- ファイルの更新日時による再ビルド判定をしない。そのため、
.PHONYが要らない。 - recipe に引数(フラグやオプションを含む)を渡せる。
- 未定義の recipe や循環依存は、実行前に静的に検出される。
.envファイルを読み込める(set dotenv-load)。justfileがあるディレクトリの配下のどこからでも実行できる(カレントディレクトリから親へ向かって探す)。- Python や Node.js など、シェル以外の言語で recipe を書ける(shebang recipe)。
- 追加の依存なしで、Linux、macOS、Windows で動く。
Install¶
macOS の Homebrew:
そのほかの方法:
cargo install just- 各 OS のパッケージマネージャー(公式 README に一覧がある)
- GitHub Releases のビルド済みバイナリ
動作確認:
Quickstart¶
プロジェクトのルートに justfile を作る。ファイル名の大文字・小文字は区別されない。隠しファイルにしたいときは .justfile でもよい。
build:
cc main.c foo.c bar.c -o main
# テストを実行する
test: build
./test
sloc:
@echo "`wc -l *.c` lines of code"
実行例:
# 引数なし: 先頭の recipe(または [default] 属性の recipe)を実行する
just
# recipe を指定して実行する。複数指定できる
just test
just build sloc
挙動:
- 実行する各行は、実行前に標準エラー出力へ表示される。行頭に
@を付けると、表示しない。 - 行が失敗すると、その recipe は止まる。
test: buildのように書くと、buildが先に実行される(依存関係)。- インデントは、スペースでもタブでもよい。ただし、1つの recipe の中では統一する。
justfile の構文¶
変数と式¶
:=で変数を定義する。{{...}}で、変数や式を recipe の中に展開する。- バッククォートで、コマンドの出力を値にできる。
recipe の引数¶
name="default"でデフォルト値を指定する。*args(0個以上)、+args(1個以上)で、可変長の引数を受け取る。
設定(set)¶
set dotenv-load:.envから環境変数を読み込む。set shell := [...]: recipe の各行を実行するシェルを変える。デフォルトはsh -cu。
属性¶
recipe の直前に [...] で書く。
[default]: 引数なしのjustで実行する recipe にする。[private]:just --listに出さない(_で始まる名前でも同じ)。[confirm]: 実行前に確認を求める。[group('name')]:--listでの表示をグループ分けする。[windows]、[unix]など: OS ごとに recipe を切り替える。
shebang recipe¶
recipe の本体の先頭に shebang を書くと、その言語で実行される。
分割¶
import 'path': 別ファイルの内容を取り込む。mod name: サブモジュールとして読み込む。just name::recipeで呼ぶ。
just コマンド¶
# recipe の一覧(直前のコメントが説明として出る)
just --list
# justfile のひな形を作る
just --init
# justfile を整形する
just --fmt
# 変数の評価結果を表示する
just --evaluate
# 対話的に recipe を選んで実行する(fzf が必要)
just --choose
# 別の justfile を指定する
just --justfile <path> <recipe>
- シェル補完スクリプトは
just --completions <shell>で出力できる。 - 実行される recipe は、デフォルトでは、
justfileのあるディレクトリで動く。
Note
just は make のように、ファイルの更新状況を見て実行を省略することはない。
「出力ファイルが新しければ再ビルドしない」という挙動が必要な場合は、make などのビルドシステムを使う。
Tips¶
各行は別のシェルで実行される¶
recipe の各行は、行ごとに新しいシェルで実行される。このため、ある行の cd や変数の設定は、次の行に引き継がれない。
複数行にまたがる処理は、shebang recipe にするか、set working-directory や [working-directory] 属性を使う。