Managing packagesパッケージの管理

Installing a packageパッケージのインストール

To install a package into the virtual environment, e.g., Flask:仮想環境にパッケージをインストールするには、例えば、Flask:

$ uv pip install flask

To install a package with optional dependencies enabled, e.g., Flask with the "dotenv" extra:オプションの依存関係を有効にしてパッケージをインストールするには、例えば、"dotenv"エクストラ付きのFlask:

$ uv pip install "flask[dotenv]"

To install multiple packages, e.g., Flask and Ruff:複数のパッケージをインストールするには、例えば、FlaskとRuff:

$ uv pip install flask ruff

To install a package with a constraint, e.g., Ruff v0.2.0 or newer:制約付きでパッケージをインストールするには、例えば、Ruff v0.2.0 以上を指定します:

$ uv pip install 'ruff>=0.2.0'

To install a package at a specific version, e.g., Ruff v0.3.0:特定のバージョンのパッケージをインストールするには、例えば、Ruff v0.3.0 を指定します:

$ uv pip install 'ruff==0.3.0'

To install a package from the disk:ディスクからパッケージをインストールするには:

$ uv pip install "ruff @ ./projects/ruff"

To install a package from GitHub:GitHubからパッケージをインストールするには:

$ uv pip install "git+https://github.com/astral-sh/ruff"

To install a package from GitHub at a specific reference:特定のリファレンスからGitHubからパッケージをインストールするには:

$ # Install a tag
$ uv pip install "git+https://github.com/astral-sh/ruff@v0.2.0"

$ # Install a commit
$ uv pip install "git+https://github.com/astral-sh/ruff@1fadefa67b26508cc59cf38e6130bde2243c929d"

$ # Install a branch
$ uv pip install "git+https://github.com/astral-sh/ruff@main"

See the Git authentication documentation for installation from a private repository.プライベートリポジトリからのインストールについては、Git認証のドキュメントを参照してください。

Editable packages編集可能なパッケージ

Editable packages do not need to be reinstalled for changes to their source code to be active.編集可能なパッケージは、ソースコードの変更を有効にするために再インストールする必要はありません。

To install the current project as an editable package現在のプロジェクトを編集可能なパッケージとしてインストールするには

$ uv pip install -e .

To install a project in another directory as an editable package:別のディレクトリにあるプロジェクトを編集可能なパッケージとしてインストールするには:

$ uv pip install -e "ruff @ ./project/ruff"

Installing packages from filesファイルからパッケージをインストールする

Multiple packages can be installed at once from standard file formats.標準ファイル形式から複数のパッケージを一度にインストールできます。

Install from a requirements.txt file:requirements.txt ファイルからインストールする:

$ uv pip install -r requirements.txt

See the uv pip compile documentation for more information on requirements.txt files.requirements.txt ファイルに関する詳細は、uv pip compile ドキュメントを参照してください。

Install from a pyproject.toml file:pyproject.toml ファイルからインストールする:

$ uv pip install -r pyproject.toml

Install from a pyproject.toml file with optional dependencies enabled, e.g., the "foo" extra:オプションの依存関係が有効な pyproject.toml ファイルからインストールする。例えば、"foo" エクストラ:

$ uv pip install -r pyproject.toml --extra foo

Install from a pyproject.toml file with all optional dependencies enabled:すべてのオプションの依存関係が有効な pyproject.toml ファイルからインストールする:

$ uv pip install -r pyproject.toml --all-extras

To install dependency groups in the current project directory's pyproject.toml, for example the group foo:現在のプロジェクトディレクトリの pyproject.toml にある依存関係グループをインストールするには、例えばグループ foo:

$ uv pip install --group foo

To specify the project directory where groups should be sourced from:グループがソースされるプロジェクトディレクトリを指定するには:

$ uv pip install --project some/path/ --group foo --group bar

Alternatively, you can specify a path to a pyproject.toml for each group:また、各グループのためにpyproject.tomlへのパスを指定することもできます:

$ uv pip install --group some/path/pyproject.toml:foo --group other/pyproject.toml:bar

Note注意

As in pip, --group flags do not apply to other sources specified with flags like -r or -e. For instance, uv pip install -r some/path/pyproject.toml --group foo sources foo from ./pyproject.toml and not some/path/pyproject.toml.pip と同様に、--group フラグは -r や -e のようなフラグで指定された他のソースには適用されません。 例えば、uv pip install -r some/path/pyproject.toml --group foo は ./pyproject.toml から foo をソースし、not some/path/pyproject.toml からソースします。

Uninstalling a packageパッケージをアンインストールする

To uninstall a package, e.g., Flask:パッケージをアンインストールするには、例えば、Flask:

$ uv pip uninstall flask

To uninstall multiple packages, e.g., Flask and Ruff:複数のパッケージをアンインストールするには、例えば、FlaskとRuff:

$ uv pip uninstall flask ruff