judges 0.55.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb2df3f4875124734e1fc6698c45a9bae82e187a73ae6632bc31906ec8039452
-  data.tar.gz: 14639995b236e8f4ce02fb794b4050b9fc578a1816e09510312f78c3811a09da
+  metadata.gz: c1bce8cfaa9c1567d94332da48e35b303ec5b963198d72a82bf69164cbd1928d
+  data.tar.gz: 467ab5d5bab974f97be24720c3e44f15d353c38f2ecf553648431facb603864f
 SHA512:
-  metadata.gz: f0b6906cfe65ed01d7d7d3af2677ba45fb6dc875060bcad82d055c18ceccc69973d510a7448748caf1f1bc01680d68fabbe9a223294b0707ddf721a2e1b66d3e
-  data.tar.gz: 7d92dfe3ea479bfef86366efe451ed415bb8a54d6c8fe9cddb99348408975282dee4e061b7b89c988221177eefecc3b8a228fb3bb08710a2d34c8004403f6a78
+  metadata.gz: dfd3eb005e029e442b5c924620a897df19c974599122e6ae20f0369718f02b8b6171b852e32d408c5a27c766dac92260ad59e4420e14c5d8ccdcc5c8b4ca38b5
+  data.tar.gz: 66fbdd630846645475cab1daa36b326d92e37eeb08cf41c176b1a710e93d25acc3565b8bd4c43f6905e0bdb2752ac03dc609d6d5152e93b08b993b34463be0b2

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>')
@@ -129,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)
@@ -136,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)
@@ -148,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)')
@@ -155,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')
@@ -174,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>')
@@ -200,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])
@@ -223,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])
@@ -244,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])
@@ -263,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/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.55.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/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.55.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.55.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