TL;DR 
2018年の Python プロジェクトのはじめかた にもあるように、pipenv の登場によって Python でも依存関係 (Python バージョン + パッケージ) を両方管理した環境構築が簡単にできるようになりました。そうなると、IPython や Jupyter の設定ファイルや、パッケージのインポートなどを記述できる IPython のスタートアップスクリプトも環境ごとに管理したいところです。そこで、この記事では pipenv で作成した環境でこれらを管理する方法をまとめます。
Create an environment
前提条件として、以下のコマンドで pipenv で作成した仮想環境 (ここでは名前を env とします) と、IPython/Jupyter がインストール済みであるとします。特に明記がない限り、コマンドは env から実行しているものとします。また、仮想環境に (pipenv shell で) 入ってコマンドを実行している場合は、プロンプトを (env) $ として表しました。
$ mkdir env && cd env
$ pipenv --python 3
$ pipenv install ipython jupyter
IPython profile
IPython 関連は、プロファイルと呼ばれるディレクトリとファイル群によって設定されます。通常これは ipython profile create default によって、~/.ipython/profile_default に作成されることが多いと思いますが、何もしないと仮想環境でもこれを引き継いで使ってしまうため、あまり使い勝手がよくありません。そこで、env 以下にプロファイルを作成し、これを読み込むように pipenv を設定します。
まず、.env ファイルに以下の環境変数を書き込むことで、pipenv 実行時には env/.ipython が ~/.ipython の代わりに IPython ディレクトリとして使われるようになります。
$ echo IPYTHONDIR=`pwd`/.ipython >> .env
この状態で以下のようにプロファイルを作成することで、env/.ipython/profile_default が作成されます。
$ pipenv shell
(env) $ mkdir -p .ipython
(env) $ ipython profile create default
例えば、スタートアップスクリプトで何かパッケージをインポートするようにしてみましょう。
# import this で Zen of Python を表示
(env) $ echo 'import this' >> .ipython/profile_default/startup/01.py
この状態で IPython shell を起動してみます。以下のように、Zen of Python が表示されれば成功です。
(env) $ ipython
Loading .env environment variables…
Python 3.6.5 (default, Jul 10 2018, 11:33:24)
Type 'copyright', 'credits' or 'license' for more information
IPython 7.2.0 -- An enhanced Interactive Python. Type '?' for help.
The Zen of Python, by Tim Peters
Beautiful is better than ugly.
Explicit is better than implicit.
...
Create a Jupyter kernel
上で作成したプロファイルを Jupyter Notebook でも使用したい場合、プロファイルを受け取れるような IPython kernel を作成してあげる必要があります。以下のコマンドで、.venv 以下にカーネルが作成されます。
(env) $ ipython kernel install --sys-prefix --profile default --display-name Default
Installed kernelspec python3 in /path/to/env/.venv/share/jupyter/kernels/python3
オプションのうち、--profile は IPython プロファイル名と同じにしておきます。--display-name はブラウザで表示される任意のカーネル名です。この状態で Jupyter Notebook を起動してみます。
(env) $ jupyter notebook
ウェブブラウザが開き、新規ノートブック作成 (New) から上で設定したカーネル (ここでは Default) が選べるようになっていれば成功です。
Demo repository
ここまでの手順は、スクリプトにまとめて pipenv のスクリプトショートカット から実行できるようにしておくと便利です。そこで、これのデモ用に以下のレポジトリを GitHub で公開しました。
このレポジトリには、etc/configure に一連のスクリプトが記述されています。レポジトリを clone したのち、以下の通りに実行すると、上記の諸々の設定が自動で行われます。
$ pipenv install
$ pipenv run configure
あとは、.ipython/profile_default を git で管理するなりすれば、環境構築がさらに楽になるはずです！
References
- Overview of the IPython configuration system — IPython documentation
- Installing the IPython kernel -- IPython documentation
- Custom Script Shortcuts — pipenv documentation
- Automatic Loading of .env -- pipenv documentation
- 2018年の Python プロジェクトのはじめかた - Qiita
- astropenguin/pipenv-ipython-jupyter: Demo of IPython/Jupyter custom config management by Python-pipenv