はじめに

メジャーなプログラミング言語には、たいていバージョン管理システムがある。これを利用することで、プロジェクトごとに異なるバージョンの言語を使用することができる。

代表的なバージョン管理システムを以下に挙げる。

Language	Version manager
Node.js	ndenv
Ruby	rbenv
Python	pyenv
PHP	phpenv

しかし、言語ごとにバージョン管理システムをインストールするのはめんどうだ。そこで、これらをまとめた anyenv というものがある。

このツールはとても便利で、筆者も利用していたのだが、一点、致命的な弱点がある。それは、ロードが遅い ことだ。

筆者は ndenv, rbenv, pyenv, phpenv の 4 種類を anyenv で管理していた。そして、シェル起動時にそれらをロードするようにしていた。

ロードするための設定を以下に示す。

# anyenv
if [[ -s ~/.anyenv ]]; then
  PATH="$HOME/.anyenv/bin:$PATH"
  eval "$(anyenv init -)"
fi

# ndenv
if [[ -s ~/.ndenv ]]; then
  PATH="$HOME/.ndenv/bin:$PATH"
  eval "$(ndenv init -)"
fi

# rbenv
if [[ -s ~/.rbenv ]]; then
  PATH="$HOME/.rbenv/bin:$PATH"
  eval "$(rbenv init -)"
fi

# pyenv
if [[ -s ~/.pyenv ]]; then
  PYENV_ROOT="$HOME/.pyenv"
  PATH="$PYENV_ROOT/bin:$PATH"
  eval "$(pyenv init -)"
fi

# phpenv
if [[ -s ~/.phpenv ]]; then
  PATH="$HOME/.phpenv/bin:$PATH"
  eval "$(phpenv init -)"
fi

ベンチマークを利用して正確に時間を計測したわけではないが、ここの部分の実行時間が、約 2.6786839962 秒だった。とても遅い……。

何かもっと良いツールはないかなと探していたら、asdf というものを発見した。これも複数の言語に対応したバージョン管理システムだ。

anyenv から asdf に置き換えたことにより、シェルの起動が驚くほど速くなった。

そこで今回はこの asdf のインストール方法と簡単な使い方について紹介する。

インストール

依存関係パッケージのインストール

curl と git が必要なので、インストールされていない場合はインストールする。例として Ubuntu の場合は以下のコマンドを実行する。

sudo apt install -y curl git

ただし、Homebrew 経由でインストールする場合は自動的にインストールされるので、対応不要。

asdf のインストール

3 種類の方法を紹介するが、おすすめは Zinit だ。

Homebrew

brew install asdf

続いて、以下のコマンドを実行する。

echo -e "\n. $(brew --prefix asdf)/libexec/asdf.sh"

実行後に表示されるスクリプトをそのまま ~/.bashrc や ~/.zshrc などに追記する。

Git

git clone https://github.com/asdf-vm/asdf.git ~/.asdf

上記の場合、master ブランチの最新版がインストールされる。

master の最新版にはバグが含まれている可能性があるので、特定のバージョンをインストールする場合は --branch オプションを使用する。

git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.8.1

続いて、以下を ~/.bashrc や ~/.zshrc などに追記する。

. $HOME/.asdf/asdf.sh

Zinit (おすすめ)

以下を ~/.bashrc や ~/.zshrc などに追記する。

zinit light asdf-vm/asdf

注: Zinit 自体をロードする部分は割愛。

補完機能

補完を有効にする場合は、~/.bashrc や ~/.zshrc などに以下も追記する。

Bash

以下のコマンドを実行した結果を ~/.bashrc にそのまま追記する。

echo -e "\n. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash"

Zsh

以下を ~/.zshrc に追記する。

fpath=(${ASDF_DIR}/completions $fpath)
autoload -Uz compinit && compinit

プラグインのインストール

使用する言語用のプラグインをインストールする。

以下で紹介されていない言語については、検索するとすぐに出てくるはずだ。

Node.js

asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git

Ruby

asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git

Ruby をインストールする場合は事前に openssl や readline をインストールしておく必要がある。

参考: Suggested build environment

Homebrew

brew install openssl readline

Ubuntu

sudo apt install -y autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libdb-dev

Python

asdf plugin-add python

言語のインストール

使用する言語とそのバージョンを指定してインストールする。

例として、Node.js 15.2.1 をインストールする場合は以下のコマンドを実行する。

asdf install nodejs 15.2.1

nodejs の部分を、それぞれ ruby や python にすることで他の言語もインストールできる。

また、15.2.1 の部分を latest とすると、最新版をインストールすることができる。

グローバルで使用する

インストールしたバージョンをグローバルで使用したい場合は以下のようにコマンドを実行する。

asdf global nodejs 15.2.1

ローカルで使用する

逆に、カレントディレクトリ以下でのみそのバージョンを使用したい場合は以下のようにコマンドを実行する。

asdf local nodejs 15.2.1

ちなみにこのとき、.tool-versions というファイルが生成されるが、.node-version や .ruby-version のような従来のファイルでバージョンを管理したい場合は、~/.asdfrc に以下を追加する。

legacy_version_file = yes

一時的に別のバージョンを使用する

カレントディレクトリ以下では 15.2.1 が使用されているが、このコマンドの実行時だけ一時的に 12.16.1 を使用したい、みたいな場合には環境変数 ASDF_NODEJS_VERSION が利用できる。

ASDF_NODEJS_VERSION=12.16.1 node -v

v12.16.1

グローバルにインストールしたコマンドを使用する

npm install -g <PACKAGE_NAME> や gem install <PACKAGE_NAME> などでインストールしたパッケージに、コマンドが提供されているものがある。

それらのコマンドを使用するためには、再読み込みをする必要がある。

asdf reshim nodejs