紫外线

其他源码

0.5.1

下载

紫外线

一个非常快的 Python 包和项目管理器，用 Rust 编写。

显示带有基准测试结果的条形图。

使用热缓存安装 Trio 的依赖项。

亮点

一个替代pip 、 pip-tools 、 pipx 、 poetry 、 pyenv 、 twine 、 virtualenv等的工具。
⚡️ 比pip快 10-100 倍。
？安装和管理 Python 版本。
运行并安装 Python 应用程序。
❇️ 运行单文件脚本，支持内联依赖元数据。
提供全面的项目管理和通用锁定文件。
？包括 pip 兼容的界面，可通过熟悉的 CLI 提高性能。
？支持可扩展项目的 Cargo 风格工作区。
？磁盘空间效率高，具有用于重复数据删除的全局缓存。
⏬ 可通过curl或pip安装，无需Rust 或Python。
?️ 支持 macOS、Linux 和 Windows。

uv 得到了 Ruff 的创建者 Astral 的支持。

安装

使用我们的独立安装程序安装 uv：

 # On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

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

或者，来自 PyPI：

 # With pip.
pip install uv

 # Or pipx.
pipx install uv

如果通过独立安装程序安装，uv 可以将自身更新到最新版本：

uv self update

有关详细信息和替代安装方法，请参阅安装文档。

文档

uv 的文档可在 docs.astral.sh/uv 获取。

此外，可以使用uv help查看命令行参考文档。

特征

项目管理

uv 管理项目依赖项和环境，支持锁定文件、工作区等，类似于rye或poetry ：

$ uv init example
Initialized project `example` at `/home/user/example`

$ cd example

$ uv add ruff
Creating virtual environment at: .venv
Resolved 2 packages in 170ms
   Built example @ file:///home/user/example
Prepared 2 packages in 627ms
Installed 2 packages in 1ms
 + example==0.1.0 (from file:///home/user/example)
 + ruff==0.5.4

$ uv run ruff check
All checks passed!

请参阅项目文档以开始使用。

uv 还支持构建和发布项目，即使它们不是用 uv 管理的。请参阅发布指南以了解更多信息。

刀具管理

uv 执行并安装 Python 包提供的命令行工具，类似于pipx 。

使用uvx （ uv tool run的别名）在临时环境中运行工具：

------------ ^__^ (oo)_______ (__) )/ ||----w | || ||">

$ uvx pycowsay ' hello world! '
Resolved 1 package in 167ms
Installed 1 package in 9ms
 + pycowsay==0.0.0.2
  """

  ------------
< hello world! >
  ------------
      ^__^
      (oo)_______
       (__)       )/
           ||----w |
           ||     ||

使用uv tool install安装工具：

$ uv tool install ruff
Resolved 1 package in 6ms
Installed 1 package in 2ms
 + ruff==0.5.4
Installed 1 executable: ruff

$ ruff --version
ruff 0.5.4

请参阅工具文档以开始使用。

Python管理

uv 安装 Python 并允许在版本之间快速切换。

安装多个Python版本：

$ uv python install 3.10 3.11 3.12
Searching for Python versions matching: Python 3.10
Searching for Python versions matching: Python 3.11
Searching for Python versions matching: Python 3.12
Installed 3 versions in 3.42s
 + cpython-3.10.14-macos-aarch64-none
 + cpython-3.11.9-macos-aarch64-none
 + cpython-3.12.4-macos-aarch64-none

根据需要下载Python版本：

>>>">

$ uv venv --python 3.12.0
Using Python 3.12.0
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

$ uv run --python [email protected] -- python --version
Python 3.8.16 (a9dbdca6fc3286b0addd2240f11d97d8e8de187a, Dec 29 2022, 11:45:30)
[PyPy 7.3.11 with GCC Apple LLVM 13.1.6 (clang-1316.0.21.2.5)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>>

使用当前目录中的特定Python版本：

$ uv python pin [email protected]
Pinned `.python-version` to `[email protected]`

请参阅 Python 安装文档以开始使用。

脚本支持

uv 管理单文件脚本的依赖关系和环境。

创建一个新脚本并添加内联元数据声明其依赖项：

example.py $ uv add --script example.py requests Updated `example.py`">

$ echo ' import requests; print(requests.get("https://astral.sh")) ' > example.py

$ uv add --script example.py requests
Updated `example.py`

然后，在隔离的虚拟环境中运行脚本：

$ uv run example.py
Reading inline script metadata from: example.py
Installed 5 packages in 12ms

请参阅脚本文档以开始使用。

与 pip 兼容的接口

uv 提供了常见pip 、 pip-tools和virtualenv命令的直接替代。

uv 通过高级功能扩展了其接口，例如依赖版本覆盖、独立于平台的分辨率、可重现的分辨率、替代分辨率策略等等。

使用uv pip界面，无需更改现有工作流程即可迁移到 uv，并体验 10-100 倍的加速。

将需求编译成与平台无关的需求文件：

$ uv pip compile docs/requirements.in 
   --universal 
   --output-file docs/requirements.txt
Resolved 43 packages in 12ms

创建虚拟环境：

$ uv venv
Using Python 3.12.3
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

安装锁定要求：

$ uv pip sync docs/requirements.txt
Resolved 43 packages in 11ms
Installed 43 packages in 208ms
 + babel==2.15.0
 + black==24.4.2
 + certifi==2024.7.4
 ...

请参阅 pip 接口文档以开始使用。