UV使用教程
创建项目
bash
uv init xxx --package
创建虚拟环境
注意如果想要顺畅的使用系统包,最好添加
--system-site-packages
bash
uv venv --python /usr/bin/python3.12 --system-site-packages
安装依赖
bash
uv add toml
在pypi上能找到的包都可以用以下命令安装
bash
uv pip install pin
激活虚拟环境并运行
bash
uv run main.py
等价与
bash
source .venv/bin/activate
python main.py
删除虚拟环境
bash
rm -rf .venv
复现环境
bash
uv sync
管理命行工具
全局安装工具
bash
uv tool install pytest
可以直接使用,而不需要虚拟环境
bash
pytest
调用其他项目
安装包
bash
uv pip install -e ../xxx-SDK
or
# uv add --editable ../xxx-SDK
安装whl包
bash
uv pip install ./xxx.whl
安装当前项目到当前环境
用于测试
bash
uv pip install -e .
docs
bash
uv add sphinx sphinx-autodoc-typehints furo
初始化Sphnix
bash
uv run sphinx-quickstart docs
构建
- 对于需要配置文件的项目,最好使用
setuptools作为构建后端 whl包
bash
uv build
uv build --wheel
源码包
bash
uv build --sdist
manylinux
bash
docker run -it --rm -v $(pwd):/io quay.io/pypa/manylinux2014_x86_64 bash
cd /io
uv build --wheel