com.pdbwhereami

غاية

هذه وحدة مساعدة تساعد في تصحيح أخطاء مصادر بايثون بالوظائف أدناه

• من أنا
• أين أنا
• من اتصل بي
• شجرة الاتصال
• من هو الأب

أين يتم استخدامه؟

تساعد هذه الوحدة المطورين بعدة طرق رئيسية، خاصة عندما يتعلق الأمر بتصحيح الأخطاء والحفاظ على التعليمات البرمجية. فيما يلي الفوائد الأساسية:

1. التصحيح:

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

2. التسجيل:

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

3. التأكيدات وإصدارات التصحيح:

• التأكيدات: استخدام وحدات الماكرو مثل تأكيد() مع whoami وwhereami وwhocallme وcalltree وwhosdaddy يساعد في اكتشاف الأخطاء المنطقية أثناء التطوير. عندما يفشل التأكيد، فإنه يطبع رقم السطر واسم الملف، مما يسهل تصحيح الأخطاء.
• التجميع الشرطي: بالنسبة لإصدارات تصحيح الأخطاء، يمكن تضمين معلومات تشخيصية إضافية باستخدام وحدات الماكرو هذه دون التأثير على إصدارات الإصدار.

4. التوثيق والصيانة:

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

من خلال الاستفادة من whoami وwhereami وwhocalledme وcalltree وwhosdaddy، يمكن للمطورين إنشاء أكواد برمجية أكثر قوة وقابلية للصيانة وأسهل في تصحيح الأخطاء.

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

from pdbwhereami import whoami, whereami, whocalledme, calledtree, whosdaddy

def debug_utility():
    whoami()
    whoami("I am in test_whoami function")

    print()

    whereami()
    whereami("I am in test_whereami")
    whereami(obsolete_path = True)
    whereami(path_depth=6)

    print()

    whocalledme()
    whocalledme(obsolete_path = True)
    whocalledme(path_depth=6)

    print()

    calledtree()
    tstr = calledtree(verbose=False)
    print(tstr)
    calledtree(tree_depth=1)
    calledtree(tree_depth=2)

    print()
    whosdaddy()

debug_utility()

انتاج

[debug_utility] ->
[debug_utility] -> I am in test_whoami function

[whereami/main.py:71]:debug_utility ->
[whereami/main.py:72]:debug_utility -> I am in test_whereami
[/home/bhagavan/whereami/main.py:73]:debug_utility ->
[/home/bhagavan/whereami/main.py:74]:debug_utility ->

[whereami/main.py:93]: ->
[/home/bhagavan/whereami/main.py:93]: ->
[/home/bhagavan/whereami/main.py:93]: ->

#1[/home/bhagavan/whereami/main.py:84]:debug_utility    ] ->

تثبيت

باستخدام النقطة

pip install pdbwhereami

باستخدام المصادر

git clone https://github.com/bhagavansprasad/pdbwhereami.git
cd pdbwhereami
pip insall ./