Perl i Maguyva: paket- och subrutingrafer

Varför Perl-miljöer är svåra att ändra säkert

Perl-kod är kompakt, flexibel och ofta skriven av personer som slutade för flera år sedan. Sigiler ändrar betydelsen av ett namn, paket fungerar också som klasser, och samma modul laddas av skript i många kataloger. En textsökning hittar strängarna men säger inte till en agent vilken subrutin ett skript faktiskt anropar.

Maguyva ger agenten paket, subrutiner, importer och konstruktorer som struktur, så att den kan avgränsa en ändring innan den rör koden.

Vad Maguyva extraherar i Perl

Maguyva täcker .pl, .pm, .t, .pod och .perl. Subrutiner extraheras som funktioner och package-deklarationer som klasser, och sigilerna ($, @, %, &, *) tas bort ur definitionsnamnen så att variabler och subrutiner är sökbara på sina rena namn.

Importer kommer från use-, require- och package-satser. Metodanrop av formen Class->new räknas som instansiering, och bless och tie behålls avsiktligt i anropsgrafen. Grafen registrerar också arv, överskrivningar, typreferenser, läsningar och skrivningar samt kastade undantag.

Omkring 189 inbyggda funktioner (print, open, die, warn och liknande) filtreras bort ur anropsrelationerna så att repots kod syns.

Exempel på prompter för agenter

• “Vilka skript använder Billing::Invoice, och vilka av dess subrutiner anropar de?” (dependency_search incoming)
• “Var skapas Report::Monthly, och vad händer efter ->new?” (find_symbol, sedan get_task_context)
• “Hitta alla testfiler som prövar Auth::Session.” (text_pattern_search, sedan find_symbol)

Kända begränsningar

• Klassiska Perl-metoder är vanliga sub-deklarationer i ett paket, så i strukturell sökning klassas bara den nyare dedikerade method-syntaxen som metod. Använd förinställningen functions för äldre objektorienterad Perl.
• Anrop till filtrerade inbyggda funktioner visas inte som kanter i grafen. Använd text_pattern_search när du behöver varje anrop till open eller print.

Nästa steg

Anslut ett repo med snabbstarten och kontrollera sedan stödmatrisen på kompatibilitetssidan. Om miljön flyttar till ett annat skriptspråk, jämför med guiden för Python.