couve 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c6c4d593294316c9fe14a6a2d25d9029a5282c17ba53503a38b440c9b2c452f
-  data.tar.gz: bc384881652d204bc8e7cbb337beb019bd3a49db0e3e01955865ee49660791df
+  metadata.gz: 6733bb77b61c6eeb3d8154eb7dc8e04afdae265464983866b237c7474198612a
+  data.tar.gz: 2418be05c9acbf968ac32019ef0d86918b117b68a9f77719d4295e88c074188c
 SHA512:
-  metadata.gz: e90965ed10dd06d895bad918c452b5e9efeb6bc8d6b30ded117f3150c9fd1ddc51ff1e2cfbdaa4e3b28aa7bb186dc193632b6699ad0565849d38ac1f1b864272
-  data.tar.gz: d1665ba532efcc3ed7177daa9e3cd3b101775e2647000800100187dc98932fe0b9f6ca4f8d5e14e4a653b68abe77e6b2fad1e6c0c951fb3690c818843b23ad06
+  metadata.gz: 819b2d0c9f768011eb37641ac59a7ac94077222071e867a4a1a50cc51a6ece7bf4028bac072463551e266940e0d12d6b0ce72b15e76070f651a05bef5f4e0257
+  data.tar.gz: 9f4cb0dc81003cacd9df9a4702e4d4bc4b4950747d84a1c28ca7c7783241cd3b823e1589a873da0b792123527bf2b8a90c0f08dec66019f6821a6256c8585d42

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.8.0] - 2026-06-05
+
+- Add `--fail-on-low-coverage` flag to exit with a non-zero status when any reported file is below 100% coverage.
+
 ## [0.7.0] - 2026-06-05
 
 - Add `--changed-files` to report the coverage status of a given list of files (e.g. a branch's changed files), including fully covered ones, instead of the project-wide below-100% view.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    couve (0.7.0)
+    couve (0.8.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -81,6 +81,27 @@ git diff --name-only origin/main...HEAD | couve coverage.json report.md --change
 
 Only files that appear both in the list and in the coverage data are shown; the rest of the project is left out. Coverage is still reported per file (the whole file's percentage and missed lines), not just the lines in your diff.
 
+### Failing the build on low coverage
+
+By default couve always exits `0` — it only generates the report. Pass `--fail-on-low-coverage` to make couve exit `1` when any **reported** file is below the green threshold, i.e. rated 🔴 or 🟡 (`< 66.66%`):
+
+```sh
+couve coverage.json report.md --fail-on-low-coverage
+```
+
+The report is written **before** couve exits, so the offending files stay visible in the report (and in any PR comment built from it). The offending files are also printed to standard error:
+
+```
+couve: coverage below 66.66% in app/models/foo.rb, app/services/bar.rb
+```
+
+The threshold is the same fixed band used for the rating indicators; there is nothing to configure. The flag respects `--changed-files` scope: when you only report the files you changed, only those files are evaluated, so a green (or empty) changed-file set passes the build even if untouched files elsewhere are poorly covered.
+
+```sh
+# Post the report to the PR, then redden the build if a changed file is under-covered:
+git diff --name-only origin/main...HEAD | couve coverage.json report.md --changed-files - --fail-on-low-coverage
+```
+
 ## Development
 
 To contribute to Couve's development, follow these steps:

data/lib/couve/parser.rb

@@ -3,7 +3,10 @@
 require "json"
 
 module Couve
-  class Parser
+  class Parser # rubocop:disable Metrics/ClassLength
+    RED_THRESHOLD = 33.33
+    GREEN_THRESHOLD = 66.66
+
     def initialize(coverage, changed_files: nil)
       @coverage = JSON.parse(coverage, symbolize_names: true)
 
@@ -61,6 +64,16 @@ module Couve
       MARKDOWN
     end
 
+    def low_coverage_files
+      @coverage[:source_files]
+        .select { |source_file| source_file[:covered_percent].round(2) < GREEN_THRESHOLD }
+        .map { |source_file| source_file[:name] }
+    end
+
+    def low_coverage?
+      low_coverage_files.any?
+    end
+
     private
 
     # rubocop:disable Metrics/MethodLength
@@ -98,9 +111,9 @@ module Couve
     # rubocop:enable Metrics/MethodLength
 
     def percentage_bar_color(percentage)
-      if percentage < 33.33
+      if percentage < RED_THRESHOLD
         "bg-danger"
-      elsif percentage < 66.66
+      elsif percentage < GREEN_THRESHOLD
         "bg-warning"
       else
         "bg-success"
@@ -108,9 +121,9 @@ module Couve
     end
 
     def percentage_indicator(percentage)
-      if percentage < 33.33
+      if percentage < RED_THRESHOLD
         "🔴"
-      elsif percentage < 66.66
+      elsif percentage < GREEN_THRESHOLD
         "🟡"
       else
         "🟢"

data/lib/couve/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Couve
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

data/lib/couve.rb

@@ -7,7 +7,7 @@ require_relative "couve/parser"
 
 module Couve
   def self.start(argv = ARGV)
-    coverage_file, output_file, changed_files_source = parse_arguments(argv)
+    coverage_file, output_file, changed_files_source, fail_on_low_coverage = parse_arguments(argv)
 
     coverage = File.read(coverage_file)
     parser = Couve::Parser.new(coverage, changed_files: changed_files(changed_files_source))
@@ -15,19 +15,30 @@ module Couve
     report = output_file.end_with?(".md") ? parser.to_markdown : parser.to_html
 
     File.open(output_file, "w") { |f| f.puts report }
+
+    return unless fail_on_low_coverage && parser.low_coverage?
+
+    warn "couve: coverage below #{Couve::Parser::GREEN_THRESHOLD}% in #{parser.low_coverage_files.join(", ")}"
+    exit 1
   end
 
-  def self.parse_arguments(argv)
+  def self.parse_arguments(argv) # rubocop:disable Metrics/MethodLength
     argv = argv.dup
     changed_files_source = nil
+    fail_on_low_coverage = false
 
     OptionParser.new do |opts|
       opts.on("--changed-files PATH", "Only report the files listed in PATH (use - for stdin)") do |path|
         changed_files_source = path
       end
+
+      opts.on("--fail-on-low-coverage",
+              "Exit 1 if any reported file is below #{Couve::Parser::GREEN_THRESHOLD}% coverage") do
+        fail_on_low_coverage = true
+      end
     end.parse!(argv)
 
-    [argv[0], argv[1], changed_files_source]
+    [argv[0], argv[1], changed_files_source, fail_on_low_coverage]
   end
 
   def self.changed_files(source)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: couve
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Cezinha
@@ -32,7 +32,6 @@ files:
 - bin/guard
 - bin/rubocop
 - bin/setup
-- couve.gemspec
 - exe/couve
 - lib/couve.rb
 - lib/couve/parser.rb

data/couve.gemspec

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/couve/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "couve"
-  spec.version = Couve::VERSION
-  spec.authors = ["Cezinha"]
-  spec.email = ["cesar@asseinfo.com.br"]
-  spec.metadata = { "rubygems_mfa_required" => "true" }
-
-  spec.summary = "Generate a human readable report for CodeClimate test-reporter gem."
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib", "lib/couve"]
-  spec.required_ruby_version = ">= 3"
-
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
-
-  # For more information and examples about making a new gem, checkout our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end