Rigorのインストール

Rigorはライブラリではなくツールです——リンターやコンパイラと同様に、プロジェクトを解析しますがランタイムの一部ではありません。アプリケーションのGemfileに追加しないでください。Gemfileに記述すると、プロジェクト全体がRigorのRubyバージョンに縛られ、Rigorの依存関係がアプリケーションの依存関係解決に混入します。Rigorは独立してインストールし、プロジェクトに向けて使用してください。

RigorはRuby 4.0で動作します。これは自分のコードが対象とするRubyとは独立しています: target_ruby:設定キーでRigorに自分のプロジェクトが実行するRubyを伝えますが、両者は一致している必要はありません。Rigorはプロジェクト——ソース、Gemfile.lock、gemの.rbsファイル——をデータとして読み込み、プロジェクトのgemを自身のプロセスにロードすることはありません。独立してインストールしても何も失われません。

AIコーディングエージェントを使っていますか？ Rigorのインストールとプロジェクトの設定を代わりにやってくれます — RailsクイックスタートのPath Aを参照してください。下記のチャンネルは手動のルートです。

インストールチャンネル — mise（推奨） · asdf · gem install · Nix · devコンテナ · CI

推奨 — ランタイムバージョンマネージャー

miseはランタイム/ツールバージョンマネージャーです（rbenv + nvmにパッケージランナーを加えたものと考えてください）。Ruby 4.0とRigorをまとめてインストールし、Gemfileを使わずにプロジェクト単位でピン留めします。

miseが初めての場合

mise自体のインストール後、2つのコマンドでRigorをセットアップできます:

mise use ruby@4.0
mise use gem:rigortype

miseを使ったことがない場合に知っておくべきことをいくつか紹介します:

• mise useはプロジェクトレベルで動作します。選択したバージョンを記録したmise.tomlをカレントディレクトリに書き込み、同じコマンドでツールもインストールします——別途インストールステップは不要です。（miseはasdf形式の.tool-versionsも読み込みます。）
• バージョンを共有するためにconfigをコミットしてください。生成されたmise.tomlをGitにコミットすれば、すべての貢献者とCIの実行が同じRuby 4.0と同じRigorバージョンを使用します。
• マシン全体へのインストールには-gを追加します。mise use -g gem:rigortypeはプロジェクトのmise.tomlの代わりにmiseのグローバルconfig（~/.config/mise/config.toml）に書き込み、すべてのディレクトリでrigorが使えるようになります。

gemの名前はrigortypeで、インストールされる実行ファイル（実際に使うコマンド）はrigorです。

rigorをPATHに追加する

ツールをインストールするだけでは不十分です——miseが環境に組み込まれて初めてrigorがPATHに到達します。これはプロジェクトレベルとグローバルインストールの両方に当てはまります。miseのshimsガイドでは2つのメカニズムを説明しています:

• mise activate — eval "$(mise activate zsh)"をシェルrc（~/.zshrc; bashとfishの同等物はmiseのドキュメントに記載）に追加します。プロジェクトにcdするとrigorがPATHに追加されます。インタラクティブシェルに最適です。

• shims — ~/.local/share/mise/shims配下の固定実行ファイルです。そのディレクトリをPATHに追加します:

  export PATH="$HOME/.local/share/mise/shims:$PATH"

  またはmise activate <shell> --shimsを実行します。Shimsはcdフックが発火しない場所——rigor lspを起動するエディタ、スクリプト、一部のCI——でも機能します。miseはインストール時にrigor shimを自動的に作成します。

どちらの方法でもmiseが組み込まれていない場合でも、mise exec gem:rigortype -- rigorで明示的にRigorを実行できます。エディタ側についてはエディタ統合を参照してください。

asdf

asdfも同じモデルに従います。asdf-rubyプラグインでRuby 4.0.xをインストールし、プロジェクトに設定してから、そのRubyにgemをインストールします:

asdf install ruby latest:4.0
asdf local ruby latest:4.0
gem install rigortype

asdfには汎用的なgemバックエンドがないため、gemはasdfコマンドではなくgem installでインストールします。上述のmiseはそのgem:バックエンドがgemをRubyと同じようにピン留めするため、より統合されたオプションです。

シンプルな代替手段 — gem install

すでにRuby 4.0がPATHにある場合:

gem install rigortype

gemの名前はrigortypeです——rigorはすでにRubyGemsで取得済みです——インストールされる実行ファイルはrigorです。これは最も手軽な方法ですが、プロジェクト単位では何も記録しません: バージョンマネージャーを使えばプロジェクトの横にRigorバージョンをピン留めできるため、ローカルの実行とCIがずれることがありません。

Nix

Nixを使用している場合、RigorのflakeはRuby 4.0をクロージャに含むパッケージとして実行ファイルを公開しています——ホストに他のものをインストールする必要はありません:

# インストールせずに実行:
nix run github:rigortype/rigor#rigor -- check

# またはプロファイルにインストール:
nix profile install github:rigortype/rigor

コンテナ内での開発

devコンテナ内で開発している場合、コンテナ内ではなくホストOSにRigorをインストールしてください——コンテナのファイルシステムとプロセス境界をまたいで解析するとオーバーヘッドが生じます。ホスト側のRuby 4.0の提供が難しいWindowsでは、コンテナ内にRigorをインストールする方が良い選択です。

継続的インテグレーション

RigorをCIに組み込む方法は専用の章で説明しています——CIでのRigor実行を参照してください。