.. _DUNE_PYTHON_INSTALL_LOCATION:

DUNE_PYTHON_INSTALL_LOCATION
============================

.. cmake_variable:: DUNE_PYTHON_INSTALL_LOCATION

   This variable can be used to control where Dune should install python
   packages. Possible values are:

   * :code:`user`: installs into the users home directory through :code:`pip --user`. Note, that
     this is incompatible with using virtual environments (as per pip docs).
   * :code:`system`: into the standard paths of the interpreter which was found
     by cmake.
   * :code:`none`: Never install any python packages.

   The default value in use depends on the system interpreter to run in a virtual environment
   or not: If it does, :code:`system` is the default, if it does not :code:`none` is the default.
   This rather unintuitive default originates from the strong belief, that installing
   python packages into the system locations at :code:`/usr/...` should be discouraged.

