Metadata-Version: 2.4
Name: kurdish-sorani-tools
Version: 0.1.1
Summary: ئامرازەکانی کوردی سۆرانی - Kurdish Sorani language utilities for Python
Author: Dana Sherzad
License: MIT
Project-URL: Homepage, https://github.com/dana-1sherzad/kurdish_sorani_tools_python
Project-URL: Repository, https://github.com/dana-1sherzad/kurdish_sorani_tools_python
Project-URL: Issues, https://github.com/dana-1sherzad/kurdish_sorani_tools_python/issues
Keywords: kurdish,sorani,ckb,nlp,text-processing,kurdistan,iraq
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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

```bash
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

```python
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
