judges 0.42.0 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af0d2479c169453b9879f770a4dffbe7530f15665941200658d9255490a36db8
-  data.tar.gz: 99aa6fe32517235bae4c0a8841658e40cf41d589b75bf1da1f160c12a27a5452
+  metadata.gz: 9872185eca6e28654c9ee3395817985e8762408d022d961e189cbfcfab7c2ac8
+  data.tar.gz: 0c83c8a61f2661a17f8473469920b7e7c493be4d30e8f2f1bca7f3afaf6e6049
 SHA512:
-  metadata.gz: 339dd1173c591e66b517c1665fef77e9c279f9286364abc964ef725275857f90d973cdedf7895da3ba25b48a07e1d71a532b0d7dd193f967490a67c9263c19a5
-  data.tar.gz: 24b25cd92ef031e7459aa5c12f77a4ac88359795a58c878d387840e5ce94f4a011f624db305104c95a867c7397b6fb0c17e6fede0d9ccacfbdc71637cc583cd7
+  metadata.gz: 76d8a0e542efee6b6e444857b4e1dbe3ff40ddb482f3f109e1170a8f9281021d5ff1952ac74d53aad513aaf3e87441f39080ec6c6adda0300c06566d37b85b9c
+  data.tar.gz: 6222dc327c05ee568395feb6c0b05ba37a5a152ac7d4d51b2be71b7be0262617ac82160491e13b90330729b10e6104e11fd3f50ce3ff8ea3ed47598057a4b9a5

data/.github/workflows/eslint.yml

@@ -16,6 +16,5 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
-      - run: npm install -g eslint@9.17.0
-      - run: npm install @eslint/js
-      - run: eslint
+      - run: npm install
+      - run: npx eslint .

data/.github/workflows/markdown-lint.yml

@@ -20,4 +20,4 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
-      - uses: articulate/actions-markdownlint@v1
+      - uses: DavidAnson/markdownlint-cli2-action@v20.0.0

data/.github/workflows/typos.yml

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
+# yamllint disable rule:line-length
+name: typos
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  typos:
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: crate-ci/typos@v1.32.0

data/.gitignore

@@ -1,11 +1,12 @@
-*.gem
-.DS_Store
 .bundle/
+.DS_Store
 .idea/
 .yardoc/
+*.gem
 coverage/
 doc/
 node_modules/
 rdoc/
 temp/
 vendor/
+.claude

data/Gemfile.lock

@@ -73,14 +73,15 @@ GEM
     cucumber-tag-expressions (6.1.2)
     date (3.4.1)
     decoor (0.0.1)
-    diff-lcs (1.6.1)
+    diff-lcs (1.6.2)
     docile (1.4.1)
     elapsed (0.0.1)
       loog (> 0)
       tago (> 0)
+    erb (5.0.1)
     ethon (0.16.0)
       ffi (>= 1.15.0)
-    factbase (0.10.1)
+    factbase (0.10.2)
       backtrace (~> 0.4)
       decoor (~> 0.0)
       json (~> 2.7)
@@ -111,15 +112,16 @@ GEM
     ffi (1.17.2-x86_64-linux-gnu)
     gli (2.22.2)
       ostruct
-    hashdiff (1.1.2)
+    hashdiff (1.2.0)
     iri (0.10.0)
-    json (2.11.3)
-    language_server-protocol (3.17.0.4)
+    json (2.12.0)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    loog (0.6.0)
+    loog (0.6.1)
+      logger (~> 1.0)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.8)
+    mini_portile2 (2.8.9)
     minitest (5.25.5)
     minitest-reporters (1.7.1)
       ansi
@@ -157,11 +159,11 @@ GEM
       ast (~> 2.4.1)
       racc
     prism (1.4.0)
-    psych (5.2.3)
+    psych (5.2.6)
       date
       stringio
     public_suffix (6.0.2)
-    qbash (0.4.0)
+    qbash (0.4.5)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
@@ -171,12 +173,13 @@ GEM
     rake (13.2.1)
     random-port (0.7.5)
       tago (> 0)
-    rdoc (6.13.1)
+    rdoc (6.14.0)
+      erb
       psych (>= 4.0.0)
     regexp_parser (2.10.0)
     retries (0.0.5)
     rexml (3.4.1)
-    rubocop (1.75.4)
+    rubocop (1.75.6)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)

data/README.md

@@ -12,7 +12,7 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/judges/blob/master/LICENSE.txt)
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fyegor256%2Fjudges.svg?type=shield&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fyegor256%2Fjudges?ref=badge_shield&issueType=license)
 
-A command line tool and a Ruby gem for running so called judges against a
+A command line tool and a Ruby gem for running so-called judges against a
 [factbase](https://github.com/yegor256/factbase).
 
 Every "judge" is a directory with a single `.rb` file and a number
@@ -64,10 +64,10 @@ via the command line `--option` flag of the `update` command; and `expected` is
 an array of XPath expressions that must be present in the XML of the Factbase
 when the test is finished.
 
-The `category` (default: `[]`) may have one or an array of categories,
+The `category` (default: `[]`) may have one category or an array of categories,
 which then may be turned on via the `--category` command line flag.
 
-The `repeat` (default: `1`) makes `input` to be repeated multiple times
+The `repeat` (default: `1`) makes the `input` to be repeated multiple times
 (mostly useful for speed measuring on big data inputs).
 
 The `runs` (default: `1`) is the number of times the `.rb` script should

data/REUSE.toml

@@ -4,10 +4,17 @@
 version = 1
 [[annotations]]
 path = [
+    ".DS_Store",
+    ".gitattributes",
+    ".gitignore",
+    ".pdd",
     "**.json",
     "**.md",
     "**.png",
     "**.txt",
+    "**/.DS_Store",
+    "**/.gitignore",
+    "**/.pdd",
     "**/*.csv",
     "**/*.jpg",
     "**/*.json",
@@ -17,15 +24,8 @@ path = [
     "**/*.svg",
     "**/*.txt",
     "**/*.vm",
-    "**/.DS_Store",
-    "**/.gitignore",
-    "**/.pdd",
     "**/CNAME",
     "**/Gemfile.lock",
-    ".DS_Store",
-    ".gitattributes",
-    ".gitignore",
-    ".pdd",
     "Gemfile.lock",
     "README.md",
     "renovate.json",

data/assets/index.js

@@ -1,7 +1,7 @@
 /*
- SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
- SPDX-License-Identifier: MIT
-*/
+ * SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+ * SPDX-License-Identifier: MIT
+ */
 
 $(() => {
   $('#facts').tablesorter();

data/bin/judges

@@ -23,7 +23,7 @@ class JudgesGLI extend GLI::App
       start = Time.now
       @@loog.debug("Running '#{ruby}' command...")
       Object.const_get("Judges::#{ruby.capitalize}").new(@@loog).run(options, args)
-      @@loog.debug("Command '#{ruby}' finished in #{start.ago}")
+      @@loog.debug("Command '#{ruby}' completed in #{start.ago}")
     end
   end
 
@@ -37,9 +37,9 @@ class JudgesGLI extend GLI::App
 
   subcommand_option_handling(:normal)
 
-  desc 'Make it more verbose, logging as much as possible'
+  desc 'Enable verbose mode with maximum logging'
   switch([:v, :verbose])
-  desc 'Version of Factbase to use'
+  desc 'Specify Factbase version to use'
   flag([:factbase], type: String)
 
   pre do |global, command, options, args|
@@ -61,36 +61,38 @@ class JudgesGLI extend GLI::App
     true
   end
 
-  desc 'Update the factbase by passing all judges one by one'
+  desc 'Update the factbase by executing all judges sequentially'
   command :update do |c|
-    c.desc 'Options to pass to every judge'
+    c.desc 'Options to pass to each judge'
     c.flag([:o, :option], multiple: true, arg_name: '<key=value>')
-    c.desc 'File with options, one k=v pair per line'
+    c.desc 'File containing options, one key=value pair per line'
     c.flag([:'options-file'])
     c.desc 'Name of the judge to run (directory name)'
     c.flag([:judge], multiple: true)
-    c.desc 'The location of a Ruby library (directory with .rb files to include)'
+    c.desc 'Location of a Ruby library (directory with .rb files to include)'
     c.flag([:lib])
-    c.desc 'Shuffle them, except the ones that start with the prefix'
+    c.desc 'Shuffle judges, except those starting with the specified prefix'
     c.flag([:shuffle], default_value: '')
-    c.desc 'Boost one judge, running it on top of all others'
+    c.desc 'Prioritize a judge to run before all others'
     c.flag([:boost], multiple: true)
-    c.desc 'Maximum time in seconds to spend on the entire update cycle'
+    c.desc 'Maximum time in seconds for the entire update cycle'
     c.flag([:lifetime], default_value: 300, type: Integer)
-    c.desc 'Maximum time in seconds to spend on every judge (forcefully terminate if over time)'
+    c.desc 'Maximum time in seconds for each judge (forcefully terminates if exceeded)'
     c.flag([:timeout], default_value: 30, type: Integer)
     c.desc 'Maximum number of update cycles to run'
     c.flag([:'max-cycles'], default_value: 8, type: Integer)
-    c.desc 'Stay quiet even if some judges fail'
+    c.desc 'Suppress errors even when judges fail'
     c.switch([:q, :quiet], default_value: false)
-    c.desc 'Place a summarization fact into the factbase'
+    c.desc 'Stop processing immediately after the first error'
+    c.switch([:'fail-fast'], default_value: false)
+    c.desc 'Add a summary fact to the factbase'
     c.switch([:summary], default_value: false)
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
     run_it(c, 'update')
   end
 
-  desc 'Evaluate a single Ruby expression on the factbase'
+  desc 'Evaluate a single Ruby expression against the factbase'
   command :eval do |c|
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
@@ -109,40 +111,40 @@ class JudgesGLI extend GLI::App
     run_it(c, 'import')
   end
 
-  desc 'Remove the facts that are too old'
+  desc 'Remove outdated facts from the factbase'
   command :trim do |c|
-    c.desc 'Only the facts that match the expression are deleted'
+    c.desc 'Delete only facts matching the specified expression'
     c.flag([:query], default_value: '(never)')
     run_it(c, 'trim')
   end
 
-  desc 'Print the factbase into a human-readable format (YAML, JSON, etc.)'
+  desc 'Convert the factbase to a human-readable format (YAML, JSON, etc.)'
   command :print do |c|
     c.desc 'Output format (xml, json, or yaml)'
     c.flag([:format], default_value: 'yaml')
-    c.desc 'Generate output name of the file automatically'
+    c.desc 'Automatically generate the output filename'
     c.switch([:auto], default_value: false)
-    c.desc 'The title of the document to use'
+    c.desc 'Document title to use'
     c.flag([:title], default_value: 'summary')
-    c.desc 'Only the facts that match the expression are printed'
+    c.desc 'Print only facts matching the specified expression'
     c.flag([:query], default_value: '(always)')
-    c.desc 'Comma separated list of columns to show in HTML output (no spaces!)'
+    c.desc 'Comma-separated list of columns to display in HTML output (no spaces)'
     c.flag([:columns], default_value: 'when,what')
-    c.desc 'Comma separated list of hidden columns, not to be rendered (no spaces!)'
+    c.desc 'Comma-separated list of columns to hide from rendering (no spaces)'
     c.flag([:hidden], default_value: '_id,_time,_version,_job')
-    c.desc 'Print even if target file already exists and is older than the factbase'
+    c.desc 'Force printing even if the target file exists and is older than the factbase'
     c.switch([:force], default_value: false)
     run_it(c, 'print')
   end
 
-  desc 'Inspect the factbase and print all its possible meta-data'
+  desc 'Inspect the factbase and display all available metadata'
   command :inspect do |c|
     run_it(c, 'inspect')
   end
 
   desc 'Run automated tests for all judges'
   command :test do |c|
-    c.desc 'Options to pass to every judge (may be overwritten by YAML)'
+    c.desc 'Options to pass to each judge (may be overridden by YAML)'
     c.flag([:o, :option], multiple: true, arg_name: '<key=value>')
     c.desc 'Categories of tests to disable'
     c.flag([:disable], multiple: true)
@@ -150,57 +152,57 @@ class JudgesGLI extend GLI::App
     c.flag([:enable], multiple: true)
     c.desc 'Name of the judge to run (directory name)'
     c.flag([:judge], multiple: true)
-    c.desc 'How many times to run?'
+    c.desc 'Number of times to run the tests'
     c.flag([:runs], type: Integer)
-    c.desc 'The location of a Ruby library (directory with .rb files to include)'
+    c.desc 'Location of a Ruby library (directory with .rb files to include)'
     c.flag([:lib])
-    c.desc 'Stay quiet even if some tests fail or simply no tests executed?'
+    c.desc 'Suppress output even if tests fail or none are executed'
     c.switch([:quiet], default_value: false)
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
     run_it(c, 'test')
   end
 
-  desc 'Push the factbase to the server and unlock it over there'
+  desc 'Push the factbase to the server and unlock it remotely'
   command :push do |c|
     c.desc 'Authentication token'
     c.flag([:token])
-    c.desc 'The IP/hostname of the server'
+    c.desc 'Server IP/hostname'
     c.flag([:host], default_value: 'api.zerocracy.com')
-    c.desc 'The TCP port number of the server'
+    c.desc 'Server TCP port number'
     c.flag([:port], default_value: 443, type: Integer)
-    c.desc 'Connection and read time in seconds'
+    c.desc 'Connection and read timeout in seconds'
     c.flag([:timeout], default_value: 30, type: Integer)
-    c.desc 'Shall SSL be used?'
+    c.desc 'Enable SSL connection'
     c.switch([:ssl], default_value: true)
-    c.desc 'A unique name to use for a lock/unlock'
+    c.desc 'Unique identifier for lock/unlock operations'
     c.flag([:owner], default_value: 'default', type: String)
-    c.desc 'Supplementary meta information about the upload (key:value)'
+    c.desc 'Additional metadata for the upload (key:value format)'
     c.flag([:meta], type: String, multiple: true)
-    c.desc 'How many times to retry'
+    c.desc 'Number of retry attempts'
     c.flag([:retries], type: Integer, default_value: 3)
-    c.desc 'Turn on the package compression'
+    c.desc 'Enable package compression'
     c.switch([:zip], default_value: true)
     run_it(c, 'push')
   end
 
-  desc 'Pull the factbase from the server and lock it over there'
+  desc 'Pull the factbase from the server and lock it remotely'
   command :pull do |c|
     c.desc 'Authentication token'
     c.flag([:token])
-    c.desc 'How many seconds to wait'
+    c.desc 'Maximum wait time in seconds'
     c.flag([:wait], default_value: 10 * 60, arg_name: '<seconds>', type: Integer)
-    c.desc 'The IP/hostname of the server'
+    c.desc 'Server IP/hostname'
     c.flag([:host], default_value: 'api.zerocracy.com')
-    c.desc 'The TCP port number of the server'
+    c.desc 'Server TCP port number'
     c.flag([:port], default_value: 443, type: Integer)
-    c.desc 'Connection and read time in seconds'
+    c.desc 'Connection and read timeout in seconds'
     c.flag([:timeout], default_value: 30, type: Integer)
-    c.desc 'Shall SSL be used?'
+    c.desc 'Enable SSL connection'
     c.switch([:ssl], default_value: true)
-    c.desc 'A unique name to use for a lock/unlock'
+    c.desc 'Unique identifier for lock/unlock operations'
     c.flag([:owner], default_value: 'default', type: String)
-    c.desc 'How many times to retry'
+    c.desc 'Number of retry attempts'
     c.flag([:retries], type: Integer, default_value: 3)
     run_it(c, 'pull')
   end

data/features/import.feature

@@ -16,5 +16,5 @@ Feature: Import
       z: 3.14
     """
     Then I run bin/judges with "--verbose import simple.yaml simple.fb"
-    Then Stdout contains "Import of 2 facts finished"
+    Then Stdout contains "Import of 2 facts completed"
     And Exit code is zero

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.10.1 --verbose test --judge guess ./fixtures"
+    When I run bin/judges with "--factbase 0.10.2 --verbose test --judge guess ./fixtures"
     Then Exit code is zero
-    And Stdout contains "Factbase version to be used: '0.10.1'"
+    And Stdout contains "Factbase version to be used: '0.10.2'"
 
   Scenario: Simple test of no judges
     Given I run bin/judges with "test --judge absent_for_sure ./fixtures"

data/features/update.feature

@@ -15,7 +15,7 @@ Feature: Update
     Then Stdout contains "FOO → "
     Then Stdout contains "BAR → "
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished in 3 cycle(s), did 3i/0d/3a"
+    Then Stdout contains "Update completed in 3 cycle(s), did 3i/0d/3a"
     And Exit code is zero
 
   Scenario: Generate a summary fact, with errors
@@ -39,7 +39,7 @@ Feature: Update
     """
     Then I run bin/judges with "--verbose update --quiet --lifetime 1 --max-cycles 5 . simple.fb"
     Then Stdout contains "The 'simple' judge skipped, no time left"
-    Then Stdout contains "Update finished in 2 cycle(s), did 1i/0d/0a"
+    Then Stdout contains "Update completed in 2 cycle(s), did 1i/0d/0a"
     And Exit code is zero
 
   Scenario: Use options from a file
@@ -57,7 +57,7 @@ Feature: Update
     Then Stdout contains "A1 → "
     Then Stdout contains "A2 → "
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished"
+    Then Stdout contains "Update completed"
     And Exit code is zero
 
   Scenario: Simple run with a timeout for a judge
@@ -71,7 +71,7 @@ Feature: Update
     Then Stdout contains "execution expired"
     Then Stdout contains "judge timed out after"
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished in 1 cycle(s), did 0i/0d/0a"
+    Then Stdout contains "Update completed in 1 cycle(s), did 0i/0d/0a"
     And Exit code is zero
 
   Scenario: Simple run of a few judges, with a lib
@@ -87,7 +87,7 @@ Feature: Update
     """
     Then I run bin/judges with "update --lib mylib --max-cycles 1 mine simple.fb"
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished in 1 cycle(s)"
+    Then Stdout contains "Update completed in 1 cycle(s)"
     And Exit code is zero
 
   Scenario: The update fails when a bug in a judge

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

data/lib/judges/commands/eval.rb

@@ -16,10 +16,16 @@ require_relative '../../judges/impex'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class Judges::Eval
+  # Initialize.
+  # @param [Loog] loog Logging facility
   def initialize(loog)
     @loog = loog
   end
 
+  # Run the eval command (called by the +bin/judges+ script).
+  # @param [Hash] opts Command line options (start with '--')
+  # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly two arguments provided
   def run(opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     impex = Judges::Impex.new(@loog, args[0])
@@ -34,7 +40,7 @@ class Judges::Eval
       eval(expr)
       # rubocop:enable Security/Eval
       impex.export($fb)
-      throw :'Evaluated successfully'
+      throw :'👍 Evaluated successfully'
     end
   end
 end

data/lib/judges/commands/import.rb

@@ -18,10 +18,16 @@ require_relative '../../judges/to_rel'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class Judges::Import
+  # Initialize.
+  # @param [Loog] loog Logging facility
   def initialize(loog)
     @loog = loog
   end
 
+  # Run the import command (called by the +bin/judges+ script).
+  # @param [Hash] opts Command line options (start with '--')
+  # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly two arguments provided or file not found
   def run(opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     raise "File not found #{args[0].to_rel}" unless File.exist?(args[0])
@@ -41,7 +47,7 @@ class Judges::Import
         end
       end
       impex.export(fb)
-      throw :"Import of #{yaml.size} facts finished"
+      throw :"👍 Import of #{yaml.size} facts completed"
     end
   end
 end

data/lib/judges/commands/inspect.rb

@@ -15,12 +15,18 @@ require_relative '../../judges/impex'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class Judges::Inspect
+  # Initialize.
+  # @param [Loog] loog Logging facility
   def initialize(loog)
     @loog = loog
   end
 
+  # Run the inspect command (called by the +bin/judges+ script).
+  # @param [Hash] _opts Command line options (not used)
+  # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If no arguments provided
   def run(_opts, args)
-    raise 'At lease one argument required' if args.empty?
+    raise 'At least one argument required' if args.empty?
     fb = Judges::Impex.new(@loog, args[0]).import
     @loog.info("Facts: #{fb.size}")
   end

data/lib/judges/commands/join.rb

@@ -16,10 +16,16 @@ require_relative '../../judges/impex'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class Judges::Join
+  # Initialize.
+  # @param [Loog] loog Logging facility
   def initialize(loog)
     @loog = loog
   end
 
+  # Run the join command (called by the +bin/judges+ script).
+  # @param [Hash] _opts Command line options (not used)
+  # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly two arguments provided
   def run(_opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     master = Judges::Impex.new(@loog, args[0])
@@ -28,7 +34,7 @@ class Judges::Join
       fb = master.import
       slave.import_to(fb)
       master.export(fb)
-      throw :'Two factbases joined'
+      throw :'👍 Two factbases joined successfully'
     end
   end
 end

data/lib/judges/commands/print.rb

@@ -23,15 +23,18 @@ require_relative '../../judges/impex'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class Judges::Print
+  # Initialize.
+  # @param [Loog] loog Logging facility
   def initialize(loog)
     @loog = loog
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
+  # Run the print command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If no arguments provided
   def run(opts, args)
-    raise 'At lease one argument required' if args.empty?
+    raise 'At least one argument required' if args.empty?
     f = args[0]
     fb = Judges::Impex.new(@loog, f).import
     fb.query("(not #{opts['query']})").delete! unless opts['query'].nil?
@@ -68,7 +71,7 @@ class Judges::Print
             raise "Unknown format '#{fmt}'"
         end
       File.binwrite(o, output)
-      throw :"Factbase printed to #{o.to_rel} (#{File.size(o)} bytes)"
+      throw :"👍 Factbase printed to #{o.to_rel} (#{File.size(o)} bytes)"
     end
   end
 

data/lib/judges/commands/pull.rb

@@ -19,13 +19,16 @@ require_relative '../../judges/impex'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class Judges::Pull
+  # Initialize.
+  # @param [Loog] loog Logging facility
   def initialize(loog)
     @loog = loog
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
+  # Run the pull command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly two arguments provided
   def run(opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     fb = Factbase.new
@@ -52,9 +55,9 @@ class Judges::Pull
           baza.unlock(name, opts['owner'])
           raise e
         end
-        throw :"Pulled #{fb.size} facts by the name '#{name}'"
+        throw :"👍 Pulled #{fb.size} facts by name '#{name}'"
       else
-        throw :"There is nothing to pull, the name '#{name}' is absent on the server"
+        throw :"⚠️ Nothing to pull - name '#{name}' not found on server"
       end
     end
   end
@@ -67,7 +70,7 @@ class Judges::Pull
     loop do
       break if baza.finished?(id)
       sleep 1
-      raise "Time is over, the job ##{id} ('#{name}') is still not finished" if Time.now - start > limit
+      raise "Time is over, the job ##{id} ('#{name}') is still not completed" if Time.now - start > limit
       lapsed = Time.now - start
       @loog.debug("Still waiting for the job ##{id} ('#{name}') to finish... (#{format('%.2f', lapsed)}s already)")
     end