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

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

ما هو Light-Weight Logger؟

هي مكتبة تسجيل خفيفة تتيح لك تخصيص تنسيق السجلات بشكل كامل باستخدام رموز بسيطة. تدعم حالياً C++ وJava وC#. الميزة الرئيسية: يمكنك تعريف تنسيق رئيسي (master format) مثل:

master_style = "%C[%N]%c%S%G[%D %T %Z]%c %M %G(%F:%t:%L)";

ثم إضافة مستويات بألوان:

logger.add_format("ERROR", master_style, Colour::RED);

النتيجة: سطر أحمر يبدأ بـ [ERROR] ثم التاريخ والوقت والمنطقة الزمنية، ثم الرسالة، وأخيراً الملف ورقم السطر.

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

من يحتاجها:

• مطور C++ أو Java أو C# يريد تحسين سجلاته دون إضافة مكتبات ثقيلة.
• مشاريع صغيرة ومتوسطة تحتاج تسجيلاً مخصصاً بألوان.
• من يريد تعلم كيفية عمل أنظمة التسجيل من الداخل.

من لا يحتاجها:

• من يحتاج تسجيلاً في ملفات (file logging) – المكتبة حالياً تدعم الطرفية فقط.
• من يحتاج ميزات متقدمة مثل التسجيل غير المتزامن أو الضغط.
• من يعمل بلغات أخرى (Python, JavaScript) – المكتبة لا تدعمها حالياً.

المتطلبات الأساسية قبل البدء

• مترجم C++ يدعم C++11 على الأقل (مثل GCC 4.8+، Clang 3.3+، MSVC 2015+).
• بيئة Java مع JDK 8+.
• بيئة .NET مع C# 6+ (Visual Studio 2015+ أو .NET Core 2.0+).
• أداة Git لاستنساخ المستودع.

طريقة التركيب (تقريبية بناءً على هيكل المشروع)

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

1. استنساخ المستودع: git clone https://github.com/PenguineDavid/light-weight-logger.git
2. انتقل إلى مجلد اللغة المناسبة: cd light-weight-logger/cpp (أو java أو csharp).
3. أضف ملفات المصدر (مثل logger.h و logger.cpp) إلى مشروعك.
4. في C++: قم بتضمين logger.h في ملفاتك.
5. في Java: أضف ملفات .java إلى مسار الكلاس (classpath).
6. في C#: أضف ملفات .cs إلى مشروعك.

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

master format هو نص يحتوي على رموز خاصة يتم استبدالها بقيم عند التسجيل. الرموز المدعومة (حسب README):

الألوان المدعومة: RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, GREY, DEFAULT.

أمثلة عملية

مثال C++: تسجيل خطأ باللون الأحمر

#include "logger.h"

int main() {
    Logger logger;
    std::string master = "%C[%N]%c%S%G[%D %T %Z]%c %M %G(%F:%t:%L)";
    logger.add_format("ERROR", master, Colour::RED);
    logger.log("ERROR", "فشل الاتصال بقاعدة البيانات");
    return 0;
}

مثال Java: تسجيل تحذير باللون الأصفر

import logger.*;

public class Main {
    public static void main(String[] args) {
        Logger logger = new Logger();
        String master = "%C[%N]%c%S%G[%D %T %Z]%c %M %G(%F:%t:%L)";
        logger.addFormat("WARNING", master, Colour.YELLOW);
        logger.log("WARNING", "انتهاء صلاحية الجلسة");
    }
}

مثال C#: تسجيل معلومات باللون الأخضر

using Logger;

class Program {
    static void Main() {
        Logger logger = new Logger();
        string master = "%C[%N]%c%S%G[%D %T %Z]%c %M %G(%F:%t:%L)";
        logger.AddFormat("INFO", master, Colour.GREEN);
        logger.Log("INFO", "تم تحميل التطبيق بنجاح");
    }
}

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

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

• تسجيل أخطاء تطبيقات الحكومة الإلكترونية (مثل أبشر) بألوان لتسهيل التصحيح.
• مراقبة أداء تطبيقات الشركات الناشئة في الرياض ودبي.
• تسجيل عمليات المستخدمين في أنظمة نقاط البيع (POS) في المتاجر.

هل يستحق Light-Weight Logger التجربة؟

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

بدائل مشابهة

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

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

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

حسب README، لا تدعم حالياً. يمكنك إعادة توجيه مخرجات الطرفية إلى ملف باستخدام >>.

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

log4j أثقل وأكثر ميزات، بينما هذا المشروع يركز على البساطة والتخصيص البصري.

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

الترخيص غير محدد في README، لذا يُنصح بالتواصل مع المؤلف.

كيف أضيف ألواناً مخصصة غير المدعومة؟

حالياً الألوان محدودة. يمكنك تعديل المصدر لإضافة ألوان ANSI أخرى.

هل تعمل المكتبة على نظام Windows؟

نعم، بشرط استخدام طرفية تدعم ANSI (مثل Windows Terminal).

ماذا أفعل إذا واجهت خطأ في التركيب؟

تأكد من استيفاء المتطلبات، وراجع هيكل المشروع بعد الاستنساخ.

هل هناك خطط لدعم لغات أخرى مثل Python؟

غير مذكور في README.

خاتمة

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