sahlkit

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

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

التثبيت | Install

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

pip install sahlkit

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

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

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

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

cd sahlkit
pip install .

الاستخدام | Usage

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

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

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

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

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

الترخيص

MIT

Built with BrainDaemon