Perl у Maguyva: графи пакетів і підпрограм

Чому спадщину на Perl важко безпечно змінювати

Код на Perl щільний, гнучкий і часто написаний людьми, які пішли багато років тому. Сигіли змінюють значення назви, пакети водночас слугують класами, а той самий модуль завантажують скрипти з багатьох каталогів. Текстовий пошук знаходить рядки, але не каже агентові, яку підпрограму скрипт викликає насправді.

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 incoming)
• «Де створюється Report::Monthly і що відбувається після ->new?» (find_symbol, потім get_task_context)
• «Знайди всі тестові файли, що перевіряють Auth::Session.» (text_pattern_search, потім find_symbol)

Відомі обмеження

• Класичні методи Perl — це звичайні оголошення sub всередині пакета, тому в структурному пошуку методом вважається лише новий спеціальний синтаксис method. Для старого об’єктно-орієнтованого Perl використовуйте пресет functions.
• Виклики відфільтрованих вбудованих функцій не з’являються як ребра графа. Якщо потрібен кожен виклик open чи print, використовуйте text_pattern_search.

Наступні кроки

Під’єднайте репозиторій за швидким стартом, потім перегляньте матрицю підтримки на сторінці сумісності. Якщо спадщина переїжджає на іншу скриптову мову, порівняйте з посібником із мови Python.