Python開発環境構築 2020 [Pythonインストールからpoetry導入まで]

Python開発環境構築

この記事は筆者が2020年4月現在採用している開発環境の構築方法です．主にLinux, Mac Userを対象としています．Raspberry PiやTinker board, Jetson nanoなどの特殊な環境は除きます．参考までに筆者の環境はUbuntu 18.04です．Windowsでの環境構築は茨の道なので，非推奨とします．Ubuntuをdual bootするか，WSLを導入した後，以下に進んでください．Pythonを始める友人のために執筆したもののため，冗長な部分がありますが適宜飛ばしてお読みください．

ここでは以下ツールのインストールについて説明しています．使用方法は別記事で説明します．poetryでなくpipenvを使用したい方は各自調べてください．

• homebrew (mac userのみ)
• git
• python
• pyenv (optional)
• poetry

開発環境の構築に必要なツールのインストール

ここでは最低限brew(Mac userのみ)とgitのインストールを説明します．インストールの際はターミナルでそれぞれのコマンドを実行してください．ターミナルの開き方はubuntuの場合 ctrl + Alt + T, Macはこの記事を参照してください．ターミナルが何かわからない方はこの記事を参照してください．開発の中でメインで使用するツールです．ぜひ慣れていきましょう．

homebrewのインストール (mac userのみ)

こちらは以下を参考にインストールしてください．

• Mac Homebrewインストール手順

gitのインストール

softwareのバージョン管理ツールです．使用方法は入門の域を超えると判断しここでは詳しくは説明しません．このツールも今後チームでの開発に限らず，単独での開発の際にも必須のものになります．ゆくゆくは使用方法を覚えましょう．すでにインストールされている方はこの項は飛ばしてください．

linux user

• インストール方法

  sudo apt update
  sudo apt upgrade
  sudo apt install git-all
  

• 参考link

mac user

• インストール方法

  brew install git
  

Pythonのインストール

この項はPython自体がインストールされていない人のためです．すでにインストールされている場合は飛ばしてください．

インストールの確認

インストールされているかを確認するには，ターミナル上で以下を打ちます．

python3 -V

上記コマンドを打ち，表示されないまたは3.5以下の数字が表示された場合は以下に進んでください．3.6以上のバージョンがインストールされている場合は仮想環境のインストールに進んでください．

Linux系OS(Ubuntu等)を使用しているユーザー

sudo権限がある場合，

sudo apt install python

sudo権限が無い場合，homebrewを導入した後，以下を実行．

brew install python

Macを使用しているユーザー

brew install python

仮想環境のインストール

今後，様々なプログラムを作成する上で，多様なライブラリをその都度インストールして，使用することになります．一箇所にまとめて導入するような運用の場合，依存関係が複雑になり，後々，ライブラリのバージョン間の依存関係やPythonのバージョンを起因とするバグに悩まされることになります．これを回避するために使用するプログラムごとに仮想的なPythonの環境を構築し運用します．

pyenv (optional)

好きなPythonのバージョンを手軽にインストールするときに便利です．後々異なるPythonの環境下での開発が必要になる際やライブラリの開発の関係で別のPythonのバージョンを試す際に使用出来ると非常に役に立ちます．前の項でひとまずPythonはインストールしているため，この部分はoptionalです．初めてPythonを触る人はここを飛ばし，poetryのインストールに進んでも構いません．ターミナルで以下を打ちます． インストール方法は2020年4月現在のものです．最新の方法はpyenv installationを参照してください．

Linux User

• 以下のコマンドを打ち，~/.pyenvにgitを使用してダウンロードします．

  git clone https://github.com/pyenv/pyenv.git ~/.pyenv
  

• このままだとパソコンがどこにインストールしたのか認識していないため，Pathを通してやる必要はあります．

  • For Ubuntu:

    echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
    echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
    echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.bashrc
    

  • For Zsh:

    echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
    echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
    echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.zshrc
    

Mac User

• brewでインストールできます 参考

  brew update
  brew install pyenv
  

pyenvを使用したPythonのインストール

• このリンクを参照してください．

poetry

仮想環境のツールにはvenv, virtualenv, pipenv等ありますが，2020年4月現在手軽に使用でき動作が軽量なpoetryを使用します．

• OSX / linux users

  curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
  

• 主な使用方法は公式document (英語)かこの記事(日本語)を参照してください．

  • poetry add, poetry remove, poetry show, poetry runさえ使用できれば問題ありません．

• 次にpathを通します．

  • Ubuntuの場合

    echo 'export PATH=$HOME/.poetry/bin:$PATH' >> ~/.bashrc
    

  • Macの場合

    echo 'export PATH=$HOME/.poetry/bin:$PATH' >> ~/.zshrc
    
    

参考リンク

• Python環境構築ベストプラクティス2019
• pyenv installation
• Mac Homebrewインストール手順