博士

やっほー、ロボ子！今日はすごいニュースがあるのじゃ！uvとPEP 723を使うと、Pythonスクリプトの配布が超簡単になるらしいぞ！

ロボ子

博士、こんにちは。uvとPEP 723ですか？それは一体どんなものなのですか？

博士

PEP 723っていうのは、スクリプトに必要な情報、例えば外部パッケージの依存関係を、一つのPythonファイルに埋め込むための標準規格のことなのじゃ。Python Steering Councilも認めた公式な仕様らしいぞ。

ロボ子

なるほど、スクリプトに必要な情報が一つにまとまるのですね。具体的にはどうやるんですか？

博士

まずはuvをインストールするのじゃ！ `pipx install uv` か `pip install uv` でOKだぞ。オススメはpipxらしい。

ロボ子

インストールは簡単ですね。その後はどうすれば？

博士

`uv add --script <スクリプト名>.py <パッケージ名>` ってコマンドで、スクリプトに必要なパッケージを追加するのじゃ。例えば、`uv add --script wordlookup.py httpx` って感じだぞ。

ロボ子

なるほど、コマンド一つで依存関係を追加できるんですね。バージョン指定もできるんですか？

博士

もちろん！ `uv add --script wordlookup.py "httpx>=0.28.1"` みたいに書けば、バージョン制約もつけられるぞ！

ロボ子

それは便利ですね！スクリプトを実行するときはどうすればいいんですか？

博士

`uv run <スクリプト名>.py` で実行するのじゃ！初回実行時には、uvがPythonのバージョンを確認して、必要な仮想環境を作って、依存関係をインストールしてくれるぞ。

ロボ子

仮想環境も自動で作成してくれるんですね。LinuxやmacOSで直接実行するにはどうすれば？

博士

スクリプトの最初に `#!/usr/bin/env -S uv run --script` を追加して、`chmod u+x <スクリプト名>.py` で実行権限を与えれば、`./<スクリプト名>.py` で直接実行できるのじゃ！

ロボ子

Windowsの場合はどうですか？

博士

Windowsなら、スクリプトの最初に `#!/usr/bin/env uv run --script` を追加して、`py <スクリプト名>.py` で実行できるぞ。

ロボ子

システム全体で実行できるようにするには？

博士

Linux/macOSなら、スクリプトを `$PATH` に含まれるディレクトリに移動して、`.py` 拡張子を削除するのじゃ。Windowsなら、スクリプトを `PATH` に含まれるディレクトリに移動して、`*.cmd` ファイルを作って `py <スクリプトパス>.py %*` を記述するぞ。

ロボ子

仮想環境はどこに作成されるんですか？

博士

Linux/macOSなら `~/.cache/uv/environments-v2/`、Windowsなら `%LOCALAPPDATA%\uv\cache\environments-v2` にできるみたいじゃな。環境変数 `$XDG_CACHE_HOME` で場所を変更することもできるぞ。

ロボ子

キャッシュをクリアしたい場合は？

博士

`uv cache clean` コマンドでキャッシュされた仮想環境を削除できるのじゃ。

ロボ子

uvとPEP 723を使うことで、単一ファイルのPythonスクリプトの依存関係管理がとても簡単になるんですね！

博士

そういうことなのじゃ！これで、ロボ子も私も、もっと楽にスクリプトを配布できるぞ！

ロボ子

ありがとうございます、博士！

博士

ところでロボ子、uvって名前、紫外線(UV)みたいで日焼け止めみたいじゃない？

ロボ子

確かにそうですね、博士。でも、Pythonスクリプトを紫外線から守るわけではないですよ？

博士

あはは、それもそうじゃな！