Простая и легковесная библиотека-обёртка для API Яндекс.Спеллера. Предоставляет синхронный и асинхронный клиенты, строгую типизацию через Pydantic, и удобные функции-помощники для быстрой проверки текста.

• ✅ Проверка одного текста или списка текстов (метод checkTexts)
• ⚡ Синхронный и асинхронный режимы (на базе httpx)
• 🎛️ Поддержка всех опций Яндекс.Спеллера (игнорирование URL, цифр, повторов и т.д.)
• 🧠 Автоматическое управление HTTP-сессиями — создаются и закрываются при каждом вызове, не требуется использовать контекстный менеджер
• 📦 Типизированные модели ответов на основе Pydantic v2
• 🚨 Понятные исключения для ошибок API и сетевых проблем
• 🪶 Минимум зависимостей: только httpx и pydantic

pip install pyspeller

или с помощью uv:

uv add pyspeller

Для работы требуется Python 3.9 или новее.

from pyspeller import check_text

result = check_text("Превед, медвед!")
if result.errors:
    print(result.errors[0].suggestions)  # ['Привет']

import asyncio
from pyspeller import async_check_text

async def main():
    res = await async_check_text("синхрафазатрон")
    print(res.errors[0].suggestions)  # ['синхрофазотрон']

asyncio.run(main())

from pyspeller import check_texts

results = check_texts(["очепятка", "дубне"])
for text_result in results.results:
    for error in text_result.errors:
        print(f"Слово '{error.word}' → {error.suggestions}")

Все опции Яндекс.Спеллера доступны через перечисление SpellerOptions. Их можно комбинировать с помощью побитового ИЛИ (|).

from pyspeller import check_text, SpellerOptions

result = check_text(
    "мой сайт http://example.com и номер R2D2",
    options=SpellerOptions.IGNORE_URLS | SpellerOptions.IGNORE_DIGITS
)

# Или импортировать опции напрямую

from pyspeller import check_text, IGNORE_URLS, IGNORE_DIGITS

result = check_text(
    "мой сайт http://example.com и номер R2D2",
    options=IGNORE_URLS | IGNORE_DIGITS
)

При необходимости можно передать произвольное целое число.

Синхронный клиент.

Методы:

• check_text(text: str) -> CheckTextResponse
• check_texts(texts: List[str]) -> CheckTextsResponse

Асинхронный клиент. Методы аналогичны синхронному, но возвращают корутины.

# Синхронные
check_text(text, lang="ru,en", options=0, format="plain") -> CheckTextResponse
check_texts(texts, ...) -> CheckTextsResponse

# Асинхронные
async_check_text(text, ...) -> CheckTextResponse
async_check_texts(texts, ...) -> CheckTextsResponse

Все функции автоматически создают и закрывают сессию, поэтому их можно вызывать без дополнительного управления.

• errors: List[SpellResult]

• results: List[CheckTextResponse]

Все исключения наследуются от SpellerError.

• SpellerAPIError(status_code: int, message: str) – ошибка API (HTTP 4xx/5xx).
• SpellerNetworkError(original_exception: Exception) – сетевая ошибка (таймаут, DNS и т.п.).

git clone https://github.com/austnv/pyspeller.git
cd pyspeller
uv sync --group dev
uv run pytest tests/ -v

Проект распространяется под лицензией MIT. Подробнее см. в файле LICENSE.

Сделано с ❤️ для проверки орфографии через Яндекс.Спеллер.