Uv のミニマム

メインページ>コンピュータの部屋#Python>uv tips

インストール

Powershellでこれを打つだけです。pythonは不要。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

プロジェクト作成から実行まで

Powershellのプロンプトで

指定フォルダ(プロジェクト名)にプロジェクトを作成

uv init <プロジェクト名>

指定フォルダに移動

cd <プロジェクト名>

仮想環境作成/更新

uv sync

これでプロジェクトの動くひな形は完成です。

実行

uv run <プロジェクト名>

下記のように表示されたら成功

Hello from <プロジェクト名>!

簡単ですよね。

プロジェクトディレクトリにできるもの

プロジェクトのディレクトリ
│  .python-version　　　　pythonバージョンファイル 3.14 とか入ってます。
│  pyproject.toml　　　　 プロジェクトファイル
│  README.md　　　　　　　プロジェクトの README  空です。 
│  uv.lock　　　　　　　　uv sync が生成したロックファイル
│
├─.venv　仮想環境
│
└─src　　　　　　　　　　パッケージのsrcフォルダ(トップ)
    └─プロジェクト名　　　トップのパッケージ名=プロジェクト名
        └  __init__.py　　パッケージの __init__.py

pyproject.toml

[project]
name = "プロジェクト名"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
authors = [
    { name = "作者名", email = "作者 emailアドレス" }
]
requires-python = ">=3.14"
dependencies = []

[project.scripts]
プロジェクト名 = "プロジェクト名:main"

[build-system]
requires = ["uv_build>=0.12.6,<0.13.0"]
build-backend = "uv_build"

最低限の設定は終わってます。

プロジェクトのエントリポイントは [project.scripts] に設定済みなので、 直ちにプロジェクト名で起動できます。

ビルドシステムも設定済みなので、uv build でwheel を作成、ub publishでリポジトリサーバーへ登録できます。

__init__.py

def main() -> None:
    print("Hello from <プロジェクト名>!")

既定のアプリ内容は Hello World のみ。