C++ i Maguyva: klass- och anropsgrafer för stora kodbaser

Varför C++ behöver struktur, inte textsökning

I C++ är namn inte unika. send kan vara en fri funktion, en medlem i tre klasser och en överskrivning i en fjärde. Namnrymder, templates och definitioner utanför klassen, som Socket::send i en .cpp-fil, sprider en typ över många filer. Textsökning returnerar varje träff men säger inte till en agent vilken av dem ett anrop når.

Maguyva indexerar klasser, medlemmar och anrop tillsammans med sina ägare, så att en agent kan följa den verkliga strukturen innan den redigerar.

Vad Maguyva extraherar i C++

Maguyva täcker de vanliga filändelserna för C++-källkod och headers, bland annat .cpp, .cc, .cxx, .hpp, .hh och .hxx. Klasser, structs och funktioner extraheras, och en definition utanför klassen som void Socket::send() tillskrivs sin ägarklass och namnrymd. Virtuella medlemmar registreras, och templateparametrar ingår i signaturerna.

Mottagartypningen följer parametrar, lokala deklarationer, fält, intervallbaserade for-loopar och auto, och ser igenom unique_ptr, shared_ptr och optional, så ett anrop som conn->send() kan lösas till rätt klass. Basklassatser matar arvet, och new-uttryck räknas som instansiering.

Samma maskering av export- och annoteringsmakron som i C gäller. Omkring 273 namn i standardbiblioteket (std::cout, std::endl, printf och liknande) filtreras bort ur relationerna. Grafen registrerar anrop, includes, arv, överskrivningar, instansiering, typreferenser, läsningar och skrivningar samt throw-kanter.

Exempel på prompter för agenter

• “Vilka klasser skriver över Renderer::draw, och vem anropar den?” (dependency_search)
• “Visa mig OrderBook::match och alla som anropar den.” (find_symbol)
• “Förklara hur ett marknadsdatameddelande når strategimotorn.” (get_task_context)

Kända begränsningar

• .h finns i filändelselistorna för C, C++ och Objective-C, så i träd som blandar C och C++ delas headers mellan de profilerna.
• Kroppar i objektliknande makron parsas inte, och anrop till filtrerade namn i standardbiblioteket är inte kanter i grafen. Använd text_pattern_search för makron och användning av std::.

Nästa steg

Anslut ett repo med snabbstarten och kontrollera sedan stödmatrisen på kompatibilitetssidan. Om delar av trädet är ren C, läs även guiden för C.