.. _dune_python_find_package:

dune_python_find_package
========================

.. cmake_function:: dune_python_find_package

   .. cmake_param:: PACKAGE
      :required:
      :single:

      The package name to look for.

   .. cmake_param: RESULT
      :single:

      The variable to store the result of the check in
      in the calling scope. Defaults to :code:`DUNE_PYTHON_<package>_FOUND`
      Note that the package name is case sensitive and will
      usually be lowercase.

   .. cmake_param:: REQUIRED
      :option:

      If set, the function will error out if the package is not
      found.

   .. cmake_param:: VERSION
      :single:

      The minimum version of the package that is required.

   .. cmake_param:: EXACT
      :option:

      Whether the given version requirement has to be matched exactly.

   .. cmake_param:: INTERPRETER
      :single:

      The python interpreter, whose paths are searched for the package.
      Defaults to :code:`${PYTHON_EXECUTABLE}`, might differ when dealing with
      the configure-time virtualenv set up with :ref:`DUNE_PYTHON_VIRTUALENV_SETUP`.

   Find a given python package on the system.

