Pascal en Delphi in Maguyva: unit- en klassengrafen

Waarom een Pascal-codebase eerst een kaart nodig heeft

Delphi- en Free Pascal-applicaties groeien vaak rond een paar grote units die al het andere gebruikt. Formulieren erven van basisformulieren, componenten van basiscomponenten, en bedrijfsregels zitten in procedures die een dozijn schermen aanroepen. Bestand voor bestand leest de code prima, maar in de afhankelijkheden gaan wijzigingen mis.

Maguyva geeft een agent eerst de unit- en klassenstructuur, zodat hij kan zeggen wat een wijziging raakt voordat hij iets schrijft.

Wat Maguyva in Pascal extraheert

Maguyva dekt de bron-units .pas en .pp. Procedure- en functiedefinities worden geëxtraheerd als aanroepbare symbolen, waarbij de sleutelwoorden procedure, function, var en const uit definitienamen worden verwijderd. Klassen en interfaces zijn in structureel zoeken te selecteren als typedefinities.

Imports komen uit uses-clausules; het sleutelwoord wordt verwijderd, zodat de graaf unitnamen opslaat. Aanroepen worden genormaliseerd door memberprefixen, argumenten en omsluitende haakjes te verwijderen, dus een aanroep geschreven als Self.Save(x) wordt opgeslagen als Save.

De graaf legt aanroepen vast, overerving, interface-implementatie, overrides, instantiëring, typeverwijzingen, lees- en schrijfacties, en randen voor het opwerpen en afhandelen van exceptions. Ongeveer 107 routines uit de runtimebibliotheek (WriteLn, ReadLn, Inc, Dec, Ord en vergelijkbare) worden uit de relaties gefilterd.

Voorbeeldprompts voor agents

• “Welke units gebruiken DataModuleMain, en wat roepen ze daaruit aan?” (dependency_search incoming)
• “Welke formulieren erven van TBaseEditForm, en welke methoden overschrijven ze?” (find_symbol, daarna dependency_search)
• “Leg uit hoe een factuur wordt geboekt, van de knophandler tot de database-unit.” (get_task_context)

Bekende beperkingen

• Alleen .pas en .pp zijn aan Pascal gekoppeld. Delphi-project- en formulierbestanden zoals .dpr en .dfm staan niet in de extensielijst, dus formulierlay-outs en projectbedrading vallen buiten de graaf.
• Methoden gebruiken dezelfde syntaxis als losse procedures, dus de preset methods in structural_search selecteert niets. Gebruik de preset functions.
• Aanroepen van gefilterde runtimeroutines verschijnen niet als randen in de graaf. Gebruik daarvoor text_pattern_search.

Volgende stappen

Koppel een repository via de snelstart en bekijk daarna de ondersteuningsmatrix op de compatibiliteitspagina. Als de applicatie C-bibliotheken linkt, lees dan ook de C-gids.