judges 0.55.0 → 0.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb2df3f4875124734e1fc6698c45a9bae82e187a73ae6632bc31906ec8039452
-  data.tar.gz: 14639995b236e8f4ce02fb794b4050b9fc578a1816e09510312f78c3811a09da
+  metadata.gz: 25236f211b356d3dfe62fd6ba9eb7eb70a04e2de64d2581d682db989967cefa9
+  data.tar.gz: c804cf366c81db1834496d71852422dbb245edfc76f0a24511621a4aa7979ada
 SHA512:
-  metadata.gz: f0b6906cfe65ed01d7d7d3af2677ba45fb6dc875060bcad82d055c18ceccc69973d510a7448748caf1f1bc01680d68fabbe9a223294b0707ddf721a2e1b66d3e
-  data.tar.gz: 7d92dfe3ea479bfef86366efe451ed415bb8a54d6c8fe9cddb99348408975282dee4e061b7b89c988221177eefecc3b8a228fb3bb08710a2d34c8004403f6a78
+  metadata.gz: 1c33f8ae0312222d0ae2ec848d031648fc5f04cb2a64d49e63a26176157a2d9e82bb2fa1f8e010aa0fe8a482fe16690145bdca92f367f05afa851687a18f09af
+  data.tar.gz: 6bfafca7127eca496160d7b57325e92815ced1872da8f929380aa0fee185d5f3931cdf5eb753d39a3c68c9c19800a2cfa100b99da60288d9dbae33ccb9680309

data/Gemfile.lock

@@ -78,8 +78,9 @@ GEM
       loog (~> 0.6)
       tago (~> 0.1)
     ellipsized (0.3.0)
-    ethon (0.17.0)
+    ethon (0.18.0)
       ffi (>= 1.15.0)
+      logger
     factbase (0.16.8)
       backtrace (~> 0.4)
       decoor (~> 0.1)
@@ -99,8 +100,8 @@ GEM
       faraday (>= 0.8)
     faraday-multipart (1.1.1)
       multipart-post (~> 2.0)
-    faraday-net_http (3.4.1)
-      net-http (>= 0.5.0)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
     faraday-retry (2.3.2)
       faraday (~> 2.0)
     ffi (1.17.2-aarch64-linux-gnu)
@@ -116,7 +117,7 @@ GEM
       ostruct
     hashdiff (1.2.1)
     iri (0.11.2)
-    json (2.15.1)
+    json (2.16.0)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
@@ -124,7 +125,7 @@ GEM
       logger (~> 1.0)
     memoist3 (1.0.0)
     mini_mime (1.1.5)
-    minitest (5.26.0)
+    minitest (5.26.1)
     minitest-reporters (1.7.1)
       ansi
       builder
@@ -135,7 +136,7 @@ GEM
     moments (0.3.0)
     multi_test (1.1.0)
     multipart-post (2.4.1)
-    net-http (0.6.0)
+    net-http (0.7.0)
       uri
     nokogiri (1.18.10-aarch64-linux-gnu)
       racc (~> 1.4)
@@ -161,25 +162,25 @@ GEM
     ostruct (0.6.3)
     others (0.1.1)
     parallel (1.27.0)
-    parser (3.3.9.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
     prism (1.6.0)
     public_suffix (6.0.2)
-    qbash (0.4.5)
+    qbash (0.4.7)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
       tago (> 0)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.0)
+    rake (13.3.1)
     random-port (0.7.6)
       tago (~> 0.0)
     regexp_parser (2.11.3)
     retries (0.0.5)
     rexml (3.4.4)
-    rubocop (1.81.6)
+    rubocop (1.81.7)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -190,7 +191,7 @@ GEM
       rubocop-ast (>= 1.47.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.47.1)
+    rubocop-ast (1.48.0)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
     rubocop-minitest (0.38.2)
@@ -217,20 +218,20 @@ GEM
     sys-uname (1.4.1)
       ffi (~> 1.1)
       memoist3 (~> 1.0.0)
-    tago (0.3.0)
-    timeout (0.4.3)
+    tago (0.4.0)
+    timeout (0.4.4)
     total (0.4.1)
     typhoeus (1.4.1)
       ethon (>= 0.9.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.1.0)
-    uri (1.0.4)
+    uri (1.1.1)
     w3c_validators (1.3.7)
       json (>= 1.8)
       nokogiri (~> 1.6)
       rexml (~> 3.2)
-    webmock (3.25.1)
+    webmock (3.26.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)

data/README.md

@@ -20,10 +20,10 @@ of `.yml` files. A script in the Ruby file is executed with the following
 global variables available to it:
 
 * `$fb` — an instance
-  of [`Factbase`](https://www.rubydoc.info/gems/factbase/0.0.22/Factbase),
+  of [Factbase](https://www.rubydoc.info/gems/factbase/0.0.22/Factbase),
   where facts may be added/updated;
 * `$loog` — an instance
-  of [`Loog`](https://www.rubydoc.info/gems/loog/0.5.1/Loog),
+  of [Loog](https://www.rubydoc.info/gems/loog/0.5.1/Loog),
   where `.info` and `.debug` logs are welcome;
 * `$options` — a holder of options coming from either the `--option` command
   line flag or the `.yml` file during testing;

data/Rakefile

@@ -56,6 +56,7 @@ require 'yard'
 desc 'Build Yard documentation'
 YARD::Rake::YardocTask.new do |t|
   t.files = ['lib/**/*.rb']
+  t.options = ['--fail-on-warning']
 end
 
 require 'rubocop/rake_task'

data/bin/judges

@@ -13,6 +13,7 @@ require 'tago'
 require 'time'
 require 'total'
 require_relative '../lib/judges'
+require_relative '../lib/judges/ascii_loog'
 
 Encoding.default_external = Encoding::UTF_8
 Encoding.default_internal = Encoding::UTF_8
@@ -57,11 +58,16 @@ class JudgesGLI extend GLI::App
   switch([:echo])
   desc 'Stay strictly offline, never attempt to reach Internet resources'
   switch([:offline])
+  desc 'Suppress all Unicode symbols in the output'
+  switch([:ascii])
 
   pre do |global, command, options, args|
     if global[:verbose]
       @@loog = Loog::VERBOSE
     end
+    if global[:ascii]
+      @@loog = Judges::AsciiLoog.new(@@loog)
+    end
     if global[:echo]
       @@loog.info("+ #{File.absolute_path($0)} #{@@args.join(' ')}")
     end
@@ -73,15 +79,20 @@ class JudgesGLI extend GLI::App
     end
     require 'factbase'
     if global[:hello]
-      [
+      info = [
         "Judges #{Judges::VERSION}",
         "Factbase #{Factbase::VERSION}",
         "Baza-rb #{BazaRb::VERSION}",
         "Ruby: #{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}",
         "Current directory: #{Dir.getwd}",
-        "Time: #{Time.now.utc.iso8601}",
-        "Total memory: #{Total::Mem.new.bytes / (1024 * 1024)}Mb"
-      ].each { |m| @@loog.info(m) }
+        "Time: #{Time.now.utc.iso8601}"
+      ]
+      begin
+        info << "Total memory: #{Total::Mem.new.bytes / (1024 * 1024)}Mb"
+      rescue Total::CantDetect => e
+        @@loog.debug("Can't detect memory: #{e.message}")
+      end
+      info.each { |m| @@loog.info(m) }
     end
     true
   end
@@ -94,6 +105,7 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Update the factbase by executing all judges sequentially'
+  arg_name '<dir> <factbase>'
   command :update do |c|
     c.desc 'Options to pass to each judge'
     c.flag([:o, :option], multiple: true, arg_name: '<key=value>')
@@ -123,12 +135,15 @@ class JudgesGLI extend GLI::App
     c.flag([:summary], must_match: %w[off add append], default_value: 'off')
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
+    c.desc 'Show execution statistics for each judge'
+    c.switch([:statistics], default_value: false)
     c.desc 'Expect at least one judge to be used (fail if none are used)'
     c.switch([:'expect-judges'], default_value: true)
     run_it(c, 'update')
   end
 
   desc 'Evaluate a single Ruby expression against the factbase'
+  arg_name '<factbase> <expression>'
   command :eval do |c|
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
@@ -136,11 +151,13 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Join two factbases'
+  arg_name '<first> <second>'
   command :join do |c|
     run_it(c, 'join')
   end
 
   desc 'Import YAML into a factbase'
+  arg_name '<factbase> <yaml>'
   command :import do |c|
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
@@ -148,6 +165,7 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Remove outdated facts from the factbase'
+  arg_name 'factbase'
   command :trim do |c|
     c.desc 'Delete only facts matching the specified expression'
     c.flag([:query], default_value: '(never)')
@@ -155,6 +173,7 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Convert the factbase to a human-readable format (YAML, JSON, etc.)'
+  arg_name '<factbase> [<output>]'
   command :print do |c|
     c.desc 'Output format (xml, json, or yaml)'
     c.flag([:format], default_value: 'yaml')
@@ -174,11 +193,13 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Inspect the factbase and display all available metadata'
+  arg_name '<factbase>'
   command :inspect do |c|
     run_it(c, 'inspect')
   end
 
   desc 'Run automated tests for all judges'
+  arg_name '<dir>'
   command :test do |c|
     c.desc 'Options to pass to each judge (may be overridden by YAML)'
     c.flag([:o, :option], multiple: true, arg_name: '<key=value>')
@@ -200,6 +221,7 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Push the factbase to the server and unlock it remotely'
+  arg_name '<name> <factbase>'
   command :push do |c|
     c.desc 'Authentication token'
     c.flag([:token])
@@ -223,6 +245,7 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Pull the factbase from the server and lock it remotely'
+  arg_name '<name> <factbase>'
   command :pull do |c|
     c.desc 'Authentication token'
     c.flag([:token])
@@ -244,6 +267,7 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Download a durable from the server by ID'
+  arg_name '<id> <factbase>'
   command :download do |c|
     c.desc 'Authentication token'
     c.flag([:token])
@@ -263,6 +287,7 @@ class JudgesGLI extend GLI::App
   end
 
   desc 'Upload a file as a durable to the server'
+  arg_name '<file> <path>'
   command :upload do |c|
     c.desc 'Authentication token'
     c.flag([:token])

data/features/update.feature

@@ -55,14 +55,14 @@ Feature: Update
     """
       n = $fb.insert
       n.type = 'first'
-      sleep 1.9
+      sleep 1.91
     """
     Then I have a "second/second.rb" file with content:
     """
       n = $fb.insert
       n.type = 'second'
     """
-    Then I run bin/judges with "--verbose update --quiet --lifetime 2 --timeout 1 --max-cycles 5 . simple.fb"
+    Then I run bin/judges with "--verbose update --quiet --lifetime 4 --timeout 3 --max-cycles 5 . simple.fb"
     Then Stdout contains "Update completed in 2 cycle(s), did 3i/0d/3a"
     And Exit code is zero
 
@@ -214,3 +214,44 @@ Feature: Update
     Then Stdout contains "Running delayed"
     Then Stdout contains "3 judge(s) processed"
     And Exit code is zero
+
+  Scenario: Show statistics for judge execution
+    Given I make a temp directory
+    Then I have a "alpha/alpha.rb" file with content:
+    """
+      $fb.insert.name = 'alpha'
+    """
+    Then I have a "beta/beta.rb" file with content:
+    """
+      $fb.insert.name = 'beta'
+    """
+    Then I run bin/judges with "update --statistics --quiet --max-cycles 1 . stats.fb"
+    Then Stdout contains "Judge execution summary:"
+    Then Stdout contains "Judge"
+    Then Stdout contains "Seconds"
+    Then Stdout contains "Changes"
+    Then Stdout contains "Cycles"
+    Then Stdout contains "Result"
+    Then Stdout contains "alpha"
+    Then Stdout contains "beta"
+    Then Stdout contains "OK"
+    And Exit code is zero
+
+  Scenario: Summarize results in statistics
+    Given I make a temp directory
+    Then I have a "alpha/alpha.rb" file with content:
+    """
+      $fb.insert.name = 'alpha'
+      sleep 1.91
+    """
+    Then I have a "beta/beta.rb" file with content:
+    """
+      $fb.insert.name = 'beta'
+    """
+    Then I run bin/judges with "update --statistics --quiet --max-cycles 2 --lifetime 4 --timeout 3 . stats.fb"
+    Then Stdout contains "Judge execution summary:"
+    Then Stdout contains "alpha"
+    Then Stdout contains "beta"
+    Then Stdout contains "1xOK"
+    Then Stdout contains "1xSKIPPED (timeout)"
+    And Exit code is zero

data/judges.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=3.2'
   s.name = 'judges'
-  s.version = '0.55.0'
+  s.version = '0.57.0'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
   s.description =

data/lib/judges/ascii_loog.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require_relative '../judges'
+
+# ASCII wrapper for Loog logging facility.
+#
+# This class wraps any Loog logger and converts Unicode symbols to ASCII
+# equivalents when the --ascii option is enabled.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# License:: MIT
+class Judges::AsciiLoog
+  # Unicode to ASCII symbol mapping
+  UNICODE_TO_ASCII = {
+    '👍' => '+',
+    '👎' => '-',
+    '❌' => '!',
+    '👉' => '>',
+    '✓' => '+',
+    '✗' => '!',
+    '►' => '>',
+    '◄' => '<',
+    '▼' => 'v',
+    '▲' => '^'
+  }.freeze
+
+  # Initialize the ASCII wrapper.
+  # @param [Loog] loog The original logging facility to wrap
+  def initialize(loog)
+    @loog = loog
+  end
+
+  # Convert Unicode symbols to ASCII equivalents.
+  # @param [String] message The message to convert
+  # @return [String] The converted message with ASCII symbols
+  def to_ascii(message)
+    result = message.to_s
+    UNICODE_TO_ASCII.each do |unicode, ascii|
+      result = result.gsub(unicode, ascii)
+    end
+    result
+  end
+
+  # Log an info message, converting Unicode to ASCII.
+  # @param [String] message The message to log
+  def info(message)
+    @loog.info(to_ascii(message))
+  end
+
+  # Log a warning message, converting Unicode to ASCII.
+  # @param [String] message The message to log
+  def warn(message)
+    @loog.warn(to_ascii(message))
+  end
+
+  # Log an error message, converting Unicode to ASCII.
+  # @param [String] message The message to log
+  def error(message)
+    @loog.error(to_ascii(message))
+  end
+
+  # Log a debug message, converting Unicode to ASCII.
+  # @param [String] message The message to log
+  def debug(message)
+    @loog.debug(to_ascii(message))
+  end
+
+  # Delegate all other methods to the original logger.
+  def method_missing(method, *, &)
+    @loog.send(method, *, &)
+  end
+
+  # Check if the original logger responds to a method.
+  def respond_to_missing?(method, include_private = false)
+    @loog.respond_to?(method, include_private) || super
+  end
+end

data/lib/judges/commands/update.rb

@@ -16,6 +16,7 @@ require_relative '../../judges'
 require_relative '../../judges/impex'
 require_relative '../../judges/judges'
 require_relative '../../judges/options'
+require_relative '../../judges/statistics'
 require_relative '../../judges/to_rel'
 
 # The +update+ command.
@@ -88,6 +89,7 @@ class Judges::Update
     c = 0
     churn = Factbase::Churn.new
     errors = []
+    statistics = opts['statistics'] ? Judges::Statistics.new : nil
     sum = fb.query('(eq what "judges-summary")').each.to_a
     if sum.empty?
       @loog.info('Summary fact not found') unless opts['summary'] == 'off'
@@ -108,7 +110,7 @@ class Judges::Update
           end
           @loog.info("\nStarting cycle ##{c}#{" (out of #{opts['max-cycles']})" if opts['max-cycles']}...")
         end
-        delta = cycle(opts, judges, fb, options, errors)
+        delta = cycle(opts, judges, fb, options, errors, statistics)
         churn += delta
         impex.export(fb)
         if delta.zero?
@@ -127,6 +129,7 @@ class Judges::Update
       end
       throw :"👍 Update completed in #{c} cycle(s), did #{churn}"
     end
+    statistics&.report(@loog)
     return unless %w[add append].include?(opts['summary'])
     summarize(fb, churn, errors, c)
     impex.export(fb)
@@ -172,9 +175,10 @@ class Judges::Update
   # @param [Factbase] fb The factbase
   # @param [Judges::Options] options The options
   # @param [Array<String>] errors List of errors
+  # @param [Judges::Statistics] statistics Statistics tracking object (optional)
   # @return [Factbase::Churn] How many modifications have been made
-  def cycle(opts, judges, fb, options, errors)
-    churn = Factbase::Churn.new
+  def cycle(opts, judges, fb, options, errors, statistics = nil)
+    delta = Factbase::Churn.new
     global = {}
     used = 0
     elapsed(@loog, level: Logger::INFO) do
@@ -182,27 +186,35 @@ class Judges::Update
         judges.each_with_index do |judge, i|
           if opts['fail-fast'] && !errors.empty?
             @loog.info("Not running #{judge.name.inspect} due to #{errors.count} errors above, in --fail-fast mode")
+            statistics&.record(judge.name, 0, 'SKIPPED (fail-fast)') if include?(opts, judge.name)
             next
           end
           if opts['lifetime'] && opts['timeout']
             remained = @start + opts['lifetime'] - Time.now
-            if remained < opts['timeout'] / 16
+            if remained < opts['timeout'].to_f / 16
               @loog.info("Not running #{judge.name.inspect}, not enough time left (just #{remained.seconds})")
+              statistics&.record(judge.name, 0, 'SKIPPED (timeout)') if include?(opts, judge.name)
               next
             end
           end
           next unless include?(opts, judge.name)
           @loog.info("\n👉 Running #{judge.name} (##{i}) at #{judge.dir.to_rel} (#{@start.ago} already)...")
           used += 1
+          start_time = Time.now
+          result = 'OK'
+          impact = nil
           elapsed(@loog, level: Logger::INFO) do
-            c = one_judge(opts, fb, judge, global, options, errors)
-            churn += c
-            throw :"👍 The '#{judge.name}' judge made zero changes to #{fb.size} facts" if c.zero?
-            throw :"👍 The '#{judge.name}' judge #{c} out of #{fb.size} facts"
+            impact = one_judge(opts, fb, judge, global, options, errors)
+            delta += impact
+            throw :"👍 The '#{judge.name}' judge made zero changes to #{fb.size} facts" if impact.zero?
+            throw :"👍 The '#{judge.name}' judge #{impact} out of #{fb.size} facts"
           end
         rescue StandardError, SyntaxError => e
           @loog.warn(Backtrace.new(e))
           errors << e.message
+          result = 'ERROR'
+        ensure
+          statistics&.record(judge.name, Time.now - start_time, result, impact) if start_time
         end
       throw :"👍 #{done} judge(s) processed" if errors.empty?
       throw :"❌ #{done} judge(s) processed with #{errors.size} errors"
@@ -215,7 +227,7 @@ class Judges::Update
       raise "Failed to update correctly (#{errors.size} errors)" unless opts['quiet']
       @loog.info('Not failing because of the --quiet flag provided')
     end
-    churn
+    delta
   end
 
   # Run a single judge.

data/lib/judges/commands/upload.rb

@@ -45,10 +45,15 @@ class Judges::Upload
       id = baza.durable_find(jname, name)
       size = File.size(path)
       if id.nil? || id.to_s.strip.empty?
-        Tempfile.create do |f|
+        f = Tempfile.new('placeholder')
+        begin
           File.write(f.path, 'placeholder')
+          f.close
           id = baza.durable_place(jname, f.path)
           @loog.info("Placed a placeholder to new durable '#{name}' in '#{jname}' (ID: #{id})")
+        ensure
+          f.close unless f.closed?
+          f.unlink
         end
       end
       id = id.to_i

data/lib/judges/options.rb

@@ -144,8 +144,11 @@ class Judges::Options
   # Method names are automatically converted to uppercase symbols to match
   # the keys in the options hash.
   #
-  # @param [Symbol, String] method_name The option name to retrieve
-  # @return [Object, nil] The value of the option, or nil if not found
+  # @!method method_missing(method_name, *args)
+  #   Dynamic method to access option values
+  #   @param [Symbol] method_name The name of the option to retrieve
+  #   @param [Array] args Additional arguments (unused)
+  #   @return [Object, nil] The value of the option, or nil if not found
   # @example Access options as methods
   #   options = Judges::Options.new(["token=abc123", "max_speed=100"])
   #   options.token # => "abc123"

data/lib/judges/statistics.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require_relative '../judges'
+
+# Statistics collector for judge executions.
+#
+# This class collects and aggregates statistics about judge executions
+# across multiple cycles, providing insights into performance and results.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# License:: MIT
+class Judges::Statistics
+  # Initialize empty statistics.
+  def initialize
+    @data = {}
+  end
+
+  # Check if statistics are empty.
+  # @return [Boolean] True if no statistics have been collected
+  def empty?
+    @data.empty?
+  end
+
+  # Record statistics for a judge execution.
+  # @param [String] name The judge name
+  # @param [Float] time The execution time for this run
+  # @param [String] result The result for this run
+  # @param [Churn] churn The churn for this run (can be nil)
+  def record(name, time, result, churn = nil)
+    unless @data[name]
+      @data[name] = {
+        total_time: 0.0,
+        cycles: 0,
+        results: [],
+        total_churn: nil
+      }
+    end
+    stats = @data[name]
+    stats[:total_time] += time
+    stats[:cycles] += 1
+    stats[:results] << result
+    return unless churn
+    if stats[:total_churn]
+      stats[:total_churn] += churn
+    else
+      stats[:total_churn] = churn
+    end
+  end
+
+  # Generate a formatted statistics report.
+  # @param [Loog] loog Logging facility for output
+  def report(loog)
+    return if empty?
+    fmt = "%-30s\t%9s\t%7s\t%15s\t%-15s"
+    loog.info(
+      [
+        'Judge execution summary:',
+        format(fmt, 'Judge', 'Seconds', 'Cycles', 'Changes', 'Results'),
+        format(fmt, '---', '---', '---', '---', '---'),
+        @data.sort_by { |_, stats| stats[:total_time] }.reverse.map do |name, stats|
+          format(fmt, name, format('%.3f', stats[:total_time]), stats[:cycles],
+                 stats[:total_churn] ? stats[:total_churn].to_s : 'N/A', summarize(stats[:results]))
+        end.join("\n  ")
+      ].join("\n  ")
+    )
+  end
+
+  private
+
+  # Summarize results across multiple cycles into a compact string.
+  # @param [Array<String>] results Array of result strings from different cycles
+  # @return [String] Compact summary of results
+  def summarize(results)
+    return 'N/A' if results.empty?
+    counts = results.each_with_object(Hash.new(0)) { |result, hash| hash[result] += 1 }
+    return results.first if counts.size == 1
+    counts.sort_by { |_, count| -count }.map { |result, count| "#{count}x#{result}" }.join(', ')
+  end
+end

data/lib/judges.rb

@@ -8,5 +8,5 @@
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 module Judges
-  VERSION = '0.55.0' unless const_defined?(:VERSION)
+  VERSION = '0.57.0' unless const_defined?(:VERSION)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.55.0
+  version: 0.57.0
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -280,6 +280,7 @@ files:
 - fixtures/try/try.rb
 - judges.gemspec
 - lib/judges.rb
+- lib/judges/ascii_loog.rb
 - lib/judges/categories.rb
 - lib/judges/commands/download.rb
 - lib/judges/commands/eval.rb
@@ -297,6 +298,7 @@ files:
 - lib/judges/judge.rb
 - lib/judges/judges.rb
 - lib/judges/options.rb
+- lib/judges/statistics.rb
 - lib/judges/to_rel.rb
 - package-lock.json
 - package.json