Pascal i Delphi w Maguyva: grafy modułów i klas

Dlaczego baza kodu w Pascalu najpierw potrzebuje mapy

Aplikacje w Delphi i Free Pascal często rosną wokół kilku dużych modułów, z których korzysta cała reszta. Formularze dziedziczą po formularzach bazowych, komponenty po komponentach bazowych, a reguły biznesowe żyją w procedurach wywoływanych przez kilkanaście ekranów. Plik po pliku kod czyta się dobrze, ale zmiany psują się na zależnościach.

Maguyva najpierw daje agentowi strukturę modułów i klas, aby mógł powiedzieć, czego dotyczy zmiana, zanim cokolwiek napisze.

Co Maguyva wyodrębnia w Pascalu

Maguyva obejmuje moduły źródłowe .pas i .pp. Definicje procedur i funkcji są wyodrębniane jako symbole wywoływalne, a z nazw definicji usuwane są słowa kluczowe procedure, function, var i const. Klasy i interfejsy można wybrać jako definicje typów w wyszukiwaniu strukturalnym.

Importy pochodzą z klauzul uses; słowo kluczowe jest usuwane, więc graf przechowuje nazwy modułów. Wywołania są normalizowane przez usunięcie prefiksów składowych, argumentów i otaczających nawiasów, więc wywołanie zapisane jako Self.Save(x) jest przechowywane jako Save.

Graf zapisuje wywołania, dziedziczenie, implementację interfejsów, nadpisania, tworzenie instancji, odwołania do typów, odczyty i zapisy oraz krawędzie zgłaszania i obsługi wyjątków. Około 107 procedur biblioteki uruchomieniowej (WriteLn, ReadLn, Inc, Dec, Ord i podobne) jest pomijanych w relacjach.

Przykładowe prompty dla agentów

• „Które moduły używają DataModuleMain i co z niego wywołują?” (dependency_search incoming)
• „Które formularze dziedziczą po TBaseEditForm i jakie metody nadpisują?” (find_symbol, potem dependency_search)
• „Wyjaśnij, jak faktura jest księgowana, od obsługi przycisku do modułu bazy danych.” (get_task_context)

Znane ograniczenia

• Do Pascala przypisane są tylko .pas i .pp. Pliki projektów i formularzy Delphi, takie jak .dpr i .dfm, nie znajdują się na liście rozszerzeń, więc układ formularzy i konfiguracja projektu pozostają poza grafem.
• Metody używają tej samej składni co wolne procedury, więc preset methods w structural_search niczego nie wybiera. Użyj presetu functions.
• Wywołania odfiltrowanych procedur biblioteki uruchomieniowej nie pojawiają się jako krawędzie grafu. Do ich wyszukiwania użyj text_pattern_search.

Kolejne kroki

Podłącz repozytorium za pomocą szybkiego startu, a potem sprawdź macierz obsługi na stronie zgodności. Jeśli aplikacja linkuje biblioteki C, przeczytaj też przewodnik po C.