はじめに
新しいパソコン（Windows11）で、WSLでonline-judge-tools(ojコマンド)を使えるようセッティングしようとしたら、はまりました。解決策をメモします。環境は以下のとおりです。
- Windows 11
- WSL上のUbuntu 24.04
- Ubuntu上のPython 3.12
- online-judge-tools 11.5.1
はまった内容3点
- インストールできない
- ojが動かない
- AtCoderにログインできない
それぞれ解決策を書いていきます。
はまりポイント１：インストールできない
現象
pip3 install online-judge-tools
を実行しても以下のとおりエラーになる。
error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
python3-xyz, where xyz is the package you are trying to
install.
（後略）
原因
WSLをインストールした際のデフォルトのOSは、2024年5月ころからUbuntu 24.04になったようです。Ubuntu 24.04ではPythonのバージョンが3.12です。Python 3.12以降では、システムPythonでは直接pip installを使えないようになっている、らしいです。
解決方法
pip3の代わりにpipxを使いましょう。
①pipxのインストール
以下を実行します。
sudo apt update
sudo apt install pipx
pipx ensurepath
その後、一度ターミナルを閉じるか、source ~/.bashrc を実行して PATH を更新します。
②pipxを使ってojをインストール・・・？
この後普通に進めると"pipx install online-judge-tools"としてしまうところですが、それはNGです。次のはまりが発生します。
はまりポイント２：ojが動かない
現象
ojを実行すると以下のようにエラーが出る。
$ oj --version
Traceback (most recent call last):
（中略）
ModuleNotFoundError: No module named 'distutils'
原因
Python 3.12にはdistutils モジュールが入っていないためです。Python 3.11以前は非推奨でありながら入っていましたが、Python 3.12以降削除されたらしいです。
解決方法
ojだけPython 3.11で動くようにします。
①Python 3.11をインストール
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.11 python3.11-venv
②pipx で oj をインストール
pipx install --python python3.11 online-judge-tools
※ 誤って既に3.11を指定せずインストールしてしまっている場合は、以下で上書きインストールできる
pipx reinstall online-judge-tools --python python3.11
はまりポイント３：AtCoderにログインできない
現象
以下を実行し、ユーザー名とパスワードを入力してもログインができない。ブラウザからならログインできる。
oj login https://atcoder.jp/
原因
AtCoderがセキュリティ強化をしているため、だと思います。
解決方法
以下の素晴らしい記事に書いてあります。
https://kaiyou9.com/acc_and_oj_login_failed/