Macで使うuv入門：Python環境構築と依存関係管理

curl -LsSf https://astral.sh/uv/install.sh | sh

# 設定を反映（ターミナル再起動不要の場合）
source $HOME/.local/bin/env

# インストール確認
uv --version

brew install uv

# 新しいプロジェクトを作成（pyproject.toml が自動生成される）
uv init myproject
cd myproject

# 既存ディレクトリで初期化
uv init

# Python の全バージョン一覧を表示
uv python list

# インストール済みのバージョンのみ表示
uv python list --only-installed

# 最新の安定版をインストール
uv python install

# 特定のバージョンをインストール
uv python install 3.12
uv python install 3.10 3.11 3.12    # 複数同時にも対応

# PyPy などの代替実装もインストール可能
uv python install pypy3.10

# プロジェクトで特定の Python バージョンを指定（.python-version が作成）
uv python pin 3.12

# パッケージを追加（pyproject.toml を自動更新 + .venv にインストール）
uv add requests
uv add "fastapi>=0.100.0"
uv add "django~=4.2"
uv add pytest --dev    # 開発用依存関係として追加

# requirements.txt から一括インストール
uv pip install -r requirements.txt

# .venv という名前の仮想環境を作成
uv venv

# 特定の Python バージョンで仮想環境を作成
uv venv --python 3.12

# 仮想環境を有効化
source .venv/bin/activate

# pyproject.toml や uv.lock に記載された依存関係をすべてインストール
uv sync

# プロジェクト環境内でスクリプトを実行
uv run python script.py
uv run main.py

# テストも同じコマンドで実行可能
uv run pytest
uv run python -c "import requests; print('OK')"

# 一時的な環境で ruff を実行（インストール不要）
uvx ruff check .

# ツールを恒久的にインストール
uv tool install ruff

echo $PATH
# ~/.local/bin が含まれていることを確認

# ~/.zprofile または ~/.zshenv に追加
export PATH="$HOME/.local/bin:$PATH"
source ~/.zprofile

xcode-select -p    # パスが表示されればOK

xcode-select --install

# Step 1: uv のインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# Step 2: プロジェクト作成
mkdir myproject && cd myproject
uv init
uv python pin 3.12    # Python 3.12 を指定

# Step 3: パッケージ追加
uv add requests
uv add "fastapi>=0.100.0"
uv add pytest --dev

# Step 4: 仮想環境の同期
uv sync

# Step 5: スクリプト実行
uv run python script.py

# インストール確認
uv --version

# Python 管理
uv python list                  # 全バージョン表示
uv python list --only-installed # インストール済み表示
uv python install 3.12          # バージョンインストール
uv python find                  # デフォルトのPythonを表示
uv python dir                   # Python保存先ディレクトリ
uv python pin 3.12              # プロジェクトでバージョン指定

# プロジェクト管理
uv init myproject               # プロジェクト生成
uv add <package>                # パッケージ追加
uv sync                         # 依存関係一括インストール
uv lock                         # ロックファイル生成

# 仮想環境
uv venv                         # .venv を作成
uv venv --python 3.12           # 特定バージョンで仮想環境

# スクリプト実行
uv run python script.py         # プロジェクト環境内で実行
uv run pytest                   # テスト実行

# ツール
uvx ruff check .                # 一時的にツールを実行
uv tool install ruff            # ツールを恒久インストール

# パイプライン（pip互換）
uv pip install requests         # pip install の代替
uv pip compile requirements.in -o requirements.txt

uv self update    # uv を最新バージョンに自動更新

brew upgrade uv   # Homebrew経由で更新

# uvが管理するPythonを確認し、不要な版だけ削除
uv python list --only-installed
uv python uninstall 3.12.4  # 上の一覧から対象のバージョンを選ぶ

# uvで入れたCLIツールを確認し、不要なものだけ削除
uv tool list
uv tool uninstall ruff

# Homebrew版の場合
brew uninstall uv

# スタンドアロン版は command -v uv / command -v uvx で実際の配置先を確認してから
# uv / uvx の実行ファイルだけを削除。変更されたPATH設定も必要に応じて確認