إذا كنت تبحث عن طريقة خفيفة وسريعة لتسجيل الأخطاء والمعلومات في تطبيقاتك بلون وتنسيق مخصص، فقد صادفت مشروع Light-Weight Logger على Hacker News. هذه المكتبة مفتوحة المصدر تدعم C++ وJava وC#، وتتيح لك تعريف تنسيق رئيسي (master format) ثم إضافة تنسيقات مسماة بألوان مختلفة. في هذا الدليل العملي، سنشرح لك كيفية تثبيتها واستخدامها، مع أمثلة تطبيقية تناسب المطور العربي في السعودية والخليج. ملاحظة: README الخاص بالمشروع غير واضح، لذا سنعتمد على بنية الكود لتقديم خطوات تقريبية.

ما هو Light-Weight Logger؟

مكتبة تسجيل خفيفة الوزن (Light-Weight Logger) تتيح للمطورين تعريف تنسيق رئيسي للسجلات (master style) ثم إنشاء تنسيقات مسماة (مثل ERROR, INFO, WARN) بألوان مختلفة. تدعم المكتبة حاليًا ثلاث لغات: C++ وJava وC#. الفكرة الأساسية: بدلاً من استخدام printf أو cout مع تنسيق ثابت، يمكنك تخصيص كل جزء من السجل (الوقت، الملف، رقم السطر، الرسالة) بلون منفصل.

من يحتاج هذه المكتبة ومن لا؟

من يحتاجها: مطور يعمل على مشروع صغير أو متوسط بلغة C++ أو Java أو C#، ويريد تحسين قراءة السجلات دون تعقيد المكتبات الثقيلة. من لا يحتاجها: من يحتاج تسجيلاً في ملفات (حاليًا لا تدعمه)، أو من يعمل بلغات أخرى (Python, JavaScript)، أو من يريد مكتبة مستقرة للإنتاج (المشروع جديد ولم يختبر بشكل واسع).

المميزات الرئيسية

• خفيفة الوزن: لا تؤثر على أداء التطبيق.
• تخصيص كامل للتنسيق: وقت، تاريخ، منطقة زمنية، ملف، سطر، معرف الخيط.
• ألوان قابلة للتخصيص لكل جزء من السجل.
• تدعم C++ وJava وC#.
• مفتوحة المصدر على GitHub.

المتطلبات الأساسية

• مترجم C++ (مثل g++ أو Visual Studio) أو Java JDK أو .NET SDK.
• معرفة أساسية باللغة المستخدمة.
• لا توجد مكتبات خارجية إضافية.

التركيب خطوة بخطوة (تقريبي)

لأن README غير واضح، هذه الخطوات مبنية على هيكل المستودع:

1. استنساخ المستودع: git clone https://github.com/PenguineDavid/light-weight-logger.git
2. الدخول إلى المجلد: cd light-weight-logger
3. اختيار مجلد اللغة المناسبة (C++، Java، C#).
4. تجميع الكود: في C++ استخدم g++ -std=c++11 -o logger main.cpp (أو ملف الرأس المناسب). في Java: javac *.java. في C#: dotnet build أو csc *.cs.
5. تشغيل المثال: ./logger (أو java Main أو dotnet run).

شرح الإعدادات (لا يوجد .env)

المشروع لا يستخدم ملف .env. الإعدادات تتم عبر الكود مباشرة: تعريف master_style كنص، ثم إضافة تنسيقات باستخدام add_format.

التشغيل والتجربة الأولى

إليك مثال عملي بلغة C++:

#include "logger.h"
int main() {
    Logger logger;
    string master_style = "%C[%N]%c%S%G[%D %T %Z]%c %M %G(%F:%t:%L)";
    logger.add_format("ERROR", master_style, Colour::RED);
    logger.log("ERROR", "هذا سجل خطأ تجريبي");
    return 0;
}

في Java:

Logger logger = new Logger();
String masterStyle = "%C[%N]%c%S%G[%D %T %Z]%c %M %G(%F:%t:%L)";
logger.addFormat("ERROR", masterStyle, Colour.RED);
logger.log("ERROR", "هذا سجل خطأ تجريبي");

في C#:

Logger logger = new Logger();
string masterStyle = "%C[%N]%c%S%G[%D %T %Z]%c %M %G(%F:%t:%L)";
logger.AddFormat("ERROR", masterStyle, Colour.RED);
logger.Log("ERROR", "هذا سجل خطأ تجريبي");

أخطاء شائعة وحلولها

استخدامات عملية في السوق السعودي/الخليجي

• تطبيق محلي لإدارة المخزون: تسجيل الأخطاء باللون الأحمر مع الوقت والملف.
• تطبيق توصيل طلبات: تسجيل معلومات التتبع باللون الأخضر.
• تطبيق مصرفي: تسجيل تحذيرات الأمان باللون الأصفر.

هل يستحق التجربة؟ تقييم موضوعي

المكتبة واعدة لمشاريع التطوير السريع والنماذج الأولية. لكنها ليست جاهزة للإنتاج بعد (قلة الاختبارات، عدم دعم التسجيل في ملف). جربها في مشروع جانبي أولاً.

بدائل مشابهة

• spdlog (C++): مكتبة قوية، لكنها أثقل.
• log4j (Java): معيارية لكن معقدة.
• NLog (C#): مرنة لكن تحتاج إعدادات.

أسئلة شائعة (FAQ)

هل Light-Weight Logger يدعم العربية في السجلات؟

نعم، يدعم Unicode، لذا يمكنك كتابة رسائل عربية.

ما الفرق بين هذه المكتبة و spdlog؟

Light-Weight Logger أخف وزناً وأبسط، لكن spdlog أكثر استقراراً وميزات (تسجيل في ملف، تناوب السجلات).

هل يمكن استخدامها في مشاريع الإنتاج؟

حالياً لا يُنصح بذلك لحداثتها وقلة اختباراتها.

كيف أضيف تنسيقاً جديداً؟

استخدم add_format مع اسم التنسيق وmaster_style واللون.

هل تدعم التسجيل في ملف بدلاً من الطرفية؟

لا، حالياً تدعم الطرفية فقط.

ما هي اللغات المدعومة بالضبط؟

C++ وJava وC#.

هل المكتبة مستقرة؟

لا، هي في مرحلة مبكرة (0 نجوم على GitHub وقت كتابة المقال).

كيف أساهم في المشروع؟

يمكنك فتح Issue أو Pull Request على GitHub.

خاتمة

Light-Weight Logger خيار جيد إذا كنت تبحث عن مكتبة تسجيل خفيفة وسهلة التخصيص لمشروعك الصغير. جربها في بيئة تطويرية، وساهم في تحسينها إذا أعجبتك. تذكر أن تشارك تجربتك مع المجتمع العربي.