SAAD Tools

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

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

التثبيت

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

pip install saad-tools

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

pip install .

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

python -m pip install saad-tools

استخدام سريع

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"]))

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

python -m saad

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

saad-demo

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

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.