Metadata-Version: 2.4
Name: saad-tools
Version: 0.1.0
Summary: Colorful, dependency-free terminal tools powered by the SAAD palette
Author: SAAD
License: MIT
Project-URL: Homepage, https://example.com/saad-tools
Keywords: saad,colors,terminal,ansi,pydroid,termux
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# SAAD Tools

مكتبة Python خفيفة وجميلة لألوان الطرفية وأدواتها. لوحة الألوان الأساسية مشتقة حتميًا من اسم **SAAD**، وتحتوي على ألوان كثيرة، تدرجات، ثيمات، بانرات، صناديق، جداول، رسائل ملوّنة، وأشرطة تقدم.

لا تعتمد المكتبة على أي حزمة خارجية، ولذلك تناسب Python على Linux وWindows وmacOS وTermux وPydroid 3.

## التثبيت

من PyPI بعد نشر الحزمة:

```bash
pip install saad-tools
```

ومن مجلد المشروع مباشرة:

```bash
pip install .
```

في Termux أو Pydroid 3 يمكن استخدام:

```bash
python -m pip install saad-tools
```

## استخدام سريع

```python
from saad import PALETTE, banner, gradient, paint, success, table

print(banner("SAAD", "Colorful tools for everyone"))
print(gradient("S A A D", "SAAD_S", "SAAD_D"))
print(paint("اسم المكتبة: SAAD", PALETTE["SAAD_A"], bold=True))
print(success("تم التشغيل بنجاح"))
print(table([["SAAD_S", PALETTE["SAAD_S"].hex], ["SAAD_D", PALETTE["SAAD_D"].hex]], ["الاسم", "HEX"]))
```

لعرض التجربة الجاهزة:

```bash
python -m saad
```

وبعد التثبيت:

```bash
saad-demo
```

## الألوان والثيمات

```python
from saad import PALETTE, THEMES, Color, gradient_colors, palette_from_name, rainbow

print(PALETTE["SAAD_S"].hex)
print(THEMES["NEON"])
custom = palette_from_name("SAAD", 100)
colors = gradient_colors("#0F172A", "#06B6D4", 20)
rainbow_colors = rainbow(24)

custom_color = Color(30, 41, 59, "my-color")
print(custom_color.lighten(0.25).hex)
print(custom_color.darken(0.15).hex)
print(custom_color.blend("#06B6D4", 0.5).hex)
```

## ميزات التوافق

تعمل المكتبة في وضع صامت عند ضبط `NO_COLOR=1` أو `SAAD_NO_COLOR=1`، ويمكن فرض الألوان عبر `FORCE_COLOR=1` أو `SAAD_FORCE_COLOR=1`. لا تستخدم المكتبة `rich` أو `colorama` أو أي اعتماد خارجي.

## الترخيص

MIT.
