Perl in Maguyva: grafi di package e subroutine

Perché è difficile modificare Perl in sicurezza

Il codice Perl è denso, flessibile e spesso scritto da persone andate via da anni. I sigil cambiano il significato di un nome, i package fanno anche da classi, e lo stesso modulo viene caricato da script in molte directory. Una ricerca testuale trova le stringhe, ma non dice a un agente quale subroutine uno script chiama davvero.

Maguyva fornisce all’agente package, subroutine, import e costruttori come struttura, così può delimitare una modifica prima di toccare il codice.

Cosa estrae Maguyva in Perl

Maguyva copre .pl, .pm, .t, .pod e .perl. Le subroutine vengono estratte come funzioni e le dichiarazioni package come classi, e ai nomi delle definizioni vengono tolti i sigil ($, @, %, &, *), così variabili e subroutine sono ricercabili con il loro nome semplice.

Gli import derivano dalle istruzioni use, require e package. Le chiamate di metodo nella forma Class->new contano come istanziazione, e bless e tie restano di proposito nel grafo delle chiamate. Il grafo registra anche ereditarietà, override, riferimenti di tipo, letture e scritture, e sollevamento di eccezioni.

Circa 189 funzioni built-in (print, open, die, warn e simili) vengono filtrate dalle relazioni di chiamata, così il codice del repository risalta.

Esempi di prompt per agenti

• “Quali script usano Billing::Invoice e quali sue subroutine chiamano?” (dependency_search incoming)
• “Dove viene costruito Report::Monthly e cosa succede dopo ->new?” (find_symbol, poi get_task_context)
• “Trova tutti i file di test che esercitano Auth::Session.” (text_pattern_search, poi find_symbol)

Limiti noti

• I metodi Perl classici sono normali dichiarazioni sub dentro un package, quindi nella ricerca strutturale solo la più recente sintassi dedicata method viene classificata come metodo. Usa il preset functions per il Perl orientato agli oggetti più vecchio.
• Le chiamate alle funzioni built-in filtrate non compaiono come archi del grafo. Usa text_pattern_search quando ti serve ogni chiamata a open o print.

Prossimi passi

Collega un repository con la guida rapida, poi consulta la matrice di supporto nella pagina di compatibilità. Se il patrimonio sta migrando verso un altro linguaggio di scripting, confrontalo con la guida a Python.