C++ w Maguyva: grafy klas i wywołań dla dużych baz kodu

Dlaczego C++ potrzebuje struktury, a nie wyszukiwania tekstu

W C++ nazwy nie są unikalne. send może być wolną funkcją, składową trzech klas i nadpisaniem w czwartej. Przestrzenie nazw, szablony i definicje poza klasą, takie jak Socket::send w pliku .cpp, rozpraszają jeden typ po wielu plikach. Wyszukiwanie tekstowe zwraca każde dopasowanie, ale nie mówi agentowi, do którego trafia wywołanie.

Maguyva indeksuje klasy, składowe i wywołania razem z ich właścicielami, aby agent mógł podążać za prawdziwą strukturą przed edycją.

Co Maguyva wyodrębnia w C++

Maguyva obejmuje typowe rozszerzenia źródeł i nagłówków C++, w tym .cpp, .cc, .cxx, .hpp, .hh i .hxx. Wyodrębniane są klasy, struktury i funkcje, a definicja poza klasą, taka jak void Socket::send(), jest przypisywana do klasy i przestrzeni nazw właściciela. Składowe wirtualne są zapisywane, a parametry szablonów są częścią sygnatur.

Typowanie odbiorców śledzi parametry, deklaracje lokalne, pola, pętle for oparte na zakresie oraz auto, i patrzy przez unique_ptr, shared_ptr i optional, więc wywołanie takie jak conn->send() można rozwiązać do właściwej klasy. Klauzule klas bazowych zasilają dziedziczenie, a wyrażenia new liczą się jako tworzenie instancji.

Obowiązuje to samo maskowanie makr eksportu i adnotacji co w C. Około 273 nazw biblioteki standardowej (std::cout, std::endl, printf i podobne) jest filtrowanych z relacji. Graf zapisuje wywołania, include’y, dziedziczenie, nadpisania, tworzenie instancji, odwołania do typów, odczyty i zapisy oraz krawędzie throw.

Przykładowe prompty dla agentów

• „Które klasy nadpisują Renderer::draw i kto je wywołuje?” (dependency_search)
• „Pokaż mi OrderBook::match i wszystkich wywołujących.” (find_symbol)
• „Wyjaśnij, jak komunikat z danymi rynkowymi trafia do silnika strategii.” (get_task_context)

Znane ograniczenia

• .h występuje na listach rozszerzeń C, C++ i Objective-C, więc w drzewach łączących C i C++ nagłówki są współdzielone między tymi profilami.
• Treści makr obiektowych nie są parsowane, a wywołania odfiltrowanych nazw biblioteki standardowej nie są krawędziami grafu. Do makr i użyć std:: stosuj text_pattern_search.

Kolejne kroki

Podłącz repozytorium za pomocą szybkiego startu, a potem sprawdź macierz obsługi na stronie zgodności. Jeśli część drzewa to czyste C, przeczytaj też przewodnik po C.