外部ライブラリとpip
ここまでは、Pythonに標準で含まれている標準ライブラリを紹介しました。標準ライブラリだけでも多くのことができますが、世界中の開発者が作成・公開している外部ライブラリ(サードパーティライブラリ)を利用することで、さらに幅広い機能を簡単に使うことができます。
1. PyPIとは
外部ライブラリは、PyPI(Python Package Index)というリポジトリに公開されています。PyPIには数十万以上のパッケージが登録されており、HTTP通信、データベース操作、Webフレームワークなど、さまざまな用途のライブラリを見つけることができます。
2. pipによるインストール
外部ライブラリをインストールするには、pipというパッケージ管理ツールを使用します。pipはPythonに同梱されているため、別途インストールする必要はありません。
2.1 基本的な構文
Windowsの場合:
pip install パッケージ名
Macの場合:
pip3 install パッケージ名
| 💡 ポイント |
|---|
macOSではpipの代わりにpip3を使用します。これは、macOSにプリインストールされているPython 2系のpipと区別するためです。本セクションでは、pipコマンドはWindows版とmacOS版の両方を記載しています。お使いの環境に合わせて実行してください。 |
2.2 requestsライブラリのインストール
実際に試してみましょう。HTTP通信を簡単に行えるライブラリであるrequestsをインストールします。
Windowsの場合:
pip install requests
Macの場合:
pip3 install requests
以下のようなメッセージが表示され、インストールが完了します。
Successfully installed requests-x.x.x
⚠️ error: externally-managed-environment と表示される場合 |
|---|
Homebrew でインストールした Python 3.11 以降では、システム全体を保護するために pip install が既定で拒否されます(PEP 668)。この場合は、プロジェクトフォルダ内に仮想環境を作成してからインストールすると解消します。プロジェクトフォルダで python3 -m venv .venv を実行して .venv フォルダを作成し、source .venv/bin/activate で仮想環境を有効化した状態で pip3 install requests を再実行してください。以降の python3 main.py の実行も同じターミナルで(仮想環境を有効化した状態で)行います。 |
2.3 requestsライブラリの使用
インストールしたrequestsを使って、外部のAPIからデータを取得してみます。main.pyに以下の内容を記述して実行してみましょう。
import requests
response = requests.get("https://httpbin.org/json")
data = response.json()
print(data)
実行すると以下のように出力されます。
{'slideshow': {'author': 'Yours Truly', 'date': 'date of publication', 'slides': [{'title': 'Wake up to WonderWidgets!', 'type': 'all'}, {'items': ['Why <em>WonderWidgets</em> are great', 'Who <em>buys</em> WonderWidgets'], 'title': 'Overview', 'type': 'all'}], 'title': 'Sample Slide Show'}}
requests.get()でURLに対してHTTPリクエストを送信し、response.json()でレスポンスのJSONデータをPythonの辞書に変換しています。標準ライブラリだけでは複雑になるHTTP通信が、requestsを使うことでわずか数行で実現できます。
| 📝 httpbin.orgとは |
|---|
httpbin.orgは、HTTPリクエストのテスト用に公開されているWebサービスです。/jsonにアクセスするとサンプルのJSONデータが返されるため、HTTPライブラリの動作確認に便利です。 |
3. requirements.txt(依存関係の管理)
プロジェクトで使用している外部ライブラリの一覧をrequirements.txtというファイルに記録しておくことで、他の開発者やサーバ上で同じライブラリを一括インストールできます。
現在インストールされているライブラリの一覧をrequirements.txtに出力するには、以下のコマンドを実行します。
Windowsの場合:
pip freeze > requirements.txt
Macの場合:
pip3 freeze > requirements.txt
実行すると、requirements.txtが作成されます。ファイルを開くと、以下のようにインストール済みのライブラリとそのバージョンが記録されています。
certifi==2024.12.14
charset-normalizer==3.4.1
idna==3.10
requests==2.32.3
urllib3==2.3.0
requestsだけをインストールしましたが、requestsが内部で使用しているライブラリ(certifi、charset-normalizerなど)も一緒に記録されています。このように、pip freezeはインストールされているすべてのライブラリを出力します。また、このファイルに新しいライブラリ名とバージョンを手動で追加すれば、pip install -r requirements.txtの実行時にそのライブラリもインストール対象に含めることができます。
requirements.txtに記録されたライブラリを一括インストールするには、以下のコマンドを実行します。
Windowsの場合:
pip install -r requirements.txt
Macの場合:
pip3 install -r requirements.txt
| 💡 ポイント |
|---|
requirements.txtというファイル名はPythonの公式仕様で決められたものではなく、コミュニティで広く使われている慣習的な名前です。pip install -rはファイル名を自由に指定できるため、別の名前でも動作しますが、多くのPythonプロジェクトでrequirements.txtが使われているため、この名前に従うのが一般的です。チーム開発やサーバへのデプロイでは、requirements.txtを使ってライブラリのバージョンを統一することが重要です。後のセクションでも外部ライブラリを使用する際にpip installを使用しますので、このコマンドの使い方を覚えておいてください。 |