Suivi des tendances

CppDepend fournit de puissants suivi des tendances fonctionnalités qui vous permettent de suivre les métriques de code dans le temps. Les graphiques de tendance sont composés de métriques de tendance valeurs enregistrées au fil du temps lors de l'analyse. Plus de 50 métriques de tendance sont disponibles par défaut et il est facile de créer vos propres métriques de tendance.

• Introduction
• Métriques de tendance
• Graphiques de tendances
• Graphiques de tendance du rapport
• Journalisation des métriques de tendance

Les graphiques de tendances s’affichent sur le tableau de bord CppDepend. Certains sont disponibles par défaut pour montrer :

• Lignes de code
• Nombre de règles de code violées et nombre de violations de règles
• Valeurs max et moyennes pour diverses métriques de qualité du code
• Utilisation tierce

Les graphiques de tendances sont personnalisables : créez facilement les vôtres pour afficher des métriques de tendance par défaut et/ou personnalisées.

Pour toutes les opérations liées aux tendances, un menu tendance est disponible.

Haut de page

Pour lister les métriques de tendance par défaut, regardez le Panneau Explorateur de requêtes et règles et sélectionnez le groupe nommé Métriques de tendance.

Si les métriques de tendance sont listées dans le panneau des requêtes de code, c'est parce qu'une métrique de tendance est une requête de code CQLinq. C'est une requête de code particulière :

• Une métrique de tendance est une requête de code qui retourne un scalaire. Par conséquent, les requêtes de métriques de tendance utilisent souvent des opérateurs d'agrégation LINQ qui retournent un scalaire. Cela inclut des opérateurs comme Count() Sum() Average() Min() Max() ...
• L'en-tête d'une requête de code est une ligne de commentaire formatée ainsi // <TrendMetric Name="Metric Name" Unit="Metric Unit Name" />

Voici par exemple le # Lignes de code requête de code de métrique de tendance :

Une métrique de tendance étant une requête de code, il est facile de créer vos propres métriques de tendance ou de modifier celles existantes. Par exemple, voici une requête de code qui compte le nombre de types héritant de Poco.Exception:

Il existe six métriques de tendance par défaut qui ne sont pas des requêtes de code. Elles concernent le nombre de règles de code enfreintes et le nombre de violations de règles de code :

Les métriques de tendance sont journalisées au moment de l'analyse, comme expliqué dans la section Journalisation des métriques de tendance.

Haut de page

La boîte de dialogue Create or Edit trend charts vous permet de définir toutes les propriétés du graphique de tendance. La liste des séries de métriques de tendance est disponible et cocher une série permet de la visualiser sur le graphique de tendance. L'apparence d'une série peut être personnalisée, cela inclut :

• La couleur de la série
• Si la série est affichée sous forme de ligne ou d'aire
• Définition de l'échelle des séries. Le paramètre d'échelle est utile pour ajuster les échelles de plusieurs séries afin de les comparer sur le même graphique de tendance.

Haut de page

Sur l'image ci-dessus, on voit une case à cocher intitulée : Afficher ce graphique de tendance dans le rapport Les graphiques de tendance peuvent en effet être affichés dans le rapport.

Pour cela, la case à cocher Panneau Propriétés du projet CppDepend > onglet Report > Use standard report coché > Trend Charts doit être cochée.

Haut de page

Les valeurs des métriques de tendance sont journalisées au moment de l'analyse. En exécutant l'analyse chaque jour, une série de valeurs est constituée.

Les paramètres liés au journal des valeurs des métriques de tendance sont disponibles, à la fois dans Options CppDepend > Tendance section, et dans le Propriétés du projet CppDepend > Analysis > Trend Metrics Log section. Si des paramètres sont définis dans les propriétés du projet, ils remplacent les paramètres globaux définis dans les Options.

Les paramètres du journal des métriques de tendance incluent :

• La fréquence des journaux, par exemple au maximum une fois par jour ou par semaine
• La définition d'un libellé pour chaque journal, qui représente la version de la base de code analysée. Dans la capture d'écran du graphique de tendance ci-dessus, vous pouvez voir que ce libellé de version est affiché sur les graphiques de tendance sur l'axe X de la chronologie.
• Le dossier où sont conservés les fichiers contenant les valeurs des métriques de tendance. Pour éviter des fichiers trop volumineux, un fichier est créé par année.

Notez que, quels que soient les paramètres de journal des métriques de tendance, l'utilisation de CppDepend.Console.exe paramètre de ligne de commande /LogTrendMetrics force la journalisation des métriques de tendance pendant l'analyse.