Python 開発環境の設定

このチュートリアルでは、Google Cloud で動作する Python アプリの開発など、Python 開発用のローカルマシンを準備する方法を説明します。

開発環境をすでにセットアップしている場合は、Python と Google Cloud を参照して、Google Cloud で Python アプリを実行する方法の概要を確認してください。

目標

  • 最新版の Python をインストールします。
  • venv を使用して依存関係を隔離します。
  • エディタのインストール(省略可)
  • Google Cloud CLI をインストールします(省略可)。
  • Python 用の Cloud クライアント ライブラリのインストール(省略可)
  • その他の便利なツールのインストール

Python をインストールする

Python のインストール手順は、オペレーティング システムによって異なります。開発環境で実行しているオペレーティング システム(macOS、Windows、Linux)のガイドに従ってください。

macOS

macOS にはデフォルトで Python のバージョンが含まれており、独自の目的に使用されています。macOS との干渉を避けるために、別の開発環境を作り、Python の最新版をインストールすることをおすすめします。Python をインストールするには、Homebrew を使用します。

  1. Homebrew を使用して Python パッケージをインストールするには、Xcode のコマンドライン ツールをインストールしてコンパイラを入手する必要があります。

    xcode-select --install
    
  2. Homebrew のホームページの手順に従って Homebrew をインストールし、Homebrew を使用して以下のとおり Python をインストールします。

    brew install python
    pyenv install 3.9
    
  3. インストールが完了したら、Python 3 が python および python3 として使用可能であること、pip もインストールされていることを確認します。

    Python が利用可能であることを確認するには、次のコマンドを実行します。

    python --version
    

    バージョンが出力されます。 最新バージョンの Python homebrew については、Homebrew Python Formula のページをご覧ください。

    pip が利用可能であることを確認するには、次のコマンドを実行します。

    pip --version
    

    バージョンが出力されます。最新版の pip については、pip のリリースノートをご覧ください。

    Homebrew は、お使いのプラットフォームで最新の Python をインストールします。出力内のバージョン番号は、Python の最新公式リリースとは異なる場合があります。

Windows

  1. Windows 環境に Python をインストールするには、Python のウェブサイトから最新版の Python のインストーラをダウンロードします。

  2. お使いのバージョンの Python にアクセスするには、Windows 用 Python ランチャーを使用します。

    インストールした最新バージョンの Python を起動するには、次のコマンドを実行します。

    py
    

    インストールした最新バージョンの Python 3 を起動するには、次のコマンドを実行します。

    py -3
    

    利用可能な pip のバージョンを確認するには、次のコマンドを実行します。

    py -m pip --version
    

    出力に C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages からのバージョンが表示されます。

    最新版の pip については、pip のリリースノートをご覧ください。

Linux

ほとんどの Linux ディストリビューションには、最新バージョンの Python が含まれています。

  1. Python を Linux 環境にインストールするには、ご使用のディストリビューションに適したパッケージをインストールしてください。Debian と Ubuntu の場合、パッケージは、python3python3-devpython3-venv です。

    次のコマンドを使用してこれらのパッケージをインストールします。

    sudo apt update
    sudo apt install python3 python3-dev python3-venv
    
  2. pip もインストールする必要があります。Debian やその他のほとんどのディストリビューションには python-pip パッケージが含まれていますが、pip をインストールして最新バージョンを入手することをおすすめします。

    sudo apt-get install wget
    wget https://bootstrap.pypa.io/get-pip.py
    sudo python3 get-pip.py
    
  3. インストールが完了したら、pip がインストールされていることを確認します。

    pip --version
    

    出力に、/usr/local/lib/python3.x/dist-packages のバージョンが表示されます。最新版の pip については、pip のリリースノートをご覧ください。

venv を使用して依存関係を隔離する

venv は隔離された Python 環境を作成するツールです。これらの隔離環境では、異なるバージョンの Python パッケージを使用して、あるプロジェクトの依存関係を他のプロジェクトの依存関係から分離できます。Python を使用してローカルに開発する場合は、常にプロジェクトごとに仮想環境を使用することをおすすめします。

  1. venv コマンドを使用して、Python インストール全体の仮想コピーを作成します。このチュートリアルでは、env という名前のフォルダに仮想コピーを作成しますが、フォルダには任意の名前を指定できます。

    macOS

    cd your-project
    python -m venv env
    

    Windows

    cd your-project
    py -m venv env
    

    Linux

    cd your-project
    python3 -m venv env
    
  2. 仮想環境を有効化して、Python の venv パスを使用するようシェルを設定します。

    macOS

    source env/bin/activate
    

    Windows

    .\env\Scripts\activate
    

    Linux

    source env/bin/activate
    
  3. これにより、他のプロジェクトやグローバルの Python インストールに影響を与えずにパッケージをインストールできます。

    pip install google-cloud-storage
    

    仮想環境の使用をやめてグローバル Python に戻る場合は、無効化できます。

    deactivate
    

venv の詳細については、venv のドキュメントをご覧ください。

エディタのインストール

Python アプリの開発にはエディタが必要です。よく使用されるエディタには次のものがあります(順不同)。

Python 用 Cloud クライアント ライブラリをインストールする

Python 用 Cloud クライアント ライブラリは、Python デベロッパーが Python を Datastore や Cloud Storage などの Google Cloud サービスと統合する方法を示します。Cloud Storage などの個々の API のパッケージをインストールするには、次のようなコマンドを使用します。

pip install --upgrade google-cloud-storage

gcloud CLI のインストール

gcloud CLI は、Google Cloud 用のコマンドライン ツールのセットです。このセットには gcloudgsutilbq が含まれており、Compute Engine、Cloud Storage、BigQuery などのプロダクトやサービスにコマンドラインからアクセスできます。これらのツールはインタラクティブに実行することも、自動スクリプトで実行することもできます。

次のステップ