cadar 0.1.10

Canonicalization and Darija Representation - Bidirectional transliteration for Darija

CaDaR: Moroccan Darija Transliteration

High-performance bidirectional transliteration for Darija (Moroccan Arabic)

CaDaR provides seamless conversion between Arabic script and Latin script for Moroccan Darija, with intelligent vowel handling and Darija-aware linguistic processing.

Features

• 🔄 Bidirectional: Arabic ↔ Latin transliteration
• 🎯 Smart Vowels: Distinguishes long (aa, ee, ii) vs short (a, e, i) vowels
• 🇲🇦 Darija Mode: Readable informal writing style
• 🚀 Fast: Rust core with Python bindings
• ✨ Standardization: Normalize mixed-script text

Installation

pip install cadar

Quick Start

import cadar

# Latin to Arabic
cadar.bizi2ara("salam 3likom")
# Output: "سلام عليكم"

# Arabic to Latin
cadar.ara2bizi("كيفاش داير؟")
# Output: "kifash dayer?"

# Smart vowel handling (v0.1.9+)
cadar.bizi2ara("imken")   # → "يمكن" (short 'e' skipped)
cadar.bizi2ara("salaam")  # → "سالام" (long 'aa' preserved)
cadar.bizi2ara("daba")    # → "دابا" (short 'a' written in Darija mode)

API

Simple Functions

cadar.bizi2ara(text, darija="Ma")   # Latin → Arabic
cadar.ara2bizi(text, darija="Ma")   # Arabic → Latin
cadar.ara2ara(text, darija="Ma")    # Standardize Arabic
cadar.bizi2bizi(text, darija="Ma")  # Standardize Latin

CaDaR Class

processor = cadar.CaDaR(darija="Ma")
processor.bizi2ara("salam")  # Reusable processor
processor.ara2bizi("سلام")

Smart Vowel Handling (v0.1.9+)

CaDaR intelligently handles vowels for natural Darija writing:

Long vowels (aa, ee, ii, oo, uu) → Single Arabic letter:

• "salaam" → "سالام" (long aa)
• "kaatb" → "كاتب" (long aa in middle)

Short vowels - Context-aware:

• "imken" → "يمكن" (middle 'e' skipped)
• "salam" → "سالام" (middle 'a' written - Darija mode)
• "daba" → "دابا" (middle 'a' written)

Bidirectional preservation:

• "سلام" → "slam" → "سلام" ✓ Perfect round-trip

Use Cases

• Chat Apps: Support users in both scripts
• Search: Match queries regardless of script
• NLP: Normalize Darija text for ML
• Data Processing: Standardize mixed-script datasets

Documentation

• Full Docs: https://oit-technologies.github.io/CaDaR/
• GitHub: https://github.com/Oit-Technologies/CaDaR
• Issues: GitHub Issues

License

MIT License - See LICENSE

---

Made with ❤️ for the Darija community