.. only:: html

.. _capi-debug:

Отладка    
==========================

В приложение Cerebro встроен функционал для упрощения тестирования
и отладки ваших Python-модулей. Он расположен на Панели отладки
Python. По умолчанию эта панель скрыта. Показать её можно из
Главного меню/Вид/Панель отладки Python.

Панель отладки Python:

.. image:: ../img/capi_debug_tools.png
    :align: center

Кнопки панели:

.. _capi_restart_btn:
    
.. figure:: ../img/capi_restart_btn.png
    :align: left
    :figwidth: 30px

-- полностью перезагружает Python и все модули без перезагрузки
приложения. После перезагрузки подхватываются все изменения
в всех модулях, заново пересоздаются пункты меню
(вызывается функция :py:func:`menu.init_menu() <menu.init_menu>`) и вызывается
обработка входа (вызывается функция :py:func:`logon.logon() <logon.logon>`).

.. note::
    Для отладки обработки выхода (функция :py:func:`logoff.logoff() <logoff.logoff>`)
    достаточно делать завершение сеанса без выхода из программы
    - Главное меню/Cerebro Serpens/Завершить сеанс.

.. _capi_test_btn:

.. figure:: ../img/capi_test_btn.png
    :align: left
    :figwidth: 30px

-- дважды генерирует тестовое событие
(:py:const:`cerebro.events.Event.EVENT_TEST`)
для проверки :ref:`системы событий <capi-event>`.

Первый раз без ошибки

:py:func:`event.before_event() <event.before_event>`

:py:func:`event.after_event() <event.after_event>`

второй с ошибкой

:py:func:`event.before_event() <event.before_event>`

:py:func:`event.error_event() <event.error_event>`

Перед генерацией события выполняется полная перезагрузка Python.
В обработке этого события вы можете писать код для тестирования,
изучения программного интерфейса. Он будет исполнятся каждый раз
при нажатии на эту кнопку.

.. _capi_updating_btn:
    
.. figure:: ../img/capi_updating_btn.png
    :align: left
    :figwidth: 30px

-- переключает режим отладки. Включенное состояние означает,
что при каждом обращении к Python-модулям из приложения,
происходит из перезагрузка, что обеспечивает подхватывание
всех изменений в этих модулях в реальном времени.
Это замедляет работу приложения, поэтому не забывайте отключать
эту опцию после проведения отладочных работ.

.. figure:: ../img/capi_console_btn.png
    :align: left
    :figwidth: 30px

-- открывает консоль вывода информации из Python-модулей.
Такая консоль существует только в версии для ОС Windows.

Просмотр отладочной информации
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

В операционных системах Linux и Mac OS X для просмотра отладочной
информации необходимо запускать Cerebro из консоли (терминала).
В этом случае в него будет выводиться отладочная информация
приложения и сообщения из Python-модулей.

.. image:: ../img/capi_console.png
    :align: center

В операционной системе Windows для просмотра сообщений
из Python-модулей нужно открыть консоль вывода информации
Python, а для просмотра отладочной информации приложения нужно
открыть окно Cargador из Главного меню/Инструменты/Окно Cargador.

.. image:: ../img/capi_console_win.png
    :align: center