churn_vs_complexity 1.6.2 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d0895177148a918e4aab91d71e25978c2f0429d8f46920851d3aee7eb8a9525
-  data.tar.gz: 32df8627394b7f85cdf7aa81093ba560bef79309efa10a606941f298e176bf34
+  metadata.gz: dbfecd03ad25cb8f79ae5b52564f591b122eab2b8ee13e3fe80d1d33883e2747
+  data.tar.gz: 4ba6ffb8794bb11c9e87103f26b481b9b6bb29230eb1c55fa7fff7c46aaa0687
 SHA512:
-  metadata.gz: 1bdb515d824ab01dcd9f279f072d430c9dbb5a386bde4c569e5821b63895eefb256e26d22c79f1da65c59e1c0508057487db5008155de946ea54652ca1947687
-  data.tar.gz: d3c5c601f54b852d5ed47d683e1e9c8d88526fce57191caab66f553c3326d9166008f3c409a7e1178535d290908b95f1780599af763c8bb1d995ff1117e38457
+  metadata.gz: c7463ac718037f9f8d13ba08d1c39b775557246f85bd3e29852ee573b1af55625026e792d239e3d38df118923f80b68d75243508f5dd98b6739bd1b80408fe20
+  data.tar.gz: 35358bac1704bc9bca9cb9204d053c3484d9aa5e4d1e378b0feb48e2236f014354494b8ddcd36d12d127865361add543f511e514bfa412d01f7b34f038fb1042

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [1.7.0] - 2026-04-05
+
+### Added
+- Kotlin support for complexity calculation (via [lizard](https://github.com/terryyin/lizard), install with `pip install lizard`)
+
 ## [1.6.2] - 2026-02-19
 
 ### Changed

data/CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-`churn_vs_complexity` is a Ruby gem that analyzes code quality by correlating file churn (how often files change) with complexity scores. It supports Ruby (via Flog), JavaScript/TypeScript (via ESLint), and Java (via PMD). Requires Ruby >= 3.3.
+`churn_vs_complexity` is a Ruby gem that analyzes code quality by correlating file churn (how often files change) with complexity scores. It supports Ruby (via Flog), JavaScript/TypeScript (via ESLint), Java (via PMD), Python (via Radon), Go (via gocognit), and Kotlin (via lizard). Requires Ruby >= 3.3.
 
 ## Commands
 

data/README.md

@@ -2,7 +2,7 @@
 
 # ChurnVsComplexity
 
-Correlates file churn (how often files change) with complexity scores to identify refactoring hotspots and track codebase health over time. Supports Ruby, JavaScript/TypeScript, Java, Python, and Go.
+Correlates file churn (how often files change) with complexity scores to identify refactoring hotspots and track codebase health over time. Supports Ruby, JavaScript/TypeScript, Java, Python, Go, and Kotlin.
 
 Modes include hotspots ranking, triage assessment, CI quality gate, diff comparison, focus sessions, and timetravel history.
 
@@ -33,6 +33,7 @@ External tool dependencies per language:
 - **JavaScript/TypeScript**: Requires [Node.js](https://nodejs.org) (uses ESLint internally).
 - **Python**: Requires [Radon](https://radon.readthedocs.io) on the search path as `radon`. Install with `pip install radon`.
 - **Go**: Requires [gocyclo](https://github.com/fzipp/gocyclo) on the search path. Install with `go install github.com/fzipp/gocyclo/cmd/gocyclo@latest`.
+- **Kotlin**: Requires [lizard](https://github.com/terryyin/lizard) on the search path. Install with `pip install lizard`.
 
 ## Usage
 
@@ -48,6 +49,7 @@ Languages:
                                      Check complexity of javascript and typescript files
         --python                     Check complexity of python files
         --go                         Check complexity of go files
+        --kotlin                     Check complexity of kotlin files
 
 Modes (mutually exclusive):
         --timetravel N               Calculate summary for all commits at intervals of N days throughout project history or from the date specified with --since
@@ -121,6 +123,9 @@ churn_vs_complexity --java -m --since 2019-03-01 --timetravel 30 --graph my_java
 
 # Analyse complexity of specific commits
 churn_vs_complexity --js --delta HEAD --summary my_js_project
+
+# Kotlin project hotspots
+churn_vs_complexity --kotlin --hotspots my_kotlin_project
 ```
 
 ## Development

data/lib/churn_vs_complexity/cli/parser.rb

@@ -34,6 +34,10 @@ module ChurnVsComplexity
             options[:language] = :go
           end
 
+          opts.on('--kotlin', 'Check complexity of kotlin files') do
+            options[:language] = :kotlin
+          end
+
           opts.separator ''
           opts.separator 'Modes (mutually exclusive):'
 

data/lib/churn_vs_complexity/complexity/kotlin_calculator.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module ChurnVsComplexity
+  module Complexity
+    module KotlinCalculator
+      class << self
+        attr_writer :command_runner
+
+        def folder_based? = false
+
+        def calculate(files:)
+          csv_output = run_lizard(files)
+          parse_lizard_output(csv_output, files:)
+        end
+
+        # Lizard CSV format: NLOC,CCN,tokens,params,length,"loc","file","func","long_func",start,end
+        LIZARD_LINE_PATTERN = /^\d+,(\d+),\d+,\d+,\d+,"[^"]*","([^"]*)"/.freeze
+
+        def parse_lizard_output(csv_output, files:)
+          scores = Hash.new(0)
+          csv_output.each_line do |line|
+            match = line.match(LIZARD_LINE_PATTERN)
+            next unless match
+
+            scores[match[2]] += match[1].to_i
+          end
+          files.to_h { |file| [file, scores[file] || 0] }
+        end
+
+        def check_dependencies!
+          command_runner.call('lizard --version 2>&1')
+        rescue Errno::ENOENT
+          raise Error, 'Needs lizard installed (pip install lizard)'
+        end
+
+        private
+
+        def command_runner
+          @command_runner || Open3.method(:capture2)
+        end
+
+        def run_lizard(files)
+          files_arg = files.map { |f| "'#{f}'" }.join(' ')
+          stdout, status = command_runner.call("lizard --csv #{files_arg}")
+          raise Error, "lizard failed (exit #{status.exitstatus}). Is it installed?" unless status.success?
+
+          stdout
+        end
+      end
+    end
+  end
+end

data/lib/churn_vs_complexity/complexity.rb

@@ -5,6 +5,7 @@ require_relative 'complexity/flog_calculator'
 require_relative 'complexity/eslint_calculator'
 require_relative 'complexity/python_calculator'
 require_relative 'complexity/go_calculator'
+require_relative 'complexity/kotlin_calculator'
 
 module ChurnVsComplexity
   module Complexity

data/lib/churn_vs_complexity/complexity_validator.rb

@@ -12,6 +12,8 @@ module ChurnVsComplexity
         Complexity::PythonCalculator.check_dependencies!
       when :go
         Complexity::GoCalculator.check_dependencies!
+      when :kotlin
+        Complexity::KotlinCalculator.check_dependencies!
       end
     end
   end

data/lib/churn_vs_complexity/delta.rb

@@ -38,6 +38,8 @@ module ChurnVsComplexity
           FileSelector::Python.predefined(included:, excluded:)
         when :go
           FileSelector::Go.predefined(included:, excluded:)
+        when :kotlin
+          FileSelector::Kotlin.predefined(included:, excluded:)
         end
       end
 
@@ -53,6 +55,8 @@ module ChurnVsComplexity
           Complexity::PythonCalculator
         when :go
           Complexity::GoCalculator
+        when :kotlin
+          Complexity::KotlinCalculator
         end
       end
     end

data/lib/churn_vs_complexity/file_selector.rb

@@ -14,6 +14,8 @@ module ChurnVsComplexity
         ['.py']
       when :go
         ['.go']
+      when :kotlin
+        ['.kt', '.kts']
       else
         raise Error, "Unsupported language: #{language}"
       end
@@ -130,5 +132,15 @@ module ChurnVsComplexity
         Predefined.new(included:, extensions: FileSelector.extensions(:go), excluded:)
       end
     end
+
+    module Kotlin
+      def self.excluding(excluded)
+        Excluding.new(FileSelector.extensions(:kotlin), excluded)
+      end
+
+      def self.predefined(included:, excluded:)
+        Predefined.new(included:, extensions: FileSelector.extensions(:kotlin), excluded:)
+      end
+    end
   end
 end

data/lib/churn_vs_complexity/language_validator.rb

@@ -2,7 +2,7 @@
 
 module ChurnVsComplexity
   module LanguageValidator
-    SUPPORTED = %i[java ruby javascript python go].freeze
+    SUPPORTED = %i[java ruby javascript python go kotlin].freeze
 
     def self.validate!(language)
       raise ValidationError, "Unsupported language: #{language}" unless SUPPORTED.include?(language)

data/lib/churn_vs_complexity/normal/config.rb

@@ -75,6 +75,14 @@ module ChurnVsComplexity
             serializer:,
             since: @since || @relative_period,
           )
+        when :kotlin
+          Engine.concurrent(
+            complexity: Complexity::KotlinCalculator,
+            churn:,
+            file_selector: FileSelector::Kotlin.excluding(@excluded),
+            serializer:,
+            since: @since || @relative_period,
+          )
         end
       end
 

data/lib/churn_vs_complexity/risk_classifier.rb

@@ -14,6 +14,7 @@ module ChurnVsComplexity
   #   Python         Radon     Cyclomatic complexity  1        ~44                 5-50
   #   Java           PMD       Cyclomatic complexity  1        ~39                 1-40
   #   Go             gocognit  Cognitive complexity   0        ~87                 0-50
+  #   Kotlin         lizard    Cyclomatic complexity  1        ~40                 1-40
   #
   # The DEFAULT_LOW and DEFAULT_HIGH thresholds below are rough midpoints
   # suitable for Java/Python/JS. They are too aggressive for Ruby (Flog

data/lib/churn_vs_complexity/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ChurnVsComplexity
-  VERSION = '1.6.2'
+  VERSION = '1.7.0'
 end

data/tmp/test-support/kotlin/Main.kt

@@ -0,0 +1,7 @@
+fun main() {
+    println("Hello, world!")
+}
+
+fun add(a: Int, b: Int): Int {
+    return a + b
+}

data/tmp/test-support/kotlin/Utils.kt

@@ -0,0 +1,11 @@
+fun calculateSum(numbers: List<Int>): Int {
+    var total = 0
+    for (n in numbers) {
+        total += n
+    }
+    return total
+}
+
+fun isEven(n: Int): Boolean {
+    return n % 2 == 0
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: churn_vs_complexity
 version: !ruby/object:Gem::Version
-  version: 1.6.2
+  version: 1.7.0
 platform: ruby
 authors:
 - Erik T. Madsen
@@ -39,8 +39,8 @@ dependencies:
         version: '2.1'
 description: Correlates file churn (how often files change) with complexity scores
   to identify refactoring hotspots. Supports Ruby, JavaScript/TypeScript, Java, Python,
-  and Go. Modes include hotspots ranking, triage assessment, CI quality gate, diff
-  comparison, focus sessions, and timetravel history. Inspired by Michael Feathers'
+  Go, and Kotlin. Modes include hotspots ranking, triage assessment, CI quality gate,
+  diff comparison, focus sessions, and timetravel history. Inspired by Michael Feathers'
   article "Getting Empirical about Refactoring".
 email:
 - beatmadsen@gmail.com
@@ -69,6 +69,7 @@ files:
 - lib/churn_vs_complexity/complexity/eslint_calculator.rb
 - lib/churn_vs_complexity/complexity/flog_calculator.rb
 - lib/churn_vs_complexity/complexity/go_calculator.rb
+- lib/churn_vs_complexity/complexity/kotlin_calculator.rb
 - lib/churn_vs_complexity/complexity/pmd.rb
 - lib/churn_vs_complexity/complexity/pmd/files_calculator.rb
 - lib/churn_vs_complexity/complexity/pmd/folder_calculator.rb
@@ -145,6 +146,8 @@ files:
 - tmp/test-support/javascript/moderate.js
 - tmp/test-support/javascript/simple.js
 - tmp/test-support/javascript/typescript-example.ts
+- tmp/test-support/kotlin/Main.kt
+- tmp/test-support/kotlin/Utils.kt
 - tmp/test-support/python/example.py
 - tmp/test-support/python/utils.py
 - tmp/test-support/txt/abc.txt
@@ -179,7 +182,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Analyse churn vs complexity to find refactoring hotspots, gate CI quality,
   triage risky files, and track codebase health over time.