المسارات
/
Elixir
Elixir
/
التمارين
/
محلّل السجلات
محلّل السجلات

محلّل السجلات

تمرين تعلّمي

مقدمة

التعبيرات النمطية

تتبع التعبيرات النمطية في Elixir مواصفة PCRE (Perl Compatible Regular Expressions)، على غرار لغات شائعة أخرى مثل Java وJavaScript وRuby.

توفّر وحدة Regex دوالًا للعمل مع التعبيرات النمطية. كما تقبل بعض دوال وحدة String تعبيرات نمطية كوسائط أيضًا.

Note

يفترض هذا التمرين أنك تعرف بالفعل صياغة التعبيرات النمطية، بما في ذلك أصناف المحارف ومحددات الكمية والمجموعات والالتقاطات.

إذا كنت بحاجة إلى تحديث معرفتك بالتعبيرات النمطية، فراجع أحد هذه المصادر: Regular-Expressions.info، وRex Egg، وRegexOne، وRegular Expressions 101، وRegExr.

السيجيلات

أكثر الأساليب شيوعًا لإنشاء التعبيرات النمطية هو استخدام سيجيل ~r.

~r/test/

لاحظ أن جميع سيجيلات Elixir تدعم أنواعًا مختلفة من المحددات، وليس / فقط.

المطابقة

يمكن استخدام العامل =~/2 لإجراء مطابقة تعبير نمطي تُرجع نتيجة من النوع boolean. وبدلًا من ذلك، توجد أيضًا دوال match?/2 في وحدة Regex وكذلك في وحدة String.

"this is a test" =~ ~r/test/
# => true

String.match?("Alice has 7 apples", ~r/\d{2}/)
# => false

الالتقاط

إذا لم يكفِ فحص منطقي بسيط، فاستخدم الدالة Regex.run/3 للحصول على قائمة بكل الالتقاطات (أو nil إذا لم تكن هناك مطابقة). العنصر الأول في القائمة المُرجَعة هو دائمًا مطابقة للتعبير النمطي كاملًا، والعناصر التالية هي مجموعات مطابِقة.

Regex.run(~r/(\d) apples/, "Alice has 7 apples")
# => ["7 apples", "7"]

المُعدِّلات

يمكن تعديل سلوك التعبير النمطي بإضافة أعلام خاصة. وعند استخدام سيجيل لإنشاء تعبير نمطي، أضف المُعدِّلات بعد المحدِّد الثاني.

من المُعدِّلات الشائعة:

  • i - يجعل المطابقة غير حساسة لحالة الأحرف.
  • u - يفعّل أنماط Unicode الخاصة مثل \p ويجعل أصناف المحارف مثل \w و\s وغيرها تطابق محارف Unicode أيضًا.
"this is a TEST" =~ ~r/test/i
# => true

التعليمات

بعد مراجعة أمنية حديثة، طُلب منك تنظيف ملفات السجل المؤرشفة الخاصة بالمؤسسة.

1. تحديد أسطر السجل المشوّشة

تحتاج إلى معرفة تقريبية بعدد أسطر السجل في أرشيفك التي لا تتوافق مع المعايير الحالية. وتعتقد أن اختبارًا بسيطًا يكشف ما إذا كان سطر السجل صالحًا أم لا. لكي يُعتبر السطر صالحًا، يجب أن يبدأ بأحد السلاسل النصية التالية:

  • [DEBUG]
  • [INFO]
  • [WARNING]
  • [ERROR]

نفّذ الدالة valid_line?/1 لتُرجع true إذا كان سطر السجل صالحًا.

LogParser.valid_line?("[ERROR] Network Failure")
# => true

LogParser.valid_line?("Network Failure")
# => false

2. تقسيم سطر السجل

بعد وقت قصير من بدء مشروع تحليل السجلات، تدرك أن سجلات أحد التطبيقات ليست مقسّمة إلى أسطر مثل البقية. في هذا المشروع، ما كان يجب أن يكون أسطرًا منفصلة صار في سطر واحد، متصلًا بأسهم مزخرفة مثل <---> أو <*~*~>.

في الواقع، أي سلسلة نصية يبدأ محرفها الأول بـ < وينتهي محرفها الأخير بـ > وتحتوي في ما بينهما على أي مزيج من المحارف التالية ~ و * و = و - يمكن استخدامها فاصلًا في سجلات هذا المشروع.

نفّذ الدالة split_line/1 التي تأخذ سطرًا وتُرجع قائمة من السلاسل النصية.

LogParser.split_line("[INFO] Start.<*>[INFO] Processing...<~~~>[INFO] Success.")
# => ["[INFO] Start.", "[INFO] Processing...", "[INFO] Success."]

3. إزالة الشوائب من السجل

اكتشفت أن بعض المعالجة الأولية للسجلات كانت تنثر النص "end-of-line" متبوعًا برقم سطر (بدون مسافة فاصلة بينهما) في أنحاء السجلات.

نفّذ الدالة remove_artifacts/1 لتأخذ سلسلة نصية وتزيل كل ظهورات نص end-of-line (دون اعتبار لحالة الأحرف) وتُرجع سطر سجل نظيفًا.

تُعاد الأسطر التي لا تحتوي على نص end-of-line دون تعديل.

أزل فقط نص end-of-line، فلا حاجة لتعديل المسافات البيضاء.

LogParser.remove_artifacts("[WARNING] end-of-line23033 Network Failure end-of-line27")
# => "[WARNING]  Network Failure "

4. وسم الأسطر بأسماء المستخدمين

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

نفّذ الدالة tag_with_user_name/1 التي تعالج أسطر السجل:

  • الأسطر التي لا تحتوي على السلسلة النصية "User" تبقى دون تغيير.
  • الأسطر التي تحتوي على السلسلة النصية "User"، أضف إليها في البداية [USER] متبوعًا باسم المستخدم.
LogParser.tag_with_user_name("[INFO] User Alice created a new project")
# => "[USER] Alice [INFO] User Alice created a new project"

يمكنك أن تفترض ما يلي:

  • كل ظهور للسلسلة النصية "User" يتبعه محرف مسافة بيضاء واحد أو أكثر ثم اسم المستخدم.
  • يوجد على الأكثر ظهور واحد للسلسلة النصية "User" في كل سطر.
  • أسماء المستخدمين سلاسل نصية غير فارغة لا تحتوي على مسافات بيضاء.
تعديل عبر GitHub يفتح الرابط في نافذة أو علامة تبويب جديدة
Elixir Exercism

مستعد لبدء محلّل السجلات؟

سجّل في Exercism لتتعلّم وتتقن Elixir عبر 58 مفهومًا168 تمرينًا، وإرشاد بشري حقيقي، وكل ذلك مجانًا.