Swift dans Maguyva : des graphes de code pour iOS et macOS

Pourquoi Swift demande plus qu’une recherche de fichiers

Swift répartit un même type à de nombreux endroits. Une structure est déclarée dans un fichier, reçoit du comportement d’extensions situées dans trois autres et se conforme à des protocoles définis dans un paquet. Les changements d’état se cachent dans les propriétés calculées et les observateurs willSet / didSet. Un agent qui lit un fichier à la fois en manque la plus grande partie.

Maguyva indexe cette structure, pour qu’un agent voie ensemble les membres d’un type, ses conformités et ses appelants.

Ce que Maguyva extrait en Swift

Maguyva couvre .swift. Les symboles appelables comprennent les fonctions, init et deinit, les subscripts, les getters et setters des propriétés calculées, et les observateurs willSet / didSet : le code qui modifie l’état se recherche donc comme un symbole au lieu de rester enfoui dans le corps des propriétés.

Les membres déclarés dans les structures, énumérations, protocoles et extensions sont qualifiés par leur type propriétaire (par exemple CartStore.add), et les membres ajoutés dans une extension sont rattachés au type étendu. Les paramètres génériques, les listes de conformité aux protocoles et les suffixes ? / ! sont retirés des noms de définition, si bien que les recherches utilisent le nom simple. Les appels conservent self. et la qualification par la classe, et les closures finales comptent dans l’arité de l’appel.

Le graphe enregistre les appels, la conformité aux protocoles, l’héritage, les surcharges, l’instanciation, les attributs, les références de type, les lectures et écritures, et les arêtes throw.

Exemples de prompts pour agents

• « Quels types sont conformes à PaymentProvider, et où chacun est-il créé ? » (dependency_search)
• « Qui appelle CartStore.add, et depuis quelles vues ? » (find_symbol, puis dependency_search en incoming)
• « Explique comment une notification push arrive jusqu’à l’écran de la boîte de réception. » (get_task_context)

Limites connues

• Seules les sources .swift sont associées. Les fichiers Storyboard et XIB ne figurent pas dans la liste des extensions ; les connexions Interface Builder restent donc hors du graphe.
• Les appels de la bibliothèque standard et de Foundation comme print, debugPrint, NSLog et les assertions sont filtrés des relations et ne sont donc pas des arêtes du graphe. Utilisez text_pattern_search pour les retrouver.

Étapes suivantes

Connectez un dépôt avec le démarrage rapide, puis consultez la matrice de prise en charge sur la page de compatibilité. Si vous livrez le même produit sur Android, lisez le guide Kotlin.