Analyseur de code

L'analyseur de code est un outil essentiel pour quiconque travaille quotidiennement avec du code source.

Il peut effectuer des requêtes très complexes sur des référentiels de code source à une vitesse fulgurante, que ce soit en local ou sur un service cloud Sparx Intel. Les requêtes sont composées à l'aide d'un langage de haut niveau développé par Sparx System. Le langage utilise un vocabulaire restreint mais expressif qui s'apprend facilement et permet d'interroger les métriques de code beaucoup plus rapidement que les méthodes conventionnelles.

Accéder

Menu de l'analyseur de code

Le menu de l'analyseur de code s'affiche lorsque vous cliquez sur l'icône dans le coin supérieur gauche de la fenêtre.

Le menu fournit diverses commandes pour les activités associées à l'utilisation de Code Analyzer, notamment le choix d'une base de données Code Miner à utiliser, la mise à jour de la base de données Code Miner et l'ouverture d'un fichier Query pour modification.

Ce tableau décrit chacune des commandes du menu.

Avant d'utiliser l'analyseur

Avant de pouvoir utiliser Code Analyzer, vous devez d'abord créer une base de données Code Miner ou en localiser une existante à laquelle Code Analyzer peut accéder. La création d'une base de données Code Miner est résumée ici, ou vous pouvez lire une description détaillée dans la rubrique d'aide Création d'une nouvelle base de données Code Miner .

En fonction de l'emplacement de la bibliothèque que vous utiliserez, vous devrez soit :

• Sélectionnez un fichier de bibliothèque Code Miner à utiliser, ou
• Connectez-vous à un service qui héberge une base de données Code Miner .

Une fois ces étapes terminées, vous êtes prêt à commencer à écrire et à exécuter des requêtes dans l’analyseur de code.

Création d'une base de données Code Miner

Les bases de données Code Miner sont créées à partir de référentiels de code source. Le processus est similaire à la compilation de code, en utilisant la grammaire du langage pour analyser les fichiers individuels.

Il existe deux types de build : complet et incrémental. Le build complet initial peut prendre un certain temps, mais les builds incrémentales suivantes sont incroyablement rapides.

Utiliser un répertoire comme entrée

Vous pouvez sélectionner un seul dossier comme racine du code source que vous souhaitez compiler. Avec cette option, vous pouvez choisir d'inclure des sous-répertoires

Utilisation d'une liste de répertoires

Parfois, vous souhaitez utiliser plusieurs projets, mais tous les projets ne se trouvent pas dans un seul répertoire. Dans ce cas, vous pouvez créer un fichier texte qui répertorie le chemin d'accès complet à chaque dossier que vous souhaitez inclure et spécifier ce fichier texte dans le champ « Source ». Chaque chemin d'accès au répertoire doit être répertorié sur une ligne distincte.

c:\mesprojets\project1\tools\scintilla

c:\mesprojets\project2\src

d:\mylibs\lib1\src

Si vous souhaitez traiter de manière récursive les sous-répertoires d'un répertoire, faites précéder le chemin d'un point d'exclamation comme ceci :

!d:\mylibs\lib1\src

Toute ligne commençant par un caractère # est traitée comme un commentaire.

# inclure scintilla

c:\mesprojets\project1\tools\scintilla

Langue

Dans ce champ, vous spécifiez la langue utilisée dans le code source à partir duquel cette base de données Code Miner est construite.

Les langages disponibles sont : C++, C# , Java, XML, MDGTechnology et Custom.

Liste des macros

Lorsque le langage sélectionné est « C++ », le champ de sélection « Liste des macros » s'affiche. Pour C++, le succès et la profondeur des informations compilées dans la base de données peuvent être inextricablement liés à l'utilisation de macros. Ce champ peut être utilisé pour sélectionner un fichier de macro nBNF qui sera utilisé comme composant grammatical auxiliaire pour la compilation.

Par défaut, le fichier macro est celui qui se trouve dans le dossier d'installation Enterprise Architect . Vous êtes libre de modifier ou d'étendre le contenu de ce fichier pour l'adapter à vos besoins, par exemple lorsque vous devez corriger des erreurs signalées dans le fichier log de compilation.

Grammaire

Sparx Systems a développé des grammaires pour tous les langages répertoriés dans la liste déroulante : C++, C# , Java, XML et également MDGTechnology. Pour ces langages, un fichier de grammaire intégré est utilisé.

Il existe également une option permettant de sélectionner une langue « Personnalisée ». Lorsque « Personnalisée » est sélectionné, le champ « Grammaire » s'affiche. Ce champ permet de spécifier un fichier contenant la grammaire de votre langue personnalisée. Code Miner utilisera ensuite cette grammaire pour analyser le code source écrit dans cette langue.

Les utilisateurs qui développent un langage personnalisé devront spécifier les règles grammaticales de ce langage et les enregistrer dans un fichier nBNF. L'éditeur de grammaire d' Enterprise Architect est conçu spécifiquement à cet effet.

Le Help Topic Grammar Framework fournit des informations détaillées sur la rédaction d'une grammaire nBNF.

Mise à jour d'une base de données Code Miner

De temps en temps, vous souhaiterez mettre à jour votre base de données Code Miner . Généralement, lorsque vous avez apporté des modifications à votre code source, mais également après avoir mis à jour un fichier de grammaire ou étendu un fichier de macro.

Le processus de mise à jour d'une base de données est très similaire à la création d'une nouvelle base de données, mais plus rapide car vous ne partez pas de zéro. Choisissez simplement l'option de menu « Mettre à jour la base de données ». La dialogue « Mise à jour de la base de données Code Miner » s'affiche. Les champs de saisie seront renseignés avec les valeurs de la dernière version. Procédez comme pour « Créer une base de données Code Miner ».

Sélection d'un fichier de base de données Code Miner

Si vous choisissez d'utiliser un fichier de bibliothèque pour votre base de données Code Miner , choisissez l'option de menu « Rechercher une base de données ». Cela affichera un « Sélecteur de fichiers », dans lequel vous pourrez rechercher et sélectionner un fichier *.cdb.

Connexion à un service

Lors de la connexion à un service, le dialogue répertorie toutes les bases de données hébergées par le service.

Vous pouvez choisir de sélectionner une base de données individuelle dans la liste, ou simplement cliquer sur le bouton Sélectionner, auquel cas les requêtes seront exécutées sur toutes les bases de données répertoriées par le service.

Exécution de requêtes

Une fois connecté à une base de données Code Miner , vous êtes prêt à commencer à exécuter des requêtes.

Pour exécuter une requête, sélectionnez l'onglet Query dans la fenêtre Code Analyzer, saisissez votre requête, puis cliquez sur l'icône pour exécuter la requête.

Dans cet exemple, nous avons exécuter un nœud de requête simple ( « CLASS » ), qui renverra tous les nœuds « Class » trouvés dans la base de données Code Miner .

En sélectionnant un résultat dans le panneau inférieur gauche, l'onglet « Source » est activé et affiche le code source correspondant au nœud sélectionné. Les détails de ce nœud de classe sont affichés dans le panneau inférieur droit.

La sélection d’un élément de détail dans le panneau inférieur droit entraîne un rétrécissement de la sélection dans le code source, comme indiqué ici.

Query Example - Intersection

As an example, this mFQL query finds all the classes that have an operation named GetOption.
    andat( "CLASS", item("OPERATION", "NAME", "GetOption"), node("CLASS"))

This clause returns a set of operations for which the 'NAME' value is "GetOption":
    item("OPERATION", "NAME", "GetOption")

This clause returns a set of all Class nodes:
    node("CLASS")

Formal syntax:
    andat( string:rule, set:left, set:right)

'andat' takes the set of operations (left), applies the rule "CLASS" (only include rows that have a CLASS parent), then intersects that set with the set of all known classes (right).  If the intersection succeeds, the operation node is added to the result set, otherwise it is excluded.

Le langage Query - mFQL

Le langage de requête utilisé avec Code Analyzer est décrit en détail dans la rubrique d'aide Code Miner Query Language (mFQL) .

Une brève description et quelques exemples sont également présentés ici.

Le langage mFQL est basé sur des ensembles. Chaque instruction fonctionne en utilisant les différents types d'opérations sur les ensembles, dont il n'existe que quelques-uns.

Apprendre encore plus

• Cadre Code Miner
• Bibliothèques Code Miner
• Requêtes Code Miner
• Langage Query Code Miner (mFQL)
• Service Intel Sparx
• Scripts d’Analyseur - Analyseur d'Exécution
• Script Code Miner - Analyseur d'Exécution