Software Engineering Institute | Carnegie Mellon University
Software Engineering Institute | Carnegie Mellon University

Digital Library


Refactoring with Cognitive Complexity: The New Option for Measuring Understandability

  • May 2017
  • By G. Ann Campbell (SonarSource SA)
  • Cyclomatic complexity measures testability, not understandability. Learn how to use cognitive complexity in refactoring for simpler, more maintainable code.
  • Publisher: Software Engineering Institute
  • This presentation was created for a conference series or symposium and does not necessarily reflect the positions and views of the Software Engineering Institute.
  • Abstract

    For 40 years, cyclomatic complexity has been the de facto standard for measuring testability and maintainability. While it's absolutely accurate for testability, the same can't be said for maintainability. Cognitive complexity solves the problem and returns "fair" relative measurements of control flow complexity. In this session, you'll learn what the cognitive complexity methodology is and why you should add it to your metric suite. You’ll see how it applies to a number of code samples from open-source projects on And you'll learn how to use a method's cognitive complexity score as a guide to designing better code and refactoring existing code to be simpler and more maintainable. Because there's no "cost of entry," high class-level cognitive complexity is a reliable indicator that a class contains a lot of logic, not just a lot of methods. That is, you can use cognitive complexity to sift domain classes from the logic-intense classes that impose a higher maintenance burden. Cognitive complexity is already available as a new rule in some Sonar code analyzers and should be available throughout the SonarQube ecosystem by the end of 2017.

  • Download

Part of a Collection

SATURN 2017 Presentations