.. _DUNE_PYTHON_VIRTUALENV_SETUP:

DUNE_PYTHON_VIRTUALENV_SETUP
============================

.. cmake_variable:: DUNE_PYTHON_VIRTUALENV_SETUP

   Set this variable to allow the Dune build system to set up a virtualenv at
   configure time. Such virtual environment is very useful, whenever python code
   is to be run at configure time, i.e. to implement code generation in Python or
   to use Python wrappers in testing. Some downstream modules will *require* you
   to set this variable. When setting this variable, you allow the Dune buildsystem
   to install packages through :code:`pip` into a virtualenv, that resides in a cmake
   build directory. For all the information on this virtualenv, see :ref:`DunePythonVirtualenv`.

