C++ i Maguyva: klasse- og kallgrafer for store kodebaser

Hvorfor C++ trenger struktur, ikke tekstsøk

I C++ er navn ikke unike. send kan være en fri funksjon, et medlem av tre klasser og en overstyring i en fjerde. Navnerom, templates og definisjoner utenfor klassen, som Socket::send i en .cpp-fil, sprer én type over mange filer. Tekstsøk returnerer hvert treff, men forteller ikke en agent hvilket av dem et kall treffer.

Maguyva indekserer klasser, medlemmer og kall sammen med eierne deres, slik at en agent kan følge den reelle strukturen før den redigerer.

Hva Maguyva henter ut i C++

Maguyva dekker de vanlige filendelsene for C++-kildekode og headere, blant annet .cpp, .cc, .cxx, .hpp, .hh og .hxx. Klasser, structs og funksjoner hentes ut, og en definisjon utenfor klassen som void Socket::send() tilskrives eierklassen og navnerommet sitt. Virtuelle medlemmer registreres, og templateparametere er en del av signaturene.

Mottakertypingen følger parametere, lokale deklarasjoner, felt, områdebaserte for-løkker og auto, og ser gjennom unique_ptr, shared_ptr og optional, så et kall som conn->send() kan løses til riktig klasse. Basisklasseklausuler gir grunnlag for arv, og new-uttrykk teller som instansiering.

Den samme maskeringen av eksport- og annoteringsmakroer som i C gjelder. Rundt 273 navn i standardbiblioteket (std::cout, std::endl, printf og lignende) filtreres ut av relasjonene. Grafen registrerer kall, includes, arv, overstyringer, instansiering, typereferanser, lesinger og skrivinger samt throw-kanter.

Eksempler på prompter for agenter

• «Hvilke klasser overstyrer Renderer::draw, og hvem kaller den?» (dependency_search)
• «Vis meg OrderBook::match og alle som kaller den.» (find_symbol)
• «Forklar hvordan en markedsdatamelding når strategimotoren.» (get_task_context)

Kjente begrensninger

• .h står på listene over filendelser for C, C++ og Objective-C, så i trær som blander C og C++, deles headere mellom disse profilene.
• Kropper i objektlignende makroer parses ikke, og kall til filtrerte navn i standardbiblioteket er ikke kanter i grafen. Bruk text_pattern_search for makroer og bruk av std::.

Neste steg

Koble til et repositorium med hurtigstarten, og se deretter støttematrisen på kompatibilitetssiden. Hvis deler av treet er ren C, bør du også lese veiledningen for C.