Metadata-Version: 2.5
Name: sahlkit
Version: 1.0.1
Summary: مكتبة أدوات Python بسيطة: نصوص، أرقام، وتحقق من البيانات
Project-URL: Homepage, https://braindaemon.com
Project-URL: Documentation, https://braindaemon.com
Author-email: BrainDaemon <built-with@braindaemon.com>
License-Expression: MIT
License-File: LICENSE
Keywords: arabic,text,utilities,validation
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.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: twine>=4.0; extra == 'dev'
Description-Content-Type: text/markdown

# sahlkit

مكتبة Python خفيفة لأدوات يومية: نصوص، أرقام، وتحقق بسيط من البيانات (بما فيها أرقام الجوال السعودية).

**Sahlkit** is a small, dependency-free utility library for text, numbers, and light validation.

## التثبيت | Install

### من PyPI (بعد النشر)

```bash
pip install sahlkit
```

### من ملف الحزمة في Workspace (جاهز الآن)

بعد تنزيل المشروع عبر **Download workspace**:

```bash
pip install /path/to/sahlkit/dist/sahlkit-1.0.0-py3-none-any.whl
```

أو من مجلد المشروع:

```bash
cd sahlkit
pip install .
```

## الاستخدام | Usage

```python
from sahlkit import (
    contains_arabic,
    slugify,
    truncate_words,
    clamp,
    format_compact,
    percent_of,
    is_saudi_mobile,
    is_email_like,
)

print(contains_arabic("مرحبا"))       # True
print(slugify("My Product 2026"))     # my-product-2026
print(format_compact(1_500_000))      # 1.5M
print(is_saudi_mobile("0512345678"))  # True
```

## التطوير | Development

```bash
cd sahlkit
pip install -e ".[dev]"
pytest
python -m build
```

## النشر على PyPI | Publish to PyPI

1. أنشئ حسابًا على [pypi.org](https://pypi.org) وانسخ API token.
2. نفّذ:

```bash
export TWINE_USERNAME=__token__
export TWINE_PASSWORD=pypi-xxxxxxxx
twine upload dist/*
```

## الترخيص

MIT

---

Built with [BrainDaemon](https://braindaemon.com)
