本記事ではUVの使用方法をメモします。
公式ドキュメントはこちらです。
インストール
pipxを使ったインストール方法は以下です。pipx以外のインストール方法は公式ドキュメントのインストールのセクションをご確認ください。
pipx install uv
Python管理
特定のバージョンのPythonをインストールするには以下を実行します。
uv python install 3.12
プロジェクトでPythonバージョンを固定するにはpinを実行します。
uv python pin 3.12
すると、.python-versionが作成され、Pythonバージョンが保存されます。
仮想環境の作成
venvコマンドで環境を作成します。
uv venv
その後、次のコマンドで仮想環境を有効化できます。
source .venv/bin/activate
プロジェクト管理
uv initでプロジェクトを初期化します。
uv init uv-test
cd uv-test
初期化すると、以下のディレクトリ構成でファイルが作成されます。
uv-test
├── main.py
├── pyproject.toml
└── README.md
pyproject.tomlは以下のようになっています。
# pyproject.toml
[project]
name = "uv-test"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.12"
dependencies = []
ライブラリの追加・削除
ライブラリを追加するにはuv addを実行します。
uv add pandas
開発環境のみにライブラリを追加するにはdevオプションをつけます。
uv add --dev pytest
パッケージを削除したいときはuv removeを使います。
uv remove pytest
pyproject.tomlでライブラリのバージョン指定を追加する場合、以下を参考に追記します。
[project]
name = "albatross"
version = "0.1.0"
dependencies = [
# Any version in this range
"tqdm >=4.66.2,<5",
# Exactly this version of torch
"torch ==2.2.2",
# Install transformers with the torch extra
"transformers[torch] >=4.39.3,<5",
# Only install this package on older python versions
# See "Environment Markers" for more information
"importlib_metadata >=7.1.0,<8; python_version < '3.10'",
"mollymawk ==0.1.0"
]
コメント