السجلات، قطع الأشجار. ما هو وكيفية تسجيل الأحداث في بايثون

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

ما هو التسجيل؟ وسجل؟

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

كيف يمكنني استخدامه؟

سوف نستخدم مكتبة التسجيل، والتي تأتي أصلاً في بايثون:

import logging

logging.basicConfig(
    filename="log-de-hoy.log",
    encoding="utf-8",
    level=logging.DEBUG,
    format="%(asctime)s %(levelname)s %(message)s"
)

def add(a, b):
    try:
        result = a   b
        logging.info(f"Adding {a} and {b}. Result: {result}")
    except TypeError:
        result = None
        logging.error("The values should be numeric")
    return result

print(add(2, 3)) # 5
print(add(2, "3")) # None

إذا قمنا بتنفيذ ذلك، سيتم إنشاء ملف يسمى log-de-hoy.log:

2023-12-08 11:56:30,544 INFO Adding 2 and 3. Result: 5
2023-12-08 11:56:30,544 ERROR The values should be numeric

توضيح

؟؟ نبدأ التكوين الأساسي: باستخدام logging.basicConfig نعلن:

• اسم الملف: اسم الملف المحدد الذي نريد إضافة السجلات إليه (على سبيل المثال الاسم هو log-de-hoy.log، ولكن من الناحية المثالية يجب أن يكون له اسم وصفي مع تاريخ اليوم)
• الترميز: نوع التنسيق الذي نحفظ به كل سجل
• المستوى: نحدد من أي مستوى نريد أن نلاحظ. المستويات المختلفة موجودة في وثائقها وسترى أن لها قيمة عددية، حيث تبلغ قيمة logging.INFO 20. إذا كنا بحاجة إلى debug، على الأقل أحتاج إلى 10. لذلك، باستخدام logging.DEBUG، نحن تأكد من تسجيل المستويات ذات القيمة 10 وما بعدها.
• التنسيق: التنسيق الذي يتم به تسجيل السجلات، وهو في هذه الحالة تاريخ مستوى الرسالة

؟؟ نسجل نتيجة المجموع مع معلومات المستوى

؟؟ نسجل خطأ إضافة int وسلسلة مع خطأ المستوى

لماذا استخدام التسجيل؟

ربما يمكنك تخيل ذلك بالفعل، نظرًا لأنها أداة قوية ستساعدنا في تحديد الحالات الشاذة بسرعة. بعض حالات الاستخدام لاستخدامه هي:

• ؟ تصحيح الأخطاء واستكشاف الأخطاء وإصلاحها
• ؟ مراقبة الأداء وتحليله
• ؟ التدقيق والامتثال
• ؟ كشف الأمان والشذوذ

لإنهاء…

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

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