Virtual environment plugins¶

This uses virtual environments backed by the standard virtualenv tool.

Configuration¶

The environment plugin name is virtual.

pyproject.toml hatch.toml

[tool.hatch.envs.<ENV_NAME>]
type = "virtual"

[envs.<ENV_NAME>]
type = "virtual"

Option	Default	Description
`system-packages`	`false`	Whether or not to give the virtual environment access to the system `site-packages` directory
`python`		The version of Python to find on your system and subsequently use to create the environment, defaulting to the `HATCH_PYTHON` environment variable, followed by the Python executable Hatch is running on. For more information, see the documentation.
`env:HATCH_ENV_TYPE_VIRTUAL_PATH`		An explicit path to the virtual environment

Last update: July 2, 2022