Pascal a Delphi v Maguyva: grafy jednotek a tříd

Proč kódová základna v Pascalu potřebuje nejdřív mapu

Aplikace v Delphi a Free Pascal často rostou kolem několika velkých jednotek, které používá všechno ostatní. Formuláře dědí ze základních formulářů, komponenty ze základních komponent a obchodní pravidla žijí v procedurách, které volá tucet obrazovek. Kód se čte dobře soubor po souboru, ale změny se pokazí na závislostech.

Maguyva dá agentovi nejdřív strukturu jednotek a tříd, aby dokázal říct, čeho se změna dotkne, ještě než něco napíše.

Co Maguyva v Pascalu extrahuje

Maguyva pokrývá zdrojové jednotky .pas a .pp. Definice procedur a funkcí se extrahují jako volatelné symboly a z názvů definic se odstraňují klíčová slova procedure, function, var a const. Třídy a rozhraní lze ve strukturním vyhledávání vybrat jako definice typů.

Importy vznikají z klauzulí uses; klíčové slovo se odstraní, takže graf uchovává názvy jednotek. Volání se normalizují odstraněním prefixů členů, argumentů a obalujících závorek, takže volání zapsané jako Self.Save(x) se uloží jako Save.

Graf zaznamenává volání, dědičnost, implementaci rozhraní, přepisy, vytváření instancí, odkazy na typy, čtení a zápisy a hrany vyvolání a ošetření výjimek. Přibližně 107 rutin běhové knihovny (WriteLn, ReadLn, Inc, Dec, Ord a podobné) je z vazeb vyřazeno.

Ukázkové prompty pro agenty

• „Které jednotky používají DataModuleMain a co z ní volají?“ (dependency_search incoming)
• „Které formuláře dědí z TBaseEditForm a které metody přepisují?“ (find_symbol, pak dependency_search)
• „Vysvětli, jak se zaúčtuje faktura, od obsluhy tlačítka po databázovou jednotku.“ (get_task_context)

Známá omezení

• K Pascalu jsou přiřazeny jen .pas a .pp. Soubory projektů a formulářů Delphi, jako .dpr a .dfm, nejsou v seznamu přípon, takže rozvržení formulářů a propojení projektu zůstávají mimo graf.
• Metody používají stejnou syntaxi jako volné procedury, takže preset methods v structural_search nic nevybere. Použijte preset functions.
• Volání odfiltrovaných rutin běhové knihovny se v grafu neobjeví jako hrany. K jejich vyhledání použijte text_pattern_search.

Další kroky

Připojte repozitář podle rychlého startu a pak si prohlédněte matici podpory na stránce kompatibility. Pokud aplikace linkuje knihovny v C, přečtěte si i průvodce jazykem C.