TextReadabilityScorer

Анализатор читаемости текста на основе лингвистических метрик.

Программа оценивает сложность восприятия текста с помощью популярных метрик читаемости:

• Индекс Флеша (Flesch Reading Ease) - оценивает легкость чтения от 0 до 100
• Индекс Флеша-Кинкейда (Flesch-Kincaid Grade Level) - определяет уровень образования для понимания текста
• Индекс Ганнинга (Gunning Fog Index) - показывает годы формального образования для комфортного чтения

Функциональность

• Анализ читаемости - расчет трех основных индексов читаемости
• Итоговая оценка - комплексная оценка текста по шкале от 10 (легко) до 90 (очень сложно)
• Рекомендации - конкретные советы по улучшению читаемости текста

Структура проекта

• scorer
  • analyzer.py - основной класс для анализа текста
  • document_reader.py - загружает и хранит текст для анализа, загруженный из .txt файла
  • metrics.py - рассчитывает все нужные метрики
  • report.py - генерирует отчет о работе
  • simplifier.py - генерирует советы по улучшению текста
• tests

Установка

Склонируйте репозиторий:

git clone https://github.com/ermakelena/TextReadabilityScorer cd text_scorer

Установите зависимости через Poetry:

poetry install

Создайте пакет

poetry build

Установите пакет

poetry install

Запустите программу

poetry run python TextReadabilityScorer/src/scorer/main.py