judges 0.54.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 362db1ae173a36a6d70359dcb5302f0e9256399471857f45dfca0c8b56e74e72
-  data.tar.gz: 383960c78930d7475d6750a994f83cfe514169c052090e7b2e7613119376cf77
+  metadata.gz: c1bce8cfaa9c1567d94332da48e35b303ec5b963198d72a82bf69164cbd1928d
+  data.tar.gz: 467ab5d5bab974f97be24720c3e44f15d353c38f2ecf553648431facb603864f
 SHA512:
-  metadata.gz: 5e9e77e4a0f716c8efec912ba87aa5243617eed5a90c21f6402b6596f17ee888b8741956111f8e6cd6b426b34b32681c6f8dc9a6b2fc6f02de5077b921b55d5a
-  data.tar.gz: ed95c04645d0c0521d1908a31c7ddad0481780faf31d709f8807340500b5ef8badbee8f9994816549a4213e43b6f472e6e3c57af2ac4a0c093a9fe3dde6afd1a
+  metadata.gz: dfd3eb005e029e442b5c924620a897df19c974599122e6ae20f0369718f02b8b6171b852e32d408c5a27c766dac92260ad59e4420e14c5d8ccdcc5c8b4ca38b5
+  data.tar.gz: 66fbdd630846645475cab1daa36b326d92e37eeb08cf41c176b1a710e93d25acc3565b8bd4c43f6905e0bdb2752ac03dc609d6d5152e93b08b993b34463be0b2

data/Gemfile.lock

@@ -28,7 +28,7 @@ GEM
     ast (2.4.3)
     backtrace (0.4.1)
     base64 (0.3.0)
-    baza.rb (0.10.2)
+    baza.rb (0.11.0)
       backtrace (~> 0.4)
       elapsed (~> 0.2)
       faraday (~> 2.13)
@@ -40,13 +40,13 @@ GEM
       retries (~> 0.0)
       tago (~> 0.2)
       typhoeus (~> 1.4)
-    bigdecimal (3.2.3)
+    bigdecimal (3.3.1)
     builder (3.3.0)
     concurrent-ruby (1.3.5)
-    crack (1.0.0)
+    crack (1.0.1)
       bigdecimal
       rexml
-    cucumber (10.1.0)
+    cucumber (10.1.1)
       base64 (~> 0.2)
       builder (~> 3.2)
       cucumber-ci-environment (> 9, < 11)
@@ -59,18 +59,18 @@ GEM
       multi_test (~> 1.1)
       sys-uname (~> 1.3)
     cucumber-ci-environment (10.0.1)
-    cucumber-core (15.2.1)
-      cucumber-gherkin (> 27, < 33)
+    cucumber-core (15.3.0)
+      cucumber-gherkin (> 27, < 35)
       cucumber-messages (> 26, < 30)
-      cucumber-tag-expressions (> 5, < 7)
+      cucumber-tag-expressions (> 5, < 9)
     cucumber-cucumber-expressions (18.0.1)
       bigdecimal
-    cucumber-gherkin (32.2.0)
-      cucumber-messages (> 25, < 28)
+    cucumber-gherkin (34.0.0)
+      cucumber-messages (> 25, < 29)
     cucumber-html-formatter (21.15.1)
       cucumber-messages (> 19, < 28)
     cucumber-messages (27.2.0)
-    cucumber-tag-expressions (6.1.2)
+    cucumber-tag-expressions (8.0.0)
     decoor (0.1.0)
     diff-lcs (1.6.2)
     docile (1.4.1)
@@ -78,9 +78,10 @@ GEM
       loog (~> 0.6)
       tago (~> 0.1)
     ellipsized (0.3.0)
-    ethon (0.17.0)
+    ethon (0.18.0)
       ffi (>= 1.15.0)
-    factbase (0.16.7)
+      logger
+    factbase (0.16.8)
       backtrace (~> 0.4)
       decoor (~> 0.1)
       ellipsized (~> 0.3)
@@ -91,7 +92,7 @@ GEM
       others (~> 0.1)
       tago (~> 0.1)
       yaml (~> 0.3)
-    faraday (2.13.4)
+    faraday (2.14.0)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
@@ -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.13.2)
+    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.25.5)
+    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.5.1)
+    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)
-    random-port (0.7.5)
-      tago (> 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.80.2)
+    rubocop (1.81.7)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -187,20 +188,20 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.46.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.46.0)
+    rubocop-ast (1.48.0)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
     rubocop-minitest (0.38.2)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.38.0, < 2.0)
-    rubocop-performance (1.26.0)
+    rubocop-performance (1.26.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
@@ -217,20 +218,20 @@ GEM
     sys-uname (1.4.1)
       ffi (~> 1.1)
       memoist3 (~> 1.0.0)
-    tago (0.2.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.3)
+    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
@@ -55,11 +56,18 @@ class JudgesGLI extend GLI::App
   flag([:factbase], type: String)
   desc 'Echo the entire command line'
   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
@@ -71,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
@@ -92,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>')
@@ -127,6 +141,7 @@ class JudgesGLI extend GLI::App
   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)
@@ -134,11 +149,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)
@@ -146,6 +163,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)')
@@ -153,6 +171,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')
@@ -172,11 +191,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>')
@@ -198,6 +219,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])
@@ -221,6 +243,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])
@@ -242,6 +265,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])
@@ -261,6 +285,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/test.feature

@@ -16,9 +16,9 @@ Feature: Test
     And Exit code is zero
 
   Scenario: Factbase version can be set
-    When I run bin/judges with "--factbase 0.16.7 --verbose test --judge guess ./fixtures"
+    When I run bin/judges with "--factbase 0.16.8 --verbose test --judge guess ./fixtures"
     Then Exit code is zero
-    And Stdout contains "Factbase version to be used: '0.16.7'"
+    And Stdout contains "Factbase version to be used: '0.16.8'"
 
   Scenario: Simple test of no judges
     Given I run bin/judges with "test --judge absent_for_sure ./fixtures"

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
 

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.54.0'
+  s.version = '0.56.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/print.rb

@@ -89,13 +89,14 @@ class Judges::Print
         'columns' => opts['columns'] || 'when,what,who',
         'hidden' => opts['hidden'] || '_id,_version,_time,_job',
         'version' => Judges::VERSION,
-        'css_hash' => sha384('index.css'),
-        'js_hash' => sha384('index.js')
+        'css_hash' => sha384(opts, 'index.css'),
+        'js_hash' => sha384(opts, 'index.js')
       )
     )
   end
 
-  def sha384(asset)
+  def sha384(opts, asset)
+    return 'sha256-offline' if opts['offline']
     with_retries do
       url = "https://yegor256.github.io/judges/assets/#{asset}"
       http = Typhoeus::Request.get(url)

data/lib/judges/commands/update.rb

@@ -186,7 +186,7 @@ class Judges::Update
           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})")
               next
             end

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.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.54.0
+  version: 0.56.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