kurdish-sorani-tools 0.1.1

ئامرازەکانی کوردی سۆرانی - Kurdish Sorani language utilities for Python

Kurdish Sorani Tools - Python

ئامرازەکانی کوردی سۆرانی بۆ پایتۆن

A comprehensive Python package providing utilities for the Kurdish Sorani (سۆرانی) language, including number conversion, text processing, date formatting, and more.

Installation

pip install kurdish-sorani-tools

Features

• Number to Words — Convert numbers to Kurdish words
• Words to Number — Convert Kurdish words back to numbers
• Digit Conversion — Convert between English and Kurdish digits (٠١٢٣٤٥٦٧٨٩)
• Comma Formatting — Add/remove thousand separators
• Kurdish Detection — Check if text is Kurdish
• URL Fix — Fix spaces in URLs
• Ordinal Suffix — Add/remove ordinal suffixes (یەکەم، دووەم...)
• Date/Time — Format dates in Kurdish
• Keyboard Converter — Convert English keyboard layout to Kurdish
• Text Normalizer — Normalize Arabic characters to Kurdish
• Currency Formatter — Format amounts with Kurdish currency names
• Text Direction — Detect RTL/LTR direction
• Pluralization — Kurdish plural forms (ەکان، ان)
• String Utilities — Word count, slug, truncate, reverse
• Relative Time — "٥ خولەک لەمەوپێش"
• Phone Number — Format/validate Iraqi phone numbers
• Number Range — Convert ranges to Kurdish words
• Sentence Utils — Split/count sentences
• Number Validator — Validate Kurdish/English numbers
• Form Validators — Email, phone, required field validators
• Greeting — Time-based Kurdish greetings
• Calendar — Hijri and Kurdish (Rojhalati) calendar conversion
• Color Names — Color names in Kurdish

Quick Start

from kurdish_sorani_tools import *

# Number to words
print(number_to_words(125))  # سەد و بیست و پێنج

# Digit conversion
print(convert_en_to_ku("123"))  # ١٢٣
print(convert_ku_to_en("١٢٣"))  # 123

# Comma formatting
print(add_commas(1500000))  # 1,500,000

# Kurdish detection
print(is_kurdish("سڵاو"))  # True

# Date formatting
from datetime import datetime
print(kurdish_date_format(datetime.now()))  # ٠١ حوزەیران ٢٠٢٦

# Relative time
print(kurdish_relative_time(datetime(2026, 6, 1, 10, 0)))  # ٥ خولەک لەمەوپێش

# Phone formatting
print(format_phone("07501234567"))  # 0750 123 4567

# Greeting
print(kurdish_greeting())  # بەیانی باش / ڕۆژ باش / ...

# Pluralization
print(plural_definite("کتێب"))  # کتێبەکان

License

MIT License - Dana Sherzad