couve 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c6c4d593294316c9fe14a6a2d25d9029a5282c17ba53503a38b440c9b2c452f
-  data.tar.gz: bc384881652d204bc8e7cbb337beb019bd3a49db0e3e01955865ee49660791df
+  metadata.gz: 4f4a216f249b8b99c5faf04dfef0f043f41c935955c2e0f4beedffe1aae99032
+  data.tar.gz: 124582fed81b0b3197a5a34219829b5f222a798e0afea8c3dc74f2d7bbc9d93b
 SHA512:
-  metadata.gz: e90965ed10dd06d895bad918c452b5e9efeb6bc8d6b30ded117f3150c9fd1ddc51ff1e2cfbdaa4e3b28aa7bb186dc193632b6699ad0565849d38ac1f1b864272
-  data.tar.gz: d1665ba532efcc3ed7177daa9e3cd3b101775e2647000800100187dc98932fe0b9f6ca4f8d5e14e4a653b68abe77e6b2fad1e6c0c951fb3690c818843b23ad06
+  metadata.gz: 2e195aa5e380cc001ddb50475e3ee46c97e60b8b160363a9f72f2563a22daa6c216b9f60327998ffd12efcf7eab34a0966ddb71080126c12081c36d11cd1d4d3
+  data.tar.gz: 957caf172202bc89862cb4e68c69975b157010846246615bbc7e9477eb27004c55f80a61a196206aa2cbf99a66117bf066a1d0d47ed398a03fb1ba29fa13e0f2

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [0.9.0] - 2026-06-09
+
+- **Breaking:** raise the green threshold to 100%, so 🟢 now means the file is fully covered and `--fail-on-low-coverage` exits `1` for any reported file below 100% (previously 66.66%).
+- Rate files and evaluate the coverage gate on the unrounded percentage, so a file at e.g. 99.996% no longer rounds up to 100% and slips past the gate.
+- Display percentages with two decimal places in all cases (e.g. `60.00%`), flooring instead of rounding, so a partially covered file never displays as `100.00%`.
+
+## [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.9.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -46,15 +46,15 @@ $ couve path/to/coverage.json path/to/report.html   # HTML report
 $ couve path/to/coverage.json path/to/report.md      # Markdown report
 ```
 
-The Markdown report renders as a GitHub-flavored table, with a colored rating indicator (🔴/🟡/🟢) reflecting each file's coverage level:
+The Markdown report renders as a GitHub-flavored table, with a colored rating indicator reflecting each file's coverage level — 🔴 below 33.33%, 🟡 from there up to (but not including) 100%, and 🟢 only for fully covered files:
 
 ```markdown
 ## Coverage problems
 
 | Rating | Coverage | File | Not covered lines |
 | :---: | ---: | :--- | :--- |
-| 🔴 | 30% | app/models/foo.rb | 3, 8, 21 |
-| 🟡 | 50% | app/services/bar.rb | 5, 6 |
+| 🔴 | 30.00% | app/models/foo.rb | 3, 8, 21 |
+| 🟡 | 50.00% | app/services/bar.rb | 5, 6 |
 ```
 
 A typical CI setup keeps the HTML report as an artifact and posts the Markdown report to the pull request, e.g. with the GitHub CLI:
@@ -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 100% coverage, i.e. rated 🔴 or 🟡:
+
+```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 100% in app/models/foo.rb, app/services/bar.rb
+```
+
+The threshold is fixed at 100%; there is nothing to configure. Note that the default report only lists files below 100%, so project-wide the flag fails whenever the report is non-empty. In practice you'll want it together with `--changed-files`: when you only report the files you changed, only those files are evaluated, so a fully covered (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 = 100
+
     def initialize(coverage, changed_files: nil)
       @coverage = JSON.parse(coverage, symbolize_names: true)
 
@@ -46,8 +49,8 @@ module Couve
 
     def to_markdown
       rows = @coverage[:source_files].map do |source_file|
-        percentage = source_file[:covered_percent].round(2)
-        indicator = percentage_indicator(percentage)
+        percentage = format("%.2f", source_file[:covered_percent].floor(2))
+        indicator = percentage_indicator(source_file[:covered_percent])
 
         "| #{indicator} | #{percentage}% | #{source_file[:name]} | #{not_covered_lines(source_file)} |"
       end
@@ -61,6 +64,16 @@ module Couve
       MARKDOWN
     end
 
+    def low_coverage_files
+      @coverage[:source_files]
+        .select { |source_file| source_file[:covered_percent] < GREEN_THRESHOLD }
+        .map { |source_file| source_file[:name] }
+    end
+
+    def low_coverage?
+      low_coverage_files.any?
+    end
+
     private
 
     # rubocop:disable Metrics/MethodLength
@@ -69,8 +82,8 @@ module Couve
       html = ["<tbody>"]
 
       @coverage[:source_files].each do |source_file|
-        percentage = source_file[:covered_percent].round(2)
-        bg_color = percentage_bar_color(percentage)
+        percentage = format("%.2f", source_file[:covered_percent].floor(2))
+        bg_color = percentage_bar_color(source_file[:covered_percent])
 
         html << "  <tr>"
         html << "    <td class=\"col-1\">"
@@ -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.9.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,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: couve
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Cezinha
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-05 00:00:00.000000000 Z
+date: 2026-06-10 00:00:00.000000000 Z
 dependencies: []
 description:
 email: