简介 🧐

虚拟环境，隔离环境管理控制。
项目依赖，软件包管理控制。
支持各种高级功能。例如依赖项版本覆盖和替代解决策略。
⚡️ 比 pip 和 pip-tools （ pip-compile 和 pip-sync ）快 10-100 倍。
⚖️ 直接替换 common pip 、 pip-tools 和 virtualenv command。

安装 🤭

pip install uv
pipx install uv
yay -S uv
sudo pacman -S uv
brew install uv
winget install uv
apt install uv

使用 😧

虚拟环境 👿

❯ cd PentestGPT  进入测试项目文件夹
❯ ls  列出文件
config  LICENSE.md  logs  Makefile  pentestgpt  PentestGPT_design.md  pyproject.toml  README.md  requirements.txt  resources  setup.py  tasks  test_history  tests

❯ uv venv    建立默认虚拟环境
Using Python 3.12.4 interpreter at: /usr/bin/python3
Creating virtualenv at: .venv
Activate with: source .venv/bin/activate

❯ ls .venv   列出虚拟环境文件夹
bin  CACHEDIR.TAG  lib  lib64  pyvenv.cfg

❯ source .venv/bin/activate   激活虚拟环境
❯                                                                                                                                                                                                 73%

python 版本控制 uv venv -p 3.10
venv 子选项参数

❯ uv venv -h
Create a virtual environment

Usage: uv venv [OPTIONS] [NAME]

Arguments:
  [NAME]  The path to the virtual environment to create [default: .venv]

Options:
  -p, --python <PYTHON>
          The Python interpreter to use for the virtual environment. [env: UV_PYTHON=]
      --system
          Use the system Python to uninstall packages [env: UV_SYSTEM_PYTHON=]
      --seed
          Install seed packages (`pip`, `setuptools`, and `wheel`) into the virtual environment
      --allow-existing
          Preserve any existing files or directories at the target path
      --prompt <PROMPT>
          Provide an alternative prompt prefix for the virtual environment.
      --system-site-packages
          Give the virtual environment access to the system site packages directory
  -i, --index-url <INDEX_URL>
          The URL of the Python package index (by default: <https://pypi.org/simple>) [env:
          UV_INDEX_URL=]
      --extra-index-url <EXTRA_INDEX_URL>
          Extra URLs of package indexes to use, in addition to `--index-url` [env:
          UV_EXTRA_INDEX_URL=]
  -f, --find-links <FIND_LINKS>
          Locations to search for candidate distributions, beyond those found in the indexes
      --no-index
          Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and
          those discovered via `--find-links`
      --index-strategy <INDEX_STRATEGY>
          The strategy to use when resolving against multiple index URLs [env:
          UV_INDEX_STRATEGY=] [possible values: first-index, unsafe-first-match,
          unsafe-best-match]
      --keyring-provider <KEYRING_PROVIDER>
          Attempt to use `keyring` for authentication for index URLs [env: UV_KEYRING_PROVIDER=]
          [possible values: disabled, subprocess]
      --exclude-newer <EXCLUDE_NEWER>
          Limit candidate packages to those that were uploaded prior to the given date [env:
          UV_EXCLUDE_NEWER=]
      --link-mode <LINK_MODE>
          The method to use when installing packages from the global cache [env: UV_LINK_MODE=]
          [possible values: clone, copy, hardlink]
  -q, --quiet
          Do not print any output
  -v, --verbose...
          Use verbose output
      --color <COLOR_CHOICE>
          Control colors in output [default: auto] [possible values: auto, always, never]
      --native-tls
          Whether to load TLS certificates from the platform's native certificate store [env:
          UV_NATIVE_TLS=]
      --offline
          Disable network access, relying only on locally cached data and locally available files
      --toolchain-preference <TOOLCHAIN_PREFERENCE>
          Whether to use system or uv-managed Python toolchains [possible values: only-managed,
          prefer-installed-managed, prefer-managed, prefer-system, only-system]
  -n, --no-cache
          Avoid reading from or writing to the cache [env: UV_NO_CACHE=]
      --cache-dir <CACHE_DIR>
          Path to the cache directory [env: UV_CACHE_DIR=]
      --config-file <CONFIG_FILE>
          The path to a `uv.toml` file to use for configuration [env: UV_CONFIG_FILE=]
  -h, --help
          Print help (see more with '--help')
  -V, --version
          Print version

依赖包、软件包管理 😋

❯ pip -V
pip 24.1.1 from /mgit/PentestGPT/.venv/lib/python3.12/site-packages/pip (python 3.12)
❯ uv pip install -r ./requirements.txt  根据项目中的依赖文件安装依赖
Resolved 113 packages in 32.29s
   Built jieba3k==0.35.1
   Built tinysegmenter==0.3
   Built sgmllib3k==1.0.0
   Built feedfinder2==0.0.4
   Built wrapt==1.14.0

❯ uv pip install uv             指定依赖包名称进行安装
Resolved 1 package in 1.12s
Prepared 1 package in 9.26s
Installed 1 package in 0.72ms
 + uv==0.2.17
 
uv pip install "package @ ."  从本地磁盘安装软件包

根据项目文件，生成锁定依赖文件

uv pip compile requirements.in -o requirements.txt    # Read a requirements.in file.
uv pip compile pyproject.toml -o requirements.txt     # Read a pyproject.toml file.
uv pip compile setup.py -o requirements.txt           # Read a setup.py file.
echo flask | uv pip compile - -o requirements.txt     # Read from stdin.
uv pip freeze | uv pip compile - -o requirements.txt  # Lock the current environment.

根据生成的锁定依赖文件，使用 uv 对虚拟环境中的依赖环境同步

uv pip sync requirements.txt  # Install from a requirements.txt file.

项目测试基本工作流 🦈

大概流程进入项目>指定python版本建立虚拟环境>安装项目依赖。主要的三个步骤。

  ~                                                                                                                                                                                          09:45:1❯ cd mgit/PentestGPT
❯ ls
config  LICENSE.md  logs  Makefile  pentestgpt  PentestGPT_design.md  pyproject.toml  README.md  requirements.txt  resources  setup.py  tasks  test_history  tests
❯

  ~/mgit/PentestGPT   main                                                                                                                                                        ✘ INT  09:51:11
❯                                                                                                                                                                                                 70%
❯ ls
config  LICENSE.md  logs  Makefile  pentestgpt  PentestGPT_design.md  pyproject.toml  README.md  requirements.txt  resources  setup.py  tasks  test_history  tests

  ~/mgit/PentestGPT   main                                                                                                                                                               09:51:11

  ~/mgit/PentestGPT   main                                                                                                                                                               09:51:11
❯                                                                                                                                                                                                 70%
❯ ls
config  LICENSE.md  logs  Makefile  pentestgpt  PentestGPT_design.md  pyproject.toml  README.md  requirements.txt  resources  setup.py  tasks  test_history  tests
❯ uv venv -p 3.10
Using Python 3.10.14 interpreter at: /usr/bin/python3.10
Creating virtualenv at: .venv
Activate with: source .venv/bin/activate
❯ source .venv/bin/activate
❯ uv pip install -e .
Resolved 117 packages in 10.22s
   Built pentestgpt @ file:///home/jjjjjjj/mgit/PentestGPT
   Built sqlmap==1.8.6.post2
Prepared 60 packages in 1m 25s
Installed 117 packages in 32ms
 + aiohttp==3.9.5
 + aiosignal==1.3.1
 + annotated-types==0.7.0
 + anyio==4.4.0
 + async-timeout==4.0.3
 + attrs==23.2.0
 + backoff==2.2.1
 + beautifulsoup4==4.11.2
 + black==24.4.2
 + cachetools==5.3.3
 + certifi==2024.6.2
 + cffi==1.16.0
 + charset-normalizer==3.3.2
 + click==8.1.7
 + colorama==0.4.6
 + cryptography==41.0.4
 + cssselect==1.2.0
 + dataclasses-json==0.6.7
 + distro==1.9.0
 + exceptiongroup==1.2.1
 + feedfinder2==0.0.4
 + feedparser==6.0.11
 + filelock==3.15.4
 + frozenlist==1.4.1
 + google==3.0.0
 + google-ai-generativelanguage==0.6.4
 + google-api-core==2.19.1
 + google-api-python-client==2.135.0
 + google-auth==2.30.0
 + google-auth-httplib2==0.2.0
 + google-generativeai==0.5.4
 + googleapis-common-protos==1.63.2
 + gpt4all==2.7.0
 + greenlet==3.0.3
 + grpcio==1.64.1
 + grpcio-status==1.62.2
 + h11==0.14.0
 + httpcore==1.0.5
 + httplib2==0.22.0
 + httpx==0.25.2
 + idna==3.7
 + importlib-metadata==8.0.0
 + iniconfig==2.0.0
 + jeepney==0.8.0
 + jieba3k==0.35.1
 + joblib==1.4.2
 + jsonpatch==1.33
 + jsonpointer==3.0.0
 + keyring==23.0.0
 + langchain==0.1.20
 + langchain-community==0.0.38
 + langchain-core==0.1.52
 + langchain-text-splitters==0.0.2
 + langfuse==1.9.2
 + langsmith==0.1.82
 + loguru==0.7.2
 + lxml==5.2.2
 + markdown-it-py==3.0.0
 + marshmallow==3.21.3
 + mdurl==0.1.2
 + monotonic==1.6
 + multidict==6.0.5
 + mypy-extensions==1.0.0
 + newspaper3k==0.2.8
 + nltk==3.8.1
 + numpy==1.26.4
 + openai==1.35.7
 + orjson==3.10.5
 + packaging==23.2
 + pathspec==0.12.1
 + pentestgpt==0.14.0 (from file:///home/jjjjj/mgit/PentestGPT)
 + pillow==10.3.0
 + pinecone-client==3.2.2
 + platformdirs==4.2.2
 + pluggy==1.5.0
 + prompt-toolkit==3.0.47
 + proto-plus==1.24.0
 + protobuf==4.25.3
 + pyasn1==0.6.0
 + pyasn1-modules==0.4.0
 + pycookiecheat==0.6.0
 + pycparser==2.22
 + pydantic==2.7.4
 + pydantic-core==2.18.4
 + pygments==2.18.0
 + pyparsing==3.1.2
 + pytest==8.2.2
 + python-dateutil==2.9.0.post0
 + pytz==2023.4
 + pyyaml==6.0.1
 + regex==2024.5.15
 + requests==2.32.3
 + requests-file==2.1.0
 + rich==13.7.1
 + rsa==4.9
 + secretstorage==3.3.3
 + sgmllib3k==1.0.0
 + six==1.16.0
 + sniffio==1.3.1
 + soupsieve==2.5
 + sqlalchemy==2.0.31
 + sqlmap==1.8.6.post2
 + tenacity==8.4.2
 + tiktoken==0.6.0
 + tinysegmenter==0.3
 + tldextract==5.1.2
 + toml==0.10.2
 + tomli==2.0.1
 + tqdm==4.66.4
 + typing-extensions==4.12.2
 + typing-inspect==0.9.0
 + uritemplate==4.1.1
 + urllib3==2.2.2
 + wcwidth==0.2.13
 + wrapt==1.14.0
 + yarl==1.9.4
 + zipp==3.19.2

  ~/mgit/PentestGPT   main                                                                                                                                         1m 36s  PentestGPT  10:00:27
❯                                                                                                                                                                                                 65%