{"id":2317,"library":"tox-uv-bare","title":"tox-uv-bare","description":"tox-uv-bare is a plugin for tox that integrates the `uv` dependency manager, allowing tox to leverage `uv`'s speed for virtual environment creation and dependency resolution. This 'bare' package requires users to provide their own `uv` installation. The current version is 1.35.0, and the project has a frequent release cadence, often issuing multiple bug fix and minor feature updates per month.","status":"active","version":"1.35.0","language":"en","source_language":"en","source_url":"https://github.com/tox-dev/tox-uv","tags":["tox","uv","virtual environment","plugin","dependency management","packaging"],"install":[{"cmd":"pip install tox-uv-bare","lang":"bash","label":"Install tox-uv-bare"},{"cmd":"pip install uv","lang":"bash","label":"Install uv (required for bare package)"}],"dependencies":[{"reason":"Core dependency for the tox plugin system.","package":"tox","optional":false}],"imports":[{"note":"The `tox_uv` module is loaded by tox when `plugins = tox_uv` is specified in tox.ini. Users rarely interact with its Python API directly.","symbol":"tox_uv","correct":"This is a tox plugin, typically enabled via tox.ini. Direct Python imports by end-users are uncommon."}],"quickstart":{"code":"# tox.ini\n[tox]\nrequires = tox-uv-bare\nplugins = tox_uv\nenv_list = py\n\n[testenv:py]\ncommands = python -c \"import sys; print(f'Python: {sys.version}')\"\n           python -c \"import uv; print(f'uv is available')\" # This command will fail, uv is not imported into the venv directly\n           # To check uv is working, ensure it was used to create the venv and install deps\n           python -c \"print('Hello from uv-managed environment!')\"\n\n# Or a minimal example in pyproject.toml\n# [tool.tox]\n# requires = [\"tox-uv-bare\"]\n# plugins = [\"tox_uv\"]\n# env_list = [\"py\"]\n\n# [testenv:py]\n# commands = [\"python -c \\\"import sys; print(f'Python: {sys.version}')\\\"\"]","lang":"toml","description":"To use tox-uv-bare, you need to enable it as a plugin in your `tox.ini` or `pyproject.toml` file under the `[tox]` section. Remember that `uv` itself must be installed and available in your system's PATH, as this is the 'bare' package. `tox-uv-bare` integrates `uv` for virtual environment creation and dependency installation, but does not provide `uv` as a Python dependency within the created environment."},"warnings":[{"fix":"Ensure `uv` is installed and accessible in your system's PATH (e.g., `uv --version` should work from your terminal).","message":"The `tox-uv-bare` package explicitly requires you to 'bring your own uv'. This means `uv` must be installed separately (e.g., `pip install uv` or via pre-built binaries) and available in your system's PATH. If `uv` is not found, tox will fall back to its default installer, or the environment creation will fail.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Upgrade your Python environment to 3.10 or later where `tox-uv-bare` is installed.","message":"`tox-uv-bare` requires Python 3.10 or newer. Attempting to use it with older Python versions will lead to installation failures or unexpected runtime errors.","severity":"breaking","affected_versions":"All versions"},{"fix":"Upgrade to `tox-uv-bare` version 1.35.0 or newer to ensure `UV_*` environment variable changes properly invalidate the install cache.","message":"Changes to environment variables prefixed with `UV_` (e.g., `UV_EXCLUDE_NEWER`) now correctly invalidate `tox-uv`'s install cache. Prior to version 1.35.0, changes to these variables might not have triggered a cache invalidation, leading to stale environments or unexpected behavior.","severity":"gotcha","affected_versions":"<1.35.0"},{"fix":"For a batteries-included experience, install `tox-uv` (`pip install tox-uv`) instead of `tox-uv-bare`.","message":"For new projects, consider using the `tox-uv` meta-package instead of `tox-uv-bare`. The `tox-uv` meta-package includes `uv` as a dependency, simplifying installation by not requiring a separate `uv` installation. `tox-uv-bare` is primarily for users who prefer to manage their `uv` installation independently.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}