عن المشروع

تُعد Rich مكتبة بايثون للنصوص الغنية والتنسيق الجميل في الطرفية. وهي توفر واجهة برمجية تسهّل إضافة الألوان والأنماط إلى مخرجات الطرفية، كما يمكنها عرض جداول جميلة، وأشرطة تقدم، وMarkdown، وشيفرة مصدرية مميزة الصياغة، ورسومات تتبع الأخطاء، وغير ذلك مباشرة دون إعدادات إضافية. التوافق: تعمل Rich على أنظمة Linux وmacOS وWindows. يعمل اللون الحقيقي والرموز التعبيرية مع Windows Terminal الجديد؛ أما الطرفية الكلاسيكية فتقتصر على 16 لونًا. تتطلب بايثون 3.8 أو أحدث، وتعمل أيضًا مع دفاتر Jupyter دون أي إعداد إضافي. التثبيت: تُثبَّت باستخدام الأمر (`python -m pip install rich`) ويمكن اختبار المخرجات بالأمر `python -m rich`. طباعة Rich: استيراد `rich.print` يوفر نسخة بنفس توقيع دالة `print` المدمجة، مع دعم الترميز مثل `[bold magenta]World[/bold magenta]` وأسماء الرموز التعبيرية. يمكن أيضًا تثبيت Rich داخل بيئة REPL الخاصة ببايثون عبر `pretty.install()` بحيث تُطبع هياكل البيانات بتنسيق جميل وتمييز صياغي. واجهة Console: يوفر كائن `Console` دالة `print` مشابهة للدالة المدمجة، مع التفاف الكلمات، ووسائط نمطية، وترميز وحدة تحكم يشبه BBCode. كما يحتوي على دالة `log` تضيف عمودين للوقت والموقع، ويمكنها طباعة المجموعات بتنسيق جميل، مع خيار `log_locals` لعرض المتغيرات المحلية. وهناك معالج تسجيل مدمج لوحدة التسجيل في بايثون. تشمل العناصر القابلة للعرض المدمجة ما يلي: - الرموز التعبيرية: إدراج رمز تعبيري بالاسم بين نقطتين، مثل `:smiley:`. - الجداول: جداول Unicode مرنة مع حدود وأنماط قابلة للتكوين، ومحاذاة خلايا، وأعمدة تُعاد تحجيمها لتناسب الطرفية. - أشرطة التقدم: أشرطة تقدم متعددة بدون وميض عبر `track` أو تكوينات أعمدة مخصصة للنسبة المئوية وحجم الملف والسرعة والوقت المتبقي. - الحالة: رسم متحرك لدوّار ورسالة عبر مدير السياق `status`؛ يمكن تصفح الدوّارات المتاحة بالأمر `python -m rich.spinner`. - الشجرة: عرض البيانات الهرمية مع خطوط إرشادية، مناسب لهياكل الملفات؛ ويعرض الأمر `python -m rich.tree` مثالًا على ذلك. - الأعمدة: أعمدة محتوى أنيقة بعرض متساوٍ أو أمثل، تشبه قوائم الأدلة. - Markdown: عرض تنسيق Markdown في الطرفية باستخدام صنف `Markdown`. - تمييز الصياغة: مدعوم بواسطة Pygments عبر كائن `Syntax`، مع سمات وأرقام أسطر. - تتبع الأخطاء: رسائل تتبع أخطاء جميلة وأسهل قراءة تعرض شيفرة أكثر من تتبع أخطاء بايثون القياسي، ويمكن تكوينها كمعالج افتراضي. تُبنى عناصر Rich القابلة للعرض على بروتوكول Console، مما يتيح للمستخدمين تنفيذ محتوى Rich خاص بهم. ومن المشاريع ذات الصلة المذكورة في ملف README: Rich CLI، وهو تطبيق سطر أوامر لتمييز الصياغة وعرض Markdown وعرض CSV في جداول، وTextual، وهو مشروع شقيق لبناء واجهات مستخدم طرفية متقدمة.