もう壊れないPython環境：venv×pip-toolsで作る再現可能な依存管理

# 0) 仮想環境の作成と有効化
python -m venv .venv
# Windows PowerShell
.\.venv\Scripts\Activate.ps1
# macOS/Linux
source .venv/bin/activate

# 1) pip-tools を導入

python -m pip install -U pip
pip install pip-tools

# 2) 要件を .in に書く（例）

printf "pandas\nmatplotlib\njupyter\n" > requirements.in

# 3) 依存をロック（ハッシュ付き推奨）

pip-compile -o requirements.txt --generate-hashes requirements.in

# 4) 環境を同期（.txt どおりに揃える）

pip-sync requirements.txt

# 5) Jupyterカーネル登録（任意）

pip install ipykernel && python -m ipykernel install --user --name proj --display-name "Python (proj)"

requirements.in      # 宣言：上位依存だけ（意図）
requirements.txt     # 施行：全依存を固定（結果）
constraints.txt      # 任意：問題版のピン止め・除外

# constraintsを効かせてコンパイル
pip-compile -o requirements.txt --generate-hashes -c constraints.txt requirements.in

# 例: constraints.txt

# numpy!=2.0.0

requirements.in          # 本番/実行時（ランタイム）
requirements-dev.in      # 開発ツール（black/ruff/pytest など）
requirements.txt         # 本番ロック
requirements-dev.txt     # 開発ロック（本番+開発）

pip-compile -o requirements.txt --generate-hashes requirements.in
pip-compile -o requirements-dev.txt --generate-hashes requirements-dev.in -r requirements.txt

# 影響を確認
pip-compile --upgrade --dry-run requirements.in

# 実施（本番）

pip-compile --upgrade -o requirements.txt --generate-hashes requirements.in
pip-sync requirements.txt

# 開発も更新

pip-compile --upgrade -o requirements-dev.txt --generate-hashes requirements-dev.in -r requirements.txt
pip-sync requirements-dev.txt

install:
	python -m pip install -U pip && pip install pip-tools
	pip-compile -o requirements.txt --generate-hashes requirements.in
	pip-sync requirements.txt

install-dev:
pip-compile -o requirements-dev.txt --generate-hashes requirements-dev.in -r requirements.txt
pip-sync requirements-dev.txt

update:
pip-compile --upgrade -o requirements.txt --generate-hashes requirements.in
pip-compile --upgrade -o requirements-dev.txt --generate-hashes requirements-dev.in -r requirements.txt

outdated:
pip list --outdated

# 事前にホイールをまとめる
pip wheel -r requirements.txt -w wheelhouse

# オフライン先でインストール

pip install --no-index --find-links=wheelhouse -r requirements.txt

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt ./
RUN python -m pip install -U pip && pip install -r requirements.txt
COPY . .

- uses: actions/setup-python@v5
  with:
    python-version: '3.12'
- run: pip install pip-tools
- run: pip-sync requirements.txt
- run: pytest -q

pandas>=2.2,<2.3
matplotlib>=3.8,<3.9
jupyter>=1.0
pyarrow>=16,<17

-r requirements.txt
black>=24.4
ruff>=0.5
pytest>=8.3
pre-commit>=3.7

# Known bad versions (example)
numpy!=2.0.0

### Setup
python -m venv .venv && source .venv/bin/activate  # WindowsはActivate.ps1
python -m pip install -U pip && pip install pip-tools
pip-compile -o requirements.txt --generate-hashes requirements.in
pip-sync requirements.txt