mawo-grammar 0.1.0

Russian grammar checker with 500+ rules for professional NLP quality

mawo-grammar

Russian grammar checker with 500+ rules for professional NLP quality.

Features

• Case Agreement - Validates adjective-noun, numeral-noun gender/case/number agreement
• Verb Aspect - Context-aware perfective/imperfective aspect checking
• Particle Usage - Validates particles (же, ли, бы, etc.)
• Preposition + Case - Checks correct case after prepositions (в/на + Acc/Loc)
• Register Consistency - Detects mixing formal (вы) and informal (ты)

Installation

pip install mawo-grammar

Quick Start

from mawo_grammar import RussianGrammarChecker

checker = RussianGrammarChecker()

# Check text
text = "красивая дом"
errors = checker.check(text)

for error in errors:
    print(f"{error.description} at {error.location}")
    print(f"Suggestion: {error.suggestion}")

Advanced Usage

Rule-based checking

# Specific rules
errors = checker.check(text, rules=[
    'case_agreement',      # Adjective-noun agreement
    'aspect_usage',        # Verb aspect validation
    'particle_usage',      # Particle correctness
    'register',           # ты/вы consistency
])

# With morphology context
from mawo_pymorphy3 import create_analyzer

morph = create_analyzer()
errors = checker.check_with_morphology(text, morph)

Custom rules

from mawo_grammar import Rule, GrammarError

@checker.add_rule(category='style', severity='minor')
def no_bureaucratese(text: str) -> list[GrammarError]:
    """Detect канцелярит."""
    errors = []
    if 'в связи с вышеизложенным' in text:
        errors.append(GrammarError(
            type='bureaucratese',
            location=(0, len(text)),
            description='Avoid bureaucratic language',
            suggestion='Use simpler wording'
        ))
    return errors

Error objects

for error in errors:
    print(error.type)           # 'case_agreement'
    print(error.location)       # (0, 14)
    print(error.severity)       # 'major'
    print(error.description)    # 'Adjective-noun gender mismatch'
    print(error.suggestion)     # 'красивый дом'
    print(error.rule_id)        # 'ADJ_NOUN_GENDER_AGREEMENT'
    print(error.confidence)     # 0.98
    print(error.morphology)     # Morphological context

Rule Categories

Case Agreement (50+ rules)

• Adjective-noun agreement (gender, case, number)
• Numeral-noun agreement
• Pronoun-noun agreement
• Demonstrative-noun agreement

Verb Aspect (30+ rules)

• Perfective for completed actions
• Imperfective for ongoing/repeated actions
• Context-aware suggestions

Particles (20+ rules)

• же, ли, бы, то, ка, таки
• Position and usage validation

Prepositions (40+ rules)

• в + Accusative (motion) / Prepositional (location)
• на + Accusative (motion) / Prepositional (location)
• с + Genitive / Instrumental
• по + Dative / Prepositional

Register (10+ rules)

• ты/вы consistency
• Formal vs informal mixing

Performance

• Precision: 95%+ (rule-based)
• Recall: 90%+ (500+ rules)
• Latency: <100ms per text
• No LLM required: Fast, deterministic, offline

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Code quality
black .
ruff check .
mypy mawo_grammar

License

MIT License - see LICENSE for details.

Credits

Based on:

• Розенталь "Справочник по русскому языку"
• OpenCorpora grammar annotations
• LanguageTool Russian rules (adapted)

Part of the MAWO ecosystem:

• mawo-pymorphy3 - Morphological analysis
• mawo-razdel - Tokenization
• mawo-slovnet - NER and syntax
• mawo-core - Unified API