Groovy v Maguyva: grafy kódu pro Gradle a Jenkins

Kde Groovy podráží povrchní AI nástroje

Groovy se často čte jako konfigurace. V buildu Gradle je dependencies { implementation ... } řetězec volání metod s closures a deklarativní Jenkinsfile je na tom stejně. Buildery dělají z libovolných jmen volání a GDK přidává každému objektu metody jako each a collect. Nástroj, který zaznamená každé volání, se v tom šumu utopí.

Maguyva vrstvu DSL a GDK odfiltruje, aby vynikly vaše vlastní metody a třídy.

Co Maguyva v Groovy extrahuje

Maguyva pokrývá soubory .groovy a .gradle a také Jenkinsfile. Extrahují se třídy, funkce a metody a importy normalizují aliasy import static a as. Názvy volání se čistí od koncových bloků closures a operátoru bezpečné navigace ?., takže repo?.save(order) { ... } se zaznamená jako volání save. Volání bez příjemce uvnitř třídy se rozliší na vlastní metodu dané třídy.

Šum se filtruje ve vrstvách:

• Asi 140 názvů ze standardní knihovny, Gradle a Spocku, například dependencies, implementation, task, given, when, then a Mock.
• Asi 260 metod GDK, například each, collect, inject a eachLine.
• Názvy DSL builderů, včetně kroků Jenkinsu jako pipeline, stage, steps a sh, pokud se používají ve stylu builderu, a ne jako volání se závorkami.
• Anotace transformací AST a frameworků jako @CompileStatic, @Immutable a @Autowired, které se nikdy nezaznamenávají jako volání.

Graf zaznamenává také dědičnost, vytváření instancí a čtení a zápisy.

Ukázkové prompty pro agenty

• „Kdo volá deployToStaging a z kterých pipeline?“ (find_symbol, pak dependency_search incoming)
• „Které třídy dědí z BaseIntegrationSpec?“ (dependency_search)
• „Vysvětli, jak úloha release sestavuje a publikuje artefakty.“ (get_task_context)

Známá omezení

• Metody a volné funkce v Groovy sdílejí jeden syntaktický uzel, takže preset methods v structural_search nic nevybere. Použijte místo něj preset functions nebo find_symbol.
• Vaše metoda se stejným názvem jako metoda GDK nebo DSL, například collect nebo stage, se může odfiltrovat spolu s nimi. Když se zdá, že nějaké volání chybí, 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. Pro kód JVM, který vaše buildy kompilují, si přečtěte průvodce jazykem Java a průvodce jazykem Kotlin.