.. 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()
`) и вызывается
обработка входа (вызывается функция :py:func:`logon.logon() `).
.. note::
Для отладки обработки выхода (функция :py:func:`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:`системы событий `.
Первый раз без ошибки
:py:func:`event.before_event() `
:py:func:`event.after_event() `
второй с ошибкой
:py:func:`event.before_event() `
:py:func:`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