LogViewer (Расширение просмотрщика журналов)

Авторы: chai chaimee & Pierre-Louis R.

URL: https://github.com/chaichaimee/logViewer

Что нового

Добавлена функция oldLog.

Возможности

logViewer расширяет функциональность встроенного в NVDA просмотрщика логов, делая его более мощным инструментом для разработчиков и опытных пользователей, которым необходимо эффективно анализировать логи. Ключевые возможности включают:

• Расширенный поиск:
  Нажмите Control+F, чтобы открыть диалог поиска.
  Поддерживает поиск с учётом регистра, зацикливание, регулярные выражения и историю поиска для быстрого повторного использования предыдущих запросов.

• Быстрая навигация по результатам поиска:
  Переход к следующему результату поиска с помощью F3 или возврат к предыдущему с помощью Shift+F3 — без повторного открытия диалога поиска.

• Система закладок:
  Добавление закладок с помощью Control+F2.
  Навигация между закладками с помощью F2 (следующая) и Shift+F2 (предыдущая).

• Резервное копирование старого лога (oldLog):
  Когда NVDA автоматически перезапускается после сбоя, лог, который вам нужно будет проверить, — это файл oldLog. Нажмите NVDA+Control+L.
  Этот файл создаётся и отслеживается в фоновом режиме во время работы NVDA. После того, как NVDA аварийно завершает работу и перезапускается из-за ошибки, файл oldLog.txt содержит записи последнего сеанса.

Функциональность работы со старыми логами (Old Log)

Плагин LogViewer включает функции для управления и сохранения содержимого логов NVDA в файле oldLog.txt, обеспечивая резервное копирование и доступность логов текущего и предыдущих сеансов.

Ключевые возможности

• Автоматическое резервное копирование логов: постоянно сохраняет новое содержимое лога NVDA в файл oldLog.txt в каталоге конфигурации NVDA каждые 5 секунд, используя инкрементальное чтение для эффективности.
• Логи предыдущего сеанса: добавляет лог предыдущего сеанса (nvda-old.log) в oldLog.txt при запуске NVDA, с помеченным временем заголовком для ясности.
• Ежедневный сброс: сбрасывает oldLog.txt с новым помеченным временем заголовком при смене даты, сохраняя логи организованными по дням.
• Ротация файлов: если oldLog.txt превышает 5 МБ, он сохраняет последние 1000 строк и архивирует старое содержимое в новый файл (например, oldLog_ГГГГММДД_ЧЧММСС.txt).
• Доступ к старому логу: нажмите NVDA+Ctrl+L, чтобы открыть oldLog.txt в вашем текстовом редакторе по умолчанию для просмотра.

Обработка сбоя и перезапуска NVDA

Когда NVDA аварийно завершает работу и перезапускается:

• Лог предыдущего сеанса (nvda-old.log) автоматически добавляется в oldLog.txt с помеченным временем заголовком во время инициализации плагина.
• Плагин определяет, меньше ли текущий nvda.log, чем ожидалось (что указывает на сбой), и сбрасывает указатель файла, чтобы обеспечить точное инкрементальное резервное копирование из нового файла лога.
• Непрерывное резервное копирование возобновляется, сохраняя все данные лога без потерь.

Это гарантирует надёжное сохранение логов даже после неожиданных сбоев и обеспечивает лёгкий доступ к ним для отладки или анализа.

Поддержка языков

Это дополнение разработано для бесперебойной работы с NVDA на любом языке.

Вместо проверки заголовка окна (который зависит от языка интерфейса) оно определяет окно просмотрщика логов NVDA по его дескриптору (handle).

Это обеспечивает полную совместимость со всеми языками, которые поддерживает NVDA.