#####################################
cmake_test/register_exception_handler
#####################################

.. module:: cmake_test/register_exception_handler

   
   .. warning::
      This module requires :obj:`cmake_test/overrides`, and so will override
      the :code:`message()` command upon inclusion.
   
   .. attention::
      This module is intended for internal use only.
   


.. function:: ct_register_exception_handler()

   Defines the exception handler and registers it with CMakePP.
   
   The exception handler stores exception information about the currently
   running test, then re-executes :code:`ct_exec_tests()` so that all remaining
   tests are ran. Once all tests are ran, all exceptions are looped over and
   printed before the interpreter is forceably shutdown.