Perl in Maguyva: Paket- und Subroutinen-Graphen

Warum Perl-Bestände schwer sicher zu ändern sind

Perl-Code ist dicht, flexibel und oft von Leuten geschrieben, die vor Jahren gegangen sind. Sigils ändern die Bedeutung eines Namens, Pakete dienen zugleich als Klassen, und dasselbe Modul wird von Skripten in vielen Verzeichnissen geladen. Eine Textsuche findet die Strings, sagt einem Agenten aber nicht, welche Subroutine ein Skript tatsächlich aufruft.

Maguyva gibt dem Agenten Pakete, Subroutinen, Importe und Konstruktoren als Struktur, damit er eine Änderung eingrenzen kann, bevor er den Code anfasst.

Was Maguyva in Perl extrahiert

Maguyva deckt .pl, .pm, .t, .pod und .perl ab. Subroutinen werden als Funktionen und package-Deklarationen als Klassen extrahiert; bei Definitionsnamen werden die Sigils ($, @, %, &, *) entfernt, sodass Variablen und Subroutinen unter ihrem bloßen Namen durchsuchbar sind.

Importe entstehen aus use-, require- und package-Anweisungen. Methodenaufrufe der Form Class->new zählen als Instanziierung, und bless sowie tie bleiben bewusst im Aufrufgraphen. Der Graph erfasst außerdem Vererbung, Overrides, Typreferenzen, Lese- und Schreibzugriffe sowie ausgelöste Ausnahmen.

Etwa 189 eingebaute Funktionen (print, open, die, warn und ähnliche) werden aus den Aufrufbeziehungen gefiltert, damit der Code des Repositorys hervortritt.

Beispiel-Prompts für Agenten

• „Welche Skripte nutzen Billing::Invoice, und welche seiner Subroutinen rufen sie auf?“ (dependency_search incoming)
• „Wo wird Report::Monthly erzeugt, und was passiert nach ->new?“ (find_symbol, dann get_task_context)
• „Finde jede Testdatei, die Auth::Session prüft.“ (text_pattern_search, dann find_symbol)

Bekannte Grenzen

• Klassische Perl-Methoden sind gewöhnliche sub-Deklarationen innerhalb eines Pakets, daher wird in der Struktursuche nur die neuere dedizierte method-Syntax als Methode eingeordnet. Nutze für älteres objektorientiertes Perl das Preset functions.
• Aufrufe gefilterter eingebauter Funktionen erscheinen nicht als Graphkanten. Verwende text_pattern_search, wenn du jeden open- oder print-Aufruf brauchst.

Nächste Schritte

Verbinde ein Repository über den Schnellstart und prüfe dann die Unterstützungsmatrix auf der Kompatibilitätsseite. Wenn der Bestand in eine andere Skriptsprache wandert, vergleiche mit dem Python-Leitfaden.