DunePythonTestCommand
---------------------

Helpers for integrating Python-based tests into the DUNE test infrastructure.

.. cmake:command:: dune_python_add_test

  Register a Python script or module as a DUNE test.

  .. code-block:: cmake

    dune_python_add_test(
      [SCRIPT <script...>]
      [MODULE <module...>]
      [LABELS <labels...>]
      [WORKING_DIRECTORY <dir>]
      [TIMEOUT <seconds>]
      [NAME <name>]
      ...
    )

  ``SCRIPT``
    Script path to execute with the Python interpreter. Pass the script path
    only, not the interpreter itself. Either ``SCRIPT`` or ``MODULE`` must be
    provided.

  ``MODULE``
    Python module to execute with ``python -m``. Either ``SCRIPT`` or
    ``MODULE`` must be provided.

  ``LABELS``
    Labels attached to the test. The label ``python`` is added by default. The
    labels are forwarded to :cmake:command:`dune_add_test()`.

  ``WORKING_DIRECTORY``
    Working directory used for the command. The default is the current build
    directory.

  ``TIMEOUT``
    Timeout in seconds. This overrides the default ctest timeout.

  ``NAME``
    Explicit ctest name for the generated test. If omitted, the name is
    derived from the command and working directory.

  The command integrates a Python-based test into the DUNE build system so it
  is built through ``test_python`` and executed through ``ctest``. Unparsed
  arguments are forwarded to :cmake:command:`dune_add_test()`.