mirrors/uv
1
0
Fork 0
mirror of https://github.com/astral-sh/uv.git synced 2025-08-31 07:47:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Improve project handling in uv venv (#6835)

Browse source 
- Respect `UV_PROJECT_ENVIRONMENT` when in project root
- Add `--no-project` and `--no-workspace` to opt-out of above and
`requires-python` detection
- Rename `[NAME]` to `[PATH]` in CLI
This commit is contained in:
Zanie Blue 2024-09-03 14:22:30 -05:00 • committed by GitHub
parent 1e89d3e44f
commit d87256bebe
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 153 additions and 33 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/reference/cli.md
View file

@ -5956,6 +5956,8 @@ Create a virtual environment.
By default, creates a virtual environment named `.venv` in the working directory. An alternative path may be provided positionally.
If in a project, the default environment name can be changed with the `UV_PROJECT_ENVIRONMENT` environment variable; this only applies when run from the project root directory.
If a virtual environment exists at the target path, it will be removed and a new, empty virtual environment will be created.
When using uv, the virtual environment does not need to be activated. uv will find a virtual environment (named `.venv`) in the working directory or any parent directories.
@ -5963,12 +5965,16 @@ When using uv, the virtual environment does not need to be activated. uv will fi
<h3 class="cli-reference">Usage</h3>
```
uv venv [OPTIONS] [NAME]
uv venv [OPTIONS] [PATH]
```
<h3 class="cli-reference">Arguments</h3>
<dl class="cli-reference"><dt><code>NAME</code></dt><dd><p>The path to the virtual environment to create</p>
<dl class="cli-reference"><dt><code>PATH</code></dt><dd><p>The path to the virtual environment to create.</p>
<p>Default to <code>.venv</code> in the working directory.</p>
<p>Relative paths are resolved relative to the working directory.</p>
</dd></dl>
@ -6105,6 +6111,10 @@ uv venv [OPTIONS] [NAME]
<p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-project</code></dt><dd><p>Avoid discovering a project or workspace.</p>
<p>By default, uv searches for projects in the current directory or any parent directory to determine the default path of the virtual environment and check for Python version constraints, if any.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python.</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>