swarmauri_tool_dalechallreadability 0.9.3.dev3

Swarmauri Community Dale-Chall Readability Tool

---

Swarmauri Tool Dale-Chall Readability

Tool wrapper around textstat to compute the Dale–Chall readability score for a block of text via the Swarmauri tool interface.

Features

• Accepts an input_text parameter and returns {"dale_chall_score": <float>}.
• Uses textstat.dale_chall_readability_score under the hood.
• Input validation ensures the required parameter is present before calculation.

Prerequisites

• Python 3.10 or newer.
• textstat and pyphen dictionaries (installed automatically). Some textstat metrics may download additional word lists on first use.

Installation

# pip
pip install swarmauri_tool_dalechallreadability

# poetry
poetry add swarmauri_tool_dalechallreadability

# uv (pyproject-based projects)
uv add swarmauri_tool_dalechallreadability

Quickstart

from swarmauri_tool_dalechallreadability import DaleChallReadabilityTool

text = "This is a simple sentence for testing purposes."
tool = DaleChallReadabilityTool()
result = tool({"input_text": text})
print(result)

Usage in Tool Chains

from swarmauri_tool_dalechallreadability import DaleChallReadabilityTool

def grade_paragraph(paragraph: str) -> float:
    tool = DaleChallReadabilityTool()
    score = tool({"input_text": paragraph})["dale_chall_score"]
    return score

Tips

• Dale–Chall scores roughly map to U.S. grade levels; lower scores indicate easier reading.
• Pre-clean text (remove markup, normalize whitespace) for consistent scoring.
• Combine with Swarmauri measurements or parsers to evaluate readability across multiple documents.

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.