Python パッケージ管理
pip・Poetry の使い方

pip は Python 標準のパッケージ管理ツールです。Python をインストールすると自動的に使えるようになります。

パッケージのインストール

# パッケージをインストール
pip install requests

# バージョンを指定してインストール
pip install flask==3.0.3

# 複数パッケージを一度にインストール
pip install flask requests sqlalchemy

パッケージの確認・削除

# インストール済みパッケージの一覧
pip list

# 特定パッケージの詳細情報
pip show flask

# パッケージのアンインストール
pip uninstall requests

# pip 自体を最新版にアップデート
pip install --upgrade pip

requirements.txt はインストール済みパッケージを記録するファイルです。チームや本番環境で同じ環境を再現できます。

requirements.txt を作成する

# 現在の環境のパッケージを書き出す
pip freeze > requirements.txt

# ファイルの中身を確認
Flask==3.0.3
requests==2.31.0
SQLAlchemy==2.0.30

requirements.txt からインストールする

# venv を作成して有効化した後に実行
pip install -r requirements.txt

バージョン指定の書き方

# requirements.txt に手書きする場合の書き方
flask==3.0.3          # 完全一致（推奨）
requests>=2.28.0      # 最低バージョン
sqlalchemy~=2.0       # 互換バージョン（2.x を使う）
pytest                # バージョン指定なし

Poetry は pip の上位互換となる Python プロジェクト管理ツールです。依存関係の解決・仮想環境管理・パッケージの公開まで一元管理できます。

Poetry は公式インストーラーを使うのが推奨方法です（pip でのインストールは非推奨）。

Windows（PowerShell）

# 公式インストーラーを使用
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

Mac / Linux

curl -sSL https://install.python-poetry.org | python3 -

PATH に追加（Mac/Linux）

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

インストールの確認

poetry --version
Poetry (version 1.8.3)

新しいプロジェクトを作成する

# 新規プロジェクトを作成（フォルダも作られる）
poetry new my-project
# または既存フォルダで初期化
poetry init

作成されるフォルダ構成：

my-project/
├── pyproject.toml    ← 依存関係を管理するファイル
├── poetry.lock       ← 正確なバージョンを固定するファイル
├── README.md
└── my_project/
    └── __init__.py

パッケージの追加

# パッケージを追加（自動で pyproject.toml に記録）
poetry add flask

# 開発用ツールとして追加（本番環境には不要）
poetry add --dev pytest

# パッケージを削除
poetry remove flask

仮想環境の管理

# 仮想環境内でコマンドを実行
poetry run python main.py

# 仮想環境のシェルに入る
poetry shell

# pyproject.toml の依存をすべてインストール
poetry install

pyproject.toml の例

[tool.poetry]
name = "my-project"
version = "0.1.0"
description = ""

[tool.poetry.dependencies]
python = "^3.11"
flask = "^3.0.3"

[tool.poetry.group.dev.dependencies]
pytest = "^8.0.0"