Construction of Python environments on macOS

  • Authored by Akio Taniguchi
    Updated by Kaoru Nishikawa

Contents

  1. 環境構築とは何か
  2. Python 実行環境の構築
  3. プログラミング環境の構築
  4. 仮想環境の構築

用語の説明
Python インタープリタ Python の文法で書かれた指示を解釈し、実行するプログラム
スクリプト Python の文法で指示を書いたテキストファイル
パッケージ / ライブラリ ある目的のためのスクリプトを集めて配布されているもの (厳密には違うので注意)
pip 外部パッケージをインストールするコマンド
パッケージ管理ツール pip の機能を使いながらバージョン管理まで行うツール (Pipenv, Poetry など)

環境構築とは何か

  • 環境構築
    • とあるプロジェクトに必要なライブラリ・Python インタープリタを独立にインストールすること
    • エディタ・linter (構文チェッカー)・formatter (自動整形) などプログラミングを支援する環境を整えること
  • Python の環境構築
    • Python インタープリタ・標準ライブラリ → Homebrew を使う
    • 外部ライブラリ → pip またはパッケージ管理ツールを使う

Python を起動してみる

まず Python がインストールされているか確認する

$ which python3
  • 何も表示されなかった場合、$ brew install python3
Python を起動する $ python3
Python を終了する >>> quit()

仮想環境の構築

バージョン管理ツール Poetry をインストールする

$ curl -sSL https://install.python-poetry.org | python3 -
$ poetry config virtualenvs.in-project true

作業を行うためのディレクトリを作り、仮想環境を作る

$ mkdir MyProject && cd MyProject
$ poetry init

いくつか設定を聞かれるが、後から変更できるため適当でも良い

仮想環境の使用
仮想環境に入る $ poetry shell
仮想環境から出る $ exit
外部パッケージを追加する $ poetry add numpy
外部パッケージを削除する $ poetry remove numpy
外部パッケージを全てアップデートする $ poetry update
既存の poetry.lock ファイルを読み込む $ poetry install

バージョンの異なる Python を使う

バージョンの異なる Python を使うために pyenv をインストールする

$ brew install pyenv
$ echo '# pyenv\nexport PYENV_ROOT=$HOME/.pyenv' >> ~/.zprofile
$ echo 'export PATH=$PYENV_ROOT/bin:$PATH' >> ~/.zprofile
$ echo 'eval "$(pyenv init --path)"' >> ~/.zprofile

Python 3.8.12 をインストールし、python コマンドに紐づける

$ pyenv install 3.8.12
$ pyenv global 3.8.12

プログラミング環境の構築

おすすめのツール・設定

  • Visual Studio Code
    • (拡張機能：⌘⇧X)
    • Python
    • Pylance
    • Jupyter
    • Code Spell Checker
    • Todo Tree
  • (設定：⌘,)
  • Editor: Format On Save ☑
  • Python > Formatting: Provider black
  • Python > Linting: Flake8 Enabled ☑