judges 0.57.3 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b995a5bc4afe05488b0261012335596fdeb046103bc626466fe094a75aaefe0d
-  data.tar.gz: 76bfaa700b489cf33e0830791bb1293d1418b0c3c373d30669d41f88f5f15691
+  metadata.gz: 2c056c0de03fb4bdfd31ab41881fd2a45df0dce3eab4cae835cb460f54fefc51
+  data.tar.gz: 9297963335726bbcab1e7f5551eaff4ec04130b72622e902e334fed5795f598b
 SHA512:
-  metadata.gz: 6aba33eabad340cb860a8fabc49e8707fe2bb700b626585e27bde8c1927da3031b5c04fb6ec97eb5aaa1af43fccc81759e0dc38291b3a58a142ca631cf970ecc
-  data.tar.gz: e9e395a105fe5b7794be9c1533279bd18b53c42807dd85f2e39bbe14064ada5f80fb78040ea750fa0939c12d29d1f825934063b6fc345bccfac7be66fa7c27d2
+  metadata.gz: 734372c730e0f4fe9f8e350dce2cb550f1cdde850934394a880ed1fd0682897da74659e8ed53799a0f28b6256e1ff7fb666daeb68b3f980711f727c09d18a977
+  data.tar.gz: 28be015f363aa13e9365e22e24100b5178125a727c7907c2a2bc32c378d87b70dc7faf08fd1248156fdc3c7999166c4807c9619603ea19463cfc19eb79034cea

data/bin/judges

@@ -118,11 +118,11 @@ class JudgesGLI extend GLI::App
     c.flag([:lib])
     c.desc 'Shuffle judges, except those starting with the specified prefix'
     c.flag([:shuffle], default_value: '')
-    c.desc 'Random seed for judge ordering (default: 0)'
+    c.desc 'Random seed for judge ordering'
     c.flag([:seed], default_value: 0, type: Integer)
-    c.desc 'Prioritize a judge to run before all others'
+    c.desc 'Prioritize a judge to run before all others (supports wildcards with *)'
     c.flag([:boost], multiple: true)
-    c.desc 'Demote a judge to run after all others'
+    c.desc 'Demote a judge to run after all others (supports wildcards with *)'
     c.flag([:demote], multiple: true)
     c.desc 'Maximum time in seconds for the entire update cycle'
     c.flag([:lifetime], default_value: 300, type: Integer)
@@ -142,6 +142,8 @@ class JudgesGLI extend GLI::App
     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)
+    c.desc 'File to write churn information to (e.g., /tmp/churn.txt)'
+    c.flag([:churn])
     run_it(c, 'update')
   end
 

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.57.3'
+  s.version = '0.58.0'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
   s.description =

data/lib/judges/commands/update.rb

@@ -70,9 +70,10 @@ class Judges::Update
       epoch: @epoch, shuffle: opts['shuffle'], boost: opts['boost'],
       demote: opts['demote'], seed: opts['seed']
     )
+    churn = nil
     begin
       Timeout.timeout(opts['lifetime']) do
-        loop_them(judges, fb, opts, options)
+        churn = loop_them(judges, fb, opts, options)
       end
     rescue Timeout::Error, Timeout::ExitException => e
       @loog.error("Terminated due to --lifetime=#{opts['lifetime']}")
@@ -80,6 +81,10 @@ class Judges::Update
       @loog.info("Had to stop due to the --lifetime=#{opts['lifetime']}")
     ensure
       impex.export(fb)
+      if opts['churn'] && churn
+        File.write(opts['churn'], churn.to_s)
+        @loog.info("Churn written to #{opts['churn']}: #{churn}")
+      end
     end
   end
 
@@ -129,8 +134,8 @@ class Judges::Update
       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)
+    summarize(fb, churn, errors, c) if %w[add append].include?(opts['summary'])
+    churn
   end
 
   # Update the summary.

data/lib/judges/judges.rb

@@ -32,8 +32,8 @@ class Judges::Judges
   # @param [Loog] loog Logging facility
   # @param [Time] epoch Start time
   # @param [String] shuffle Prefix for names of judges to shuffle
-  # @param [Array<String>] boost Names of judges to boost in priority
-  # @param [Array<String>] demote Names of judges to demote in priority
+  # @param [Array<String>] boost Names/patterns of judges to boost in priority (supports '*' wildcards)
+  # @param [Array<String>] demote Names/patterns of judges to demote in priority (supports '*' wildcards)
   # @param [Integer] seed Random seed for judge ordering (default: 0)
   def initialize(dir, lib, loog, epoch: Time.now, shuffle: '', boost: [], demote: [], seed: 0)
     @dir = dir
@@ -66,8 +66,8 @@ class Judges::Judges
   # determined by:
   # 1. Randomly reorder judges (if shuffle prefix is empty, shuffle all judges;
   #    if prefix is not empty, shuffle only those NOT starting with the prefix)
-  # 2. Judges whose names match the boost list are placed first
-  # 3. Judges whose names match the demote list are placed last
+  # 2. Judges whose names match the boost patterns are placed first (supports '*' wildcards)
+  # 3. Judges whose names match the demote patterns are placed last (supports '*' wildcards)
   #
   # @yield [Judges::Judge] Yields each valid judge object
   # @return [Enumerator] Returns an enumerator if no block is given
@@ -96,9 +96,9 @@ class Judges::Judges
     demoted = []
     normal = []
     good.map { |a| a[0] }.each do |j|
-      if @boost&.include?(j.name)
+      if fits?(j.name, @boost)
         boosted.append(j)
-      elsif @demote&.include?(j.name)
+      elsif fits?(j.name, @demote)
         demoted.append(j)
       else
         normal.append(j)
@@ -124,4 +124,19 @@ class Judges::Judges
     end
     idx
   end
+
+  private
+
+  # Checks if a judge name matches any of the given patterns.
+  # Patterns can contain '*' wildcards which are converted to '.*' regex patterns.
+  #
+  # @param [String] name The judge name to check
+  # @param [Array<String>, String, nil] patterns Array of patterns, or single pattern string, may contain '*' wildcards
+  # @return [Boolean] true if name matches any pattern, false otherwise
+  def fits?(name, patterns)
+    return false if patterns.nil? || patterns.empty?
+    Array(patterns).any? do |pattern|
+      name.match?("\\A#{pattern.gsub('*', '.*')}\\z")
+    end
+  end
 end

data/lib/judges.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.57.3
+  version: 0.58.0
 platform: ruby
 authors:
 - Yegor Bugayenko