لغة Perl في Maguyva: رسوم بيانية للحزم والإجراءات الفرعية

لماذا يصعب تغيير إرث Perl بأمان

شيفرة Perl كثيفة ومرنة، وكثيرًا ما كتبها أشخاص رحلوا منذ سنوات. تغيّر الرموز البادئة (sigils) معنى الاسم، وتعمل الحزم أيضًا كفئات، وتُحمَّل الوحدة نفسها من سكربتات في أدلة كثيرة. يجد البحث النصي السلاسل، لكنه لا يخبر الوكيل بالإجراء الفرعي الذي يستدعيه السكربت فعلًا.

يمنح Maguyva الوكيل الحزم والإجراءات الفرعية والاستيرادات والمُنشئات على هيئة بنية، ليحدّد نطاق التغيير قبل أن يمسّ الشيفرة.

ما الذي يستخرجه Maguyva من Perl

يغطي Maguyva الملفات .pl و.pm و.t و.pod و.perl. تُستخرج الإجراءات الفرعية دوالَّ وتصريحات package فئاتٍ، وتُحذف الرموز البادئة ($ و@ و% و& و*) من أسماء التعريفات، فيمكن البحث عن المتغيرات والإجراءات الفرعية بأسمائها المجرّدة.

تأتي الاستيرادات من عبارات use وrequire وpackage. وتُعدّ استدعاءات الأساليب بصيغة Class->new إنشاءً لمثيلات، بينما يُستبقى bless وtie عمدًا في الرسم البياني للاستدعاءات. ويسجّل الرسم البياني أيضًا الوراثة والتجاوزات ومراجع الأنواع والقراءات والكتابات وإطلاق الاستثناءات.

يُستبعد من علاقات الاستدعاء نحو 189 دالة مدمجة (print وopen وdie وwarn وما شابهها)، لتبرز شيفرة المستودع.

أمثلة على مطالبات الوكلاء

• “ما السكربتات التي تستخدم Billing::Invoice، وأيّ إجراءاته الفرعية تستدعي؟” (dependency_search في الاتجاه الوارد)
• “أين يُنشأ Report::Monthly، وماذا يحدث بعد ->new؟” (find_symbol ثم get_task_context)
• “اعثر على كل ملفات الاختبار التي تختبر Auth::Session.” (text_pattern_search ثم find_symbol)

القيود المعروفة

• أساليب Perl الكلاسيكية مجرد تصريحات sub داخل حزمة، لذا لا يُصنَّف أسلوبًا في البحث البنيوي إلا الصياغة الأحدث المخصصة method. استخدم الإعداد المسبق functions لشيفرة Perl الكائنية القديمة.
• لا تظهر الاستدعاءات إلى الدوال المدمجة المستبعدة حوافَّ في الرسم البياني. استخدم text_pattern_search حين تحتاج إلى كل استدعاء لـ open أو print.

الخطوات التالية

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