Readability Scorer

from data_sources.modules.readability_scorer import score_readability

result = score_readability(article_content)

print(f"Overall Score: {result['overall_score']:.1f}/100")
print(f"Grade: {result['grade']}")
print(f"Reading Level: Grade {result['reading_level']}")
print(f"Flesch Score: {result['readability_metrics']['flesch_reading_ease']}")

from data_sources.modules.readability_scorer import ReadabilityScorer

scorer = ReadabilityScorer()
result = scorer.analyze(article_content)

scorer = ReadabilityScorer()

# Default targets:
# - Reading level: 8th-10th grade
# - Flesch ease: 60-70 (fairly easy)
# - Max sentence length: 20 words
# - Paragraph sentences: 2-4 sentences

flesch = result['readability_metrics']['flesch_reading_ease']

if flesch >= 70:
    print("Easy to read (7th grade)")
elif flesch >= 60:
    print("Fairly easy (8th-9th grade)")
elif flesch >= 50:
    print("Fairly difficult (10th-12th grade)")
else:
    print("Difficult (college level)")

grade_level = result['reading_level']

print(f"Reading Level: Grade {grade_level}")
print(f"Target: 8-10 (high school)")
print(f"Status: {result['status']['grade_level_status']}")

Reading Level: Grade 8.5
Target: 8-10 (high school)
Status: optimal

structure = result['structure_analysis']

print(f"Average sentence length: {structure['avg_sentence_length']} words")
print(f"Shortest: {structure['shortest_sentence']} words")
print(f"Longest: {structure['longest_sentence']} words")
print(f"Long sentences (>25 words): {structure['long_sentences']}")
print(f"Very long sentences (>35 words): {structure['very_long_sentences']}")

structure = result['structure_analysis']

print(f"Total paragraphs: {structure['total_paragraphs']}")
print(f"Avg sentences per paragraph: {structure['avg_sentences_per_paragraph']}")

complexity = result['complexity_analysis']

print(f"Passive voice: {complexity['passive_sentence_ratio']}%")
print(f"Complex words: {complexity['complex_word_ratio']}%")
print(f"Transition words: {complexity['transition_words_per_100']} per 100 words")

passive_ratio = result['complexity_analysis']['passive_sentence_ratio']

if passive_ratio > 30:
    print("⚠️ Too much passive voice")
elif passive_ratio > 20:
    print("ℹ️ Passive voice slightly high")
else:
    print("✅ Good use of active voice")

complex_ratio = result['complexity_analysis']['complex_word_ratio']

if complex_ratio > 15:
    print("High percentage of complex words")
else:
    print("Appropriate vocabulary complexity")

transitions = result['complexity_analysis']['transition_words_per_100']

if transitions < 0.5:
    print("Add more transition words (however, therefore, additionally)")
else:
    print("Good use of transitions")

print("Recommendations:")
for rec in result['recommendations']:
    print(f"  {rec}")

Recommendations:
  ⚠️ Reading level is too high (Grade 12.5). Target is 8-10. Simplify sentences and use more common words.
  ⚠️ Average sentence length is too long (28.3 words). Target is under 20 words. Break up long sentences.
  ⚠️ 8 sentences are very long (35+ words). These should be split into multiple sentences.
  ⚠️ Paragraphs are too long (avg 5.2 sentences). Keep paragraphs to 4 sentences or less.
  ⚠️ Too much passive voice (32% of sentences). Convert to active voice where possible (target: under 20%).
  ℹ️ Few transition words detected. Add words like 'however', 'therefore', 'additionally' to improve flow.

status = result['status']

print(f"Grade Level: {status['grade_level_status']}")
print(f"Reading Ease: {status['ease_status']}")
print(f"Sentence Length: {status['sentence_length_status']}")
print(f"Overall: {status['overall_assessment']}")

{
    'grade_level_status': 'optimal',
    'ease_status': 'good',
    'sentence_length_status': 'good',
    'overall_assessment': 'excellent'
}

from data_sources.modules.readability_scorer import score_readability

article = """
# How to Start a Podcast

Starting a podcast is easier than you might think. This guide will walk you through everything you need to know.

## Choose Your Topic

The first step is choosing what you want to talk about. Pick something you're passionate about and that your audience will find valuable. This ensures you'll have plenty to say and stay motivated over time.

## Get Your Equipment

You don't need expensive equipment to start. A decent USB microphone, headphones, and free recording software like Audacity are enough for beginners. As you grow, you can upgrade your gear.

## Record Your First Episode

Don't worry about being perfect. Just hit record and start talking. Your first episode won't be your best, but it's an important step in your podcasting journey. Edit out major mistakes, but don't obsess over every detail.
"""

result = score_readability(article)

print("=== Readability Analysis ===")
print(f"\nOverall Score: {result['overall_score']:.1f}/100")
print(f"Grade: {result['grade']}")
print(f"Reading Level: Grade {result['reading_level']}")

print(f"\nKey Metrics:")
metrics = result['readability_metrics']
print(f"  Flesch Reading Ease: {metrics['flesch_reading_ease']}")
print(f"  Flesch-Kincaid Grade: {metrics['flesch_kincaid_grade']}")
print(f"  Gunning Fog: {metrics['gunning_fog']}")

print(f"\nStructure:")
struct = result['structure_analysis']
print(f"  Total Words: {struct['total_words']}")
print(f"  Total Sentences: {struct['total_sentences']}")
print(f"  Avg Sentence Length: {struct['avg_sentence_length']} words")
print(f"  Avg Sentences/Paragraph: {struct['avg_sentences_per_paragraph']}")
print(f"  Long Sentences (>25): {struct['long_sentences']}")

print(f"\nComplexity:")
comp = result['complexity_analysis']
print(f"  Passive Voice: {comp['passive_sentence_ratio']}%")
print(f"  Complex Words: {comp['complex_word_ratio']}%")
print(f"  Transition Words: {comp['transition_words_per_100']} per 100 words")

print(f"\nStatus: {result['status']['overall_assessment'].upper()}")

if result['recommendations']:
    print(f"\nRecommendations:")
    for rec in result['recommendations']:
        print(f"  {rec}")

from data_sources.modules.readability_scorer import score_readability
from data_sources.modules.seo_quality_rater import rate_seo_quality

# Step 1: Check readability
readability = score_readability(article)

# Step 2: Get SEO quality score
quality = rate_seo_quality(
    content=article,
    primary_keyword="start a podcast",
    meta_title="How to Start a Podcast",
    meta_description="Complete guide to starting a podcast"
)

print(f"Readability Score: {readability['overall_score']:.1f}/100")
print(f"Reading Level: Grade {readability['reading_level']}")
print(f"SEO Score: {quality['overall_score']:.1f}/100")

# Check if both scores are good
if readability['overall_score'] >= 80 and quality['overall_score'] >= 80:
    print("✅ Content is optimized for both readability and SEO!")