Validating Quality Gates and Code Rules in Visual Studio

One popular aspect of the tool NDepend is the integration of the tool into the Continuous Integration build process. Every morning the team leader gets an up-to-date report telling if some Quality Gates or some Rules have been violated yesterday.

NDepend integrated in Visual Studio 2017, 2015, 2013, 2012 and 2010 is a smoother answer to the critical scenario when a developer violates a rule or a Quality Gate. Waiting till the day after to discover that a rules get violated is too long, it is not enough agile-oriented. It also means that a problem has been commited to the source control. Hence CQLinq rules and Quality Gates violation warn as soon as possible, right within Visual Studio.

All Quality Gates and rules are passed into Visual Studio as soon as one or several VS projects have been (re)compiled. And it just take a few seconds without slowing down the IDE.

▲▲ Go to Top ▲▲

Checking if there are Quality Gates and Rules Violations

The developer gets permanently informed of CQLinq rules validation status thanks to a NDepend progress circle located in the bottom-right corner of the Visual Studio window.
  • green, means that all Quality Gates pass and all CQLinq rules are validated,

  • yellow, means that some activated Quality Gates warns or that some CQLinq rules are violated,

  • red, means:
    • some Quality Gates fail or
    • some critical CQLinq rules are violated or
    • some activated CQLinq queries don’t compile or
    • some activated CQLinq queries have an execution problem (exception thrown or time-out)

  • blue + progressing, means that the code is currently loaded by NDepend,

  • blue + progressing + rotating chevrons, means that the code is currently analyzed by NDepend,

  • grey, means that no NDepend project is currently loaded in VisualStudio.

On the NDepend Dashboard, you can see the number of rules violated and the number of Quality Gates, Rules and Issues per severity and status.

If a baseline is available, the dashboard also shows the diff numbers since the baseline.

All numbers are clickable, and when clicked a LINQ query is generated to list concerned Quality Gates, Rules or Issues in the NDepend query editor.

▲▲ Go to Top ▲▲

Rules Explorer and Rules Edition

The CQLinq Explorer lists all Quality Gates and rules grouped by categories… Quality Gates status is represented with a losange while rules status si represented with a circle.

…and by clicking a rule you can jump to the CQLinq edition panel, where you can edit the rule and see culprit methods or classes that violate the rule.

Of course double clicking a culprit method or class lets jump to its source code declaration. And if the application analyzed by NDepend spawns several VS solutions, and these solutions are currently opened in several VS instances, the code element gets edited within the adequate VS instance, the one that contains the VS solution that contains the code element. This behavior at first glance might surprise and even look like a bug. But with the habits it becomes a powerful time-saver trick. And this multi-VS-instances communication trick is made possible thanks to the Application-Wide code analysis of NDepend.

▲▲ Go to Top ▲▲

Focusing on Recent Issues Introduced Since Baseline

As a static analyzer, NDepend will likely find hundreds or even thousands of issues affecting a real-world code base. Stopping work to attempt to fix all issues for weeks would be quite unproductive.

This is why NDepend is the only tool that offers a baseline in Visual Studio. The tool estimates the Technical Debt progress since a baseline.

Recent code smells that should be fixed before committing any code to source control are highlighted in Visual Studio. They can then be fixed even before reaching the source server.

As a consequence the Code Quality remains under control with no major upfront investment.

The screenshot below shows that a single click is enough to list for example all major issues introduced since the baseline, grouped by types.

▲▲ Go to Top ▲▲

Rules Files

Rule Files can be created and shared amongst NDepend projects. This is useful to define company-level standard rules sets shared amongts projects, and get them applied by all teams.

▲▲ Go to Top ▲▲

Rules Execution Options

Finally, in the form shown on progress circle hovering with mouse, there are 2 links Analysis Execution and Analysis Refresh in VS.
  • The option panel Analysis Refresh in VS let’s customize when an NDepend analysis should occurs.

  • The option panel Analysis Execution let’s finally customize the analysis process (incremental/full analysis, in/out process, report generation…).