Light-Weight Logger هي مكتبة تسجيل (logging) خفيفة مفتوحة المصدر ظهرت مؤخراً على Hacker News، تدعم لغات C++ وJava وC#. تتيح لك تخصيص تنسيق السجلات بالكامل: الألوان، الطوابع الزمنية، أسماء المستويات، وغيرها. الفكرة الأساسية: بدلاً من استخدام مكتبات ثقيلة مثل Log4j أو NLog في مشروع صغير، يمكنك الاعتماد على هذه المكتبة لتقليل الاعتماديات وتحسين الأداء.

في هذا الدليل، سنشرح لك كيفية تركيب المكتبة (خطوات تقريبية لأن README غير واضح)، وكيفية تعريف التنسيق المخصص، مع أمثلة عملية تناسب المطور العربي في السعودية والخليج. سنذكر أيضاً الأخطاء الشائعة والبدائل المناسبة.

ما هو Light-Weight Logger؟

هي مكتبة تسجيل خفيفة تسمح لك بتحديد تنسيق السجلات بشكل كامل باستخدام سلسلة نصية واحدة (master_style). تدعم إضافة ألوان مختلفة لكل مستوى تسجيل (ERROR, WARNING, INFO, DEBUG) وتضمين الطابع الزمني واسم الملف ورقم السطر. الهدف: تقليل حجم المكتبة وزيادة المرونة مقارنة بالأدوات التقليدية.

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

تناسب: المطورين الذين يعملون على مشاريع صغيرة أو متوسطة بلغة C++ أو Java أو C#، ويريدون تحكم كامل في تنسيق السجلات دون تحميل المكتبات الثقيلة. أيضاً مناسبة للمشاريع التعليمية أو النماذج الأولية.

لا تناسب: المشاريع الإنتاجية الكبيرة التي تحتاج إلى ميزات متقدمة مثل التسجيل غير المتزامن، التصفية المعقدة، أو التكامل مع أنظمة المراقبة المركزية. أيضاً إذا كنت تحتاج إلى دعم لغات أخرى (Python, JavaScript) فهذه المكتبة لا تدعمها حالياً.

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

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

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

• مترجم C++ (مثل g++ أو MSVC) أو بيئة Java (JDK 8+) أو .NET SDK (لـ C#).
• معرفة أساسية بالـ logging في مشروعك.
• نظام تشغيل: Windows, Linux, macOS (غير مؤكد، لكن الغالب يدعم).

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

تنبيه: README الحالي غير واضح تماماً، لذا الخطوات التالية تقريبية بناءً على بنية المشروع. قد تحتاج إلى تعديلها حسب إصدار المكتبة.

1. استنساخ المستودع: git clone https://github.com/PenguineDavid/light-weight-logger.git
2. انتقل إلى المجلد الخاص باللغة التي تريدها (مثلاً cd light-weight-logger/cpp).
3. قم بتضمين الملفات في مشروعك: انسخ ملفات المصدر (مثل logger.h و logger.cpp) إلى مجلد مشروعك.
4. أضف الملفات إلى قائمة الترجمة (مثلاً في CMake أو Makefile).
5. ابدأ باستخدام المكتبة كما في الأمثلة أدناه.

شرح التنسيق المخصص (master_style) والألوان

master_style هو سلسلة نصية تحدد شكل السجل. العناصر الأساسية:

• %N: اسم المستوى (مثل ERROR).
• %D: التاريخ.
• %T: الوقت.
• %Z: المنطقة الزمنية.
• %M: الرسالة الأساسية.
• %F: اسم الملف.
• %t: thread ID.
• %L: رقم السطر.
• %C: لون البداية (لون العنصر التالي).
• %c: إعادة تعيين اللون.
• %S: مسافة.
• %G: لون رمادي.

مثال: 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.add_format("INFO", master_style, Colour::BLUE);

أمثلة عملية: تسجيل رسائل ERROR وINFO بألوان مختلفة

مثال بلغة C++:

#include "logger.h"

int main() {
    Logger logger;
    std::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.add_format("INFO", master_style, Colour::BLUE);

    logger.log("ERROR", "فشل الاتصال بقاعدة البيانات");
    logger.log("INFO", "تم بدء الخدمة بنجاح");
    return 0;
}

الخرج المتوقع (في الطرفية):

[ERROR] [2025-03-28 14:30:00 +03:00] فشل الاتصال بقاعدة البيانات (main.cpp:1:23)
[INFO] [2025-03-28 14:30:00 +03:00] تم بدء الخدمة بنجاح (main.cpp:1:24)

مع الألوان: ERROR باللون الأحمر، INFO بالأزرق، الطابع الزمني بالرمادي.

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

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

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

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

الإيجابيات: خفيف، مرن، مفتوح المصدر، يدعم ثلاث لغات.

السلبيات: README غير واضح، لا يوجد توثيق كافٍ، غير مناسب للمشاريع الكبيرة، عدد النجوم 0 (مشروع جديد).

الخلاصة: إذا كنت تبحث عن مكتبة تسجيل خفيفة لمشروع صغير أو تعليمي، وتريد تحكماً كاملاً في التنسيق، فجربها. أما إذا كان مشروعك إنتاجياً، فاستخدم بدائل أكثر نضجاً.

بدائل مشابهة

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

هل Light-Weight Logger يدعم اللغات الأخرى غير C++ وJava وC#؟

حسب README، لا يدعم حالياً. لكن يمكنك المساهمة في إضافة دعم لغات أخرى.

كيف يمكن تخصيص ألوان السجلات؟

استخدم الدالة add_format مع قيمة Colour المناسبة (مثل Colour::RED, Colour::BLUE).

هل المكتبة مناسبة للمشاريع الإنتاجية الكبيرة؟

لا، لأنها جديدة وغير مختبرة بشكل كافٍ. استخدمها في المشاريع الصغيرة أو التجريبية.

ما الفرق بين Light-Weight Logger وLog4j؟

Light-Weight Logger أخف وزناً وأبسط، لكن Log4j يوفر ميزات أكثر (تصفية، إخراج متعدد، إلخ).

هل يمكن استخدام المكتبة مع أنظمة التشغيل Linux وWindows وmacOS؟

من المتوقع، لكن غير مؤكد. جربها على نظامك.

كيف يمكن المساهمة في تطوير المكتبة؟

يمكنك فتح issue أو pull request على GitHub.

هل يوجد توثيق عربي للمكتبة؟

لا، هذا المقال هو أول دليل عربي.

ما هي رخصة المكتبة؟

غير محددة في README. افترض أنها مفتوحة المصدر.

خاتمة

Light-Weight Logger مشروع واعد لمطوري C++ وJava وC# الذين يريدون تحكماً دقيقاً في تنسيق السجلات دون تضخيم المشروع. جربه في مشروعك الصغير القادم، وساهم في تحسينه إذا أعجبك. تذكر أن تشارك تجربتك مع المجتمع العربي.