uv/docs/reference
John Mumm 2df06ebfbc Require uv venv --clear before removing an existing directory (#14309)
By default, `uv venv <venv-name>` currently removes the `<venv-name`>
directory if it exists. This can be surprising behavior: not everyone
expects an existing environment to be overwritten. This PR updates the
default to fail if a non-empty `<venv-name>` directory already exists
and neither `--allow-existing` nor the new `-c/--clear` option is
provided (if a TTY is detected, it prompts first). If it's not a TTY,
then uv will only warn and not fail for now — we'll make this an error
in the future. I've also added a corresponding `UV_VENV_CLEAR` env var.

I've chosen to use `--clear` instead of `--force` for this option
because it is used by the `venv` module and `virtualenv` and will be
familiar to users. I also think its meaning is clearer in this context
than `--force` (which could plausibly mean force overwrite just the
virtual environment files, which is what our current `--allow-existing`
option does).

Closes #1472.

---------

Co-authored-by: Zanie Blue <contact@zanie.dev>
2025-07-17 17:20:21 -05:00
..
policies Add 3.14 to the supported platform reference (#13990) 2025-06-12 15:18:48 +00:00
troubleshooting Fix and improve docs (#13620) 2025-06-10 13:15:38 -05:00
benchmarks.md Add link to benchmarks in documentation (#6257) 2024-08-20 12:54:46 -04:00
cli.md Require uv venv --clear before removing an existing directory (#14309) 2025-07-17 17:20:21 -05:00
environment.md Require uv venv --clear before removing an existing directory (#14309) 2025-07-17 17:20:21 -05:00
index.md Add policies reference section and license document (#9367) 2024-12-03 10:56:32 -06:00
installer.md Fix and improve docs (#13620) 2025-06-10 13:15:38 -05:00
resolver-internals.md Update resolver internals docs (#11098) 2025-02-04 13:06:27 +00:00
settings.md Multiple modules in namespace packages (#14460) 2025-07-09 17:45:44 +00:00