NVDASpeedTest (Тест скорости интернета)

NVDA SpeedTest — это дополнение с открытым исходным кодом для NVDA, позволяющее проводить тесты скорости интернета (загрузка, выгрузка и пинг) в полностью доступном формате, с озвучиванием результатов и встроенной историей.

Возможности

• Тест скорости (загрузка, выгрузка и пинг) с автоматическим озвучиванием результатов.
• История тестов, включая дату и сводку.
• Полные детали: сервер, джиттер, потери пакетов и IP-адреса.
• Кнопка для отмены выполняемого теста.
• Настраиваемая горячая клавиша (по умолчанию: NVDA+Shift+L).
• Копирование результатов в буфер обмена с помощью Ctrl+C (на выбранном элементе) или кнопки Копировать после выбора элемента в списке.
• Поддержка нескольких языков.

Как использовать

1. Установите NVDA SpeedTest через меню дополнений NVDA.
2. Откройте дополнение, используя горячую клавишу по умолчанию (NVDA+Shift+L) или через меню NVDA: Сервис → Тест скорости интернета.
3. В главном окне нажмите Начать тест, чтобы запустить тест скорости.
4. Используйте кнопку Отмена, чтобы при необходимости остановить тест.
5. Перемещайтесь по истории с помощью клавиш со стрелками; просматривайте детали, удаляйте отдельные тесты или очищайте всю историю.

6. Чтобы скопировать результат теста в буфер обмена:

   • Выберите нужный элемент в списке и нажмите Ctrl+C,
   • или используйте кнопку Копировать после выбора элемента в списке.
7. Чтобы изменить горячую клавишу, перейдите в Настройки → Жесты ввода и найдите «NVDA SpeedTest».

История изменений

1.1 (последняя версия)

• Исправление: Пустой список истории теперь сообщается как “Тесты не найдены” вместо “Неизвестный список”.
• Новое: Добавлена возможность копировать результаты теста в буфер обмена с помощью Ctrl+C или кнопки Копировать после выбора элемента в списке.

1.0

• Первый выпуск.

Перевод и участие в разработке

NVDA SpeedTest полностью готов для перевода и открыт для участия. Вот как можно помочь:

Перевод

• Файлы перевода (.po) хранятся в папке addon/locale/.

• Чтобы добавить новый язык:

  1. Создайте файл .po из шаблона .pot.
  2. Переведите сообщения и сохраните, используя структуру NVDA: xx/LC_MESSAGES/nvda.po (где xx — код языка).
  3. Скомпилируйте в nvda.mo и отправьте pull request или откройте issue.

Разработка и настройка окружения

Для работы с NVDA SpeedTest всегда собирайте дополнение с помощью SCons, чтобы гарантировать корректное и автоматическое создание переводов, манифестов и всех ресурсов.

Требования к окружению

• Python 3.10+ (та же или совместимая версия с вашей установкой NVDA)
• SCons (pip install scons)
• Markdown (pip install markdown)
  (требуется для генерации HTML-документов из Markdown)
• Инструменты gettext (для компиляции .po в .mo, например, msgfmt)

Сборка дополнения

1. Клонируйте репозиторий:

   ```bash
   git clone https://github.com/leoguimaoficial/NVDA-SpeedTest.git
   cd NVDA-SpeedTest

2. 
   Установите зависимости:

pip install scons markdown

3. 
   Соберите дополнение (файл .nvda-addon):
   • Если SCons установлен глобально:

SCons

• Если SCons не добавлен в PATH, используйте:

python -m SCons

Это автоматически создаст:
* Переведенные файлы манифеста (addon/locale/xx/manifest.ini)
* Скомпилированные файлы переводов (nvda.mo)
* HTML-документацию из Markdown
* Пакет .nvda-addon для установки
4.
(Опционально) Скомпилируйте переводы вручную:

msgfmt addon/locale/xx/LC_MESSAGES/nvda.po -o addon/locale/xx/LC_MESSAGES/nvda.mo

(Замените xx на код вашего языка, например, pt_BR, es и т. д.

Рекомендации

• Всегда используйте SCons для сборки и упаковки дополнения.
  Никогда не копируйте файлы вручную - процесс сборки автоматизирует создание переводов и манифестов, предотвращая несоответствия версий или языков.
• Тестируйте изменения в NVDA, используя сгенерированный пакет .nvda-addon.
• При переводе или работе с документацией всегда следуйте структуре папок, используемой дополнениями NVDA.

Участие в разработке

• Всегда сохраняйте название дополнения как NVDA SpeedTest (не переводите и не изменяйте его).
• Открывайте pull request’ы для новых функций, исправлений ошибок или обновлений переводов.
• Обсуждайте значительные изменения в issues перед отправкой больших PR.

Часто задаваемые вопросы

• Что означает пинг?
  Это время отклика между вашим компьютером и сервером.

• Могу ли я выбрать сервер?
  Сейчас сервер выбирается автоматически. В будущих версиях появится возможность ручного выбора.

• Где найти историю тестов?
  История отображается в окне NVDA SpeedTest сразу после результатов.

• Как изменить горячую клавишу?
  Перейдите в Настройки  Жесты ввода и найдите “NVDA SpeedTest”.

• Как я могу помочь с кодом, переводами или идеями?
  Создайте issue, форкните репозиторий, отправьте pull request или присоединяйтесь к обсуждениям!