judges 0.0.33 → 0.0.35

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9cdbff8b28d803f0ce0c0c8e8a934ea9af5b6d65b6396f04f94572bc21bb515e
-  data.tar.gz: 856504a44bf49b36ee64f3d304d14861965682df9257b6bbdb1284b71330d32d
+  metadata.gz: 410f436fd79010f188d3768f992bef64ddc4a445773e2c790aacc059597ea227
+  data.tar.gz: d9eeba81aa97bb9f62ab370aee3e9a3fbaee752f5b1e41df5d33387aece0a151
 SHA512:
-  metadata.gz: ddb58a1c8443ed4d61c3f55d155c34f0ba9e164d731167e7069169ac3ee7dbe9734fd7c4bd5a9e90a98787136b43d44966a3662fe3d13014298dcf1e770dd5d4
-  data.tar.gz: 9c8fe18c4bebae1ceeb56611b71862d5cda792d292e6ba33f6f1e6b0700483ab385281d00e6ca1a5f3e134d644f065706e547cc3d9b56c4e634dd7c46afac0dd
+  metadata.gz: 37e8c527a61456b50afba302d2747f43f97804a3831dd310543a3f3eacf810a985be3693d3219bbb0a8a12f8bc24c0e4f4ede6524afbfd5be7e7701a5783e453
+  data.tar.gz: 9e5be6b00df4e5decac97299579c3805b6f008a405213ab78f336df2bc272aec2a98c356ca605d7849dea34e2596c0b67ce43d04de727936948bf3ed07f64e81

data/.rubocop.yml

@@ -40,6 +40,8 @@ Layout/MultilineMethodCallIndentation:
   Enabled: false
 Metrics/AbcSize:
   Enabled: false
+Metrics/ClassLength:
+  Enabled: false
 Metrics/BlockLength:
   Enabled: false
 Metrics/CyclomaticComplexity:

data/.rultor.yml

@@ -33,8 +33,8 @@ release:
     rm -rf *.gem
     sed -i "s/0\.0\.0/${tag}/g" judges.gemspec
     git add judges.gemspec
-    sed -i "s/0\.0\.0/${tag}/g" bin/judges
-    git add bin/judges
+    sed -i "s/0\.0\.0/${tag}/g" lib/judges.rb
+    git add lib/judges.rb
     git commit -m "version set to ${tag}"
     gem build judges.gemspec
     chmod 0600 ../rubygems.yml

data/Gemfile

@@ -25,6 +25,7 @@ gemspec
 
 gem 'cucumber', '9.2.0', require: false
 gem 'minitest', '5.23.1', require: false
+gem 'net-ping', '2.0.8', require: false
 gem 'rake', '13.2.1', require: false
 gem 'rspec-rails', '6.1.2', require: false
 gem 'rubocop', '1.64.0', require: false
@@ -32,4 +33,5 @@ gem 'rubocop-performance', '1.21.0', require: false
 gem 'rubocop-rspec', '2.29.2', require: false
 gem 'simplecov', '0.22.0', require: false
 gem 'simplecov-cobertura', '2.1.0', require: false
+gem 'webmock', '3.19.1', require: false
 gem 'yard', '0.9.36', require: false

data/Gemfile.lock

@@ -3,10 +3,13 @@ PATH
   specs:
     judges (0.0.0)
       backtrace (~> 0.3)
-      factbase (~> 0.0.32)
+      concurrent-ruby (= 1.2.3)
+      factbase (~> 0.0.38)
       gli (~> 2.21)
+      iri (~> 0.8)
       loog (~> 0.2)
       nokogiri (~> 1.10)
+      typhoeus (~> 1.3)
 
 GEM
   remote: https://rubygems.org/
@@ -37,6 +40,8 @@ GEM
       minitest (>= 5.1)
       mutex_m
       tzinfo (~> 2.0)
+    addressable (2.8.6)
+      public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     backtrace (0.4.0)
     base64 (0.2.0)
@@ -44,6 +49,9 @@ GEM
     builder (3.2.4)
     concurrent-ruby (1.2.3)
     connection_pool (2.4.1)
+    crack (1.0.0)
+      bigdecimal
+      rexml
     crass (1.0.6)
     cucumber (9.2.0)
       builder (~> 3.2)
@@ -74,7 +82,9 @@ GEM
     docile (1.4.0)
     drb (2.2.1)
     erubi (1.12.0)
-    factbase (0.0.32)
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
+    factbase (0.0.38)
       json (~> 2.7)
       loog (~> 0.2)
       nokogiri (~> 1.10)
@@ -82,12 +92,14 @@ GEM
     ffi (1.16.3)
     ffi (1.16.3-x64-mingw-ucrt)
     gli (2.21.1)
+    hashdiff (1.1.0)
     i18n (1.14.5)
       concurrent-ruby (~> 1.0)
     io-console (0.7.2)
     irb (1.13.1)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
+    iri (0.8.0)
     json (2.7.2)
     language_server-protocol (3.17.0.3)
     loofah (2.22.0)
@@ -98,6 +110,7 @@ GEM
     minitest (5.23.1)
     multi_test (1.1.0)
     mutex_m (0.2.0)
+    net-ping (2.0.8)
     nokogiri (1.16.5-arm64-darwin)
       racc (~> 1.4)
     nokogiri (1.16.5-x64-mingw-ucrt)
@@ -112,6 +125,7 @@ GEM
       racc
     psych (5.1.2)
       stringio
+    public_suffix (5.0.5)
     racc (1.8.0)
     rack (3.0.11)
     rack-session (2.0.0)
@@ -204,13 +218,19 @@ GEM
     sys-uname (1.2.3)
       ffi (~> 1.1)
     thor (1.3.1)
+    typhoeus (1.4.1)
+      ethon (>= 0.9.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.5.0)
+    webmock (3.19.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
     webrick (1.8.1)
     yaml (0.3.0)
     yard (0.9.36)
-    zeitwerk (2.6.14)
+    zeitwerk (2.6.15)
 
 PLATFORMS
   arm64-darwin-22
@@ -222,6 +242,7 @@ DEPENDENCIES
   cucumber (= 9.2.0)
   judges!
   minitest (= 5.23.1)
+  net-ping (= 2.0.8)
   rake (= 13.2.1)
   rspec-rails (= 6.1.2)
   rubocop (= 1.64.0)
@@ -229,6 +250,7 @@ DEPENDENCIES
   rubocop-rspec (= 2.29.2)
   simplecov (= 0.22.0)
   simplecov-cobertura (= 2.1.0)
+  webmock (= 3.19.1)
   yard (= 0.9.36)
 
 BUNDLED WITH

data/bin/judges

@@ -32,13 +32,12 @@ Encoding.default_internal = Encoding::UTF_8
 class App
   extend GLI::App
 
-  ver = '0.0.33'
-
   loog = Loog::REGULAR
 
   program_desc('Automated executor of judges for a factbase')
 
-  version(ver)
+  require_relative '../lib/judges'
+  version(Judges::VERSION)
 
   synopsis_format(:full)
 
@@ -51,7 +50,7 @@ class App
     if global[:verbose]
       loog = Loog::VERBOSE
     end
-    loog.debug("judges #{ver}")
+    loog.debug("judges #{Judges::VERSION}")
     true
   end
 
@@ -131,6 +130,12 @@ class App
 
   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.flag([:o, :option], multiple: true, arg_name: '<key=value>')
+    c.desc 'Categories of tests to disable'
+    c.flag([:disable], multiple: true)
+    c.desc 'Categories of tests to enable'
+    c.flag([:enable], multiple: true)
     c.desc 'Name of the test pack to run'
     c.flag([:pack], multiple: true)
     c.desc 'The location of a Ruby library (directory with .rb files to include)'
@@ -142,6 +147,42 @@ class App
       Judges::Test.new(loog).run(options, args)
     end
   end
+
+  desc 'Push the factbase to the server'
+  command :push do |c|
+    c.desc 'Authentication token'
+    c.flag([:token])
+    c.desc 'The IP/hostname of the server'
+    c.flag([:host], default_value: 'www.zerocracy.com')
+    c.desc 'The TCP port number of the server'
+    c.flag([:port], default_value: 443)
+    c.desc 'Connection and read time in seconds'
+    c.flag([:timeout], default_value: 30)
+    c.desc 'Shall SSL be used?'
+    c.switch([:ssl], default_value: true)
+    c.action do |global, options, args|
+      require_relative '../lib/judges/commands/push'
+      Judges::Push.new(loog).run(options, args)
+    end
+  end
+
+  desc 'Pull the factbase from the server'
+  command :pull do |c|
+    c.desc 'Authentication token'
+    c.flag([:token])
+    c.desc 'The IP/hostname of the server'
+    c.flag([:host], default_value: 'www.zerocracy.com')
+    c.desc 'The TCP port number of the server'
+    c.flag([:port], default_value: 443)
+    c.desc 'Connection and read time in seconds'
+    c.flag([:timeout], default_value: 30)
+    c.desc 'Shall SSL be used?'
+    c.switch([:ssl], default_value: true)
+    c.action do |global, options, args|
+      require_relative '../lib/judges/commands/pull'
+      Judges::Pull.new(loog).run(options, args)
+    end
+  end
 end
 
 exit App.run(ARGV)

data/features/pull.feature

@@ -0,0 +1,12 @@
+Feature: Pull
+  I want to pull a factbase
+
+  Scenario: Pull a small factbase
+    Given We are online
+    Given I make a temp directory
+    Then I run bin/judges with "--verbose pull --token 00000000-0000-0000-0000-000000000000 simple simple.fb"
+    Then Stdout contains "Pulled"
+    And Exit code is zero
+    Then I run bin/judges with "inspect simple.fb"
+    And Exit code is zero
+

data/features/push.feature

@@ -0,0 +1,11 @@
+Feature: Push
+  I want to push a factbase
+
+  Scenario: Push a small factbase
+    Given We are online
+    Given I make a temp directory
+    Then I run bin/judges with "--verbose eval simple.fb '$fb.insert.foo = 42'"
+    Then I run bin/judges with "push --token 00000000-0000-0000-0000-000000000000 simple simple.fb"
+    Then Stdout contains "Pushed"
+    And Exit code is zero
+

data/features/step_definitions/steps.rb

@@ -21,6 +21,7 @@
 # SOFTWARE.
 
 require 'tmpdir'
+require 'net/ping'
 require 'English'
 
 Before do
@@ -34,6 +35,10 @@ After do
   end
 end
 
+Given(/^We are online$/) do
+  pending unless Net::Ping::External.new('8.8.8.8').ping?
+end
+
 Given(/^I make a temp directory$/) do
   @tmp = Dir.mktmpdir('test')
   FileUtils.mkdir_p(@tmp)

data/features/test.feature

@@ -4,12 +4,12 @@ Feature: Test
   Scenario: Simple test of a few judges
     Given I run bin/judges with "test ./fixtures"
     Then Stdout contains "👉 Testing"
-    Then Stdout contains "judge(s) tested successfully"
+    Then Stdout contains "All 2 judge(s) and 2 tests passed"
     And Exit code is zero
 
   Scenario: Simple test of just one pack
     Given I run bin/judges with "test --pack guess ./fixtures"
-    Then Stdout contains "judge(s) tested successfully"
+    Then Stdout contains "All 1 judge(s) and 1 tests passed"
     And Exit code is zero
 
   Scenario: Simple test of no packs
@@ -28,5 +28,36 @@ Feature: Test
       $foo = 42
     """
     Then I run bin/judges with "test --lib mylib mypacks"
-    Then Stdout contains "All 1 judge(s) tested successfully"
+    Then Stdout contains "All 1 judge(s) and 0 tests passed"
     And Exit code is zero
+
+  Scenario: Enable only one category
+    Given I make a temp directory
+    Then I have a "mypacks/good/good.rb" file with content:
+    """
+    n = $fb.insert
+    """
+    Then I have a "mypacks/good/good.yml" file with content:
+    """
+    ---
+    category: good
+    input: []
+    """
+    Then I have a "mypacks/bad/bad.rb" file with content:
+    """
+    broken$ruby$syntax
+    """
+    Then I have a "mypacks/bad/bad.yml" file with content:
+    """
+    ---
+    category: bad
+    """
+    Then I run bin/judges with "test --enable good mypacks"
+    Then Stdout contains "All 2 judge(s) and 1 tests passed"
+    And Exit code is zero
+    Then I run bin/judges with "test --disable bad mypacks"
+    Then Stdout contains "All 2 judge(s) and 1 tests passed"
+    And Exit code is zero
+    Then I run bin/judges with "test --enable bad mypacks"
+    Then Stdout contains "Testing mypacks/bad/bad.yml"
+    And Exit code is not zero

data/fixtures/try/try.rb

@@ -20,7 +20,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-once($fb).query("(and (exists number) (lt time #{Time.now.utc.iso8601}))").each do |f|
+each_once($fb, "(and (exists number) (lt time #{Time.now.utc.iso8601}))") do |f|
   n = $fb.insert
   n.guess = f.number
 end

data/judges.gemspec

@@ -26,14 +26,15 @@ 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.0.33'
+  s.version = '0.0.35'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
-  s.description = '
-  Runs a collection of \"judges\" against a \"factbase,\" modifying it and updating.
-  Also, helps printing a factbase, merge with another one, inspect, and so on.
-  Also, helps run automated tests for a set of judges.
-  '
+  s.description =
+    'A command-line tool that runs a collection of \"judges\" ' \
+    'against a \"factbase,\" modifying ' \
+    'it and updating. Also, helps printing a factbase, merge with ' \
+    'another one, inspect, and so on. Also, helps run automated tests ' \
+    'for a set of judges.'
   s.authors = ['Yegor Bugayenko']
   s.email = 'yegor256@gmail.com'
   s.homepage = 'http://github.com/yegor256/judges'
@@ -42,9 +43,12 @@ Gem::Specification.new do |s|
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md', 'LICENSE.txt']
   s.add_runtime_dependency 'backtrace', '~> 0.3'
-  s.add_runtime_dependency 'factbase', '~>0.0.32'
+  s.add_runtime_dependency 'concurrent-ruby', '1.2.3'
+  s.add_runtime_dependency 'factbase', '~>0.0.38'
   s.add_runtime_dependency 'gli', '~>2.21'
+  s.add_runtime_dependency 'iri', '~>0.8'
   s.add_runtime_dependency 'loog', '~>0.2'
   s.add_runtime_dependency 'nokogiri', '~> 1.10'
+  s.add_runtime_dependency 'typhoeus', '~>1.3'
   s.metadata['rubygems_mfa_required'] = 'true'
 end

data/lib/judges/baza.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+require 'typhoeus'
+require 'iri'
+require 'loog'
+require_relative '../judges'
+require_relative '../judges/elapsed'
+
+# Baza.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Judges::Baza
+  # rubocop:disable Metrics/ParameterLists
+  def initialize(host, port, token, ssl: true, timeout: 5, loog: Loog::NULL)
+    # rubocop:enable Metrics/ParameterLists
+    @host = host
+    @port = port
+    @ssl = ssl
+    @token = token
+    @timeout = timeout
+    @loog = loog
+  end
+
+  def push(name, data)
+    id = 0
+    elapsed(@loog) do
+      ret = Typhoeus::Request.put(
+        home.append('push').append(name).to_s,
+        body: data,
+        headers: headers.merge(
+          'Content-type' => 'application/x-www-form-urlencoded'
+        ),
+        connecttimeout: @timeout,
+        timeout: @timeout
+      )
+      check_code(ret)
+      id = ret.body.to_i
+      throw :"Pushed #{data.size} bytes to #{@host}, job ID is ##{id}"
+    end
+    id
+  end
+
+  def pull(id)
+    data = 0
+    elapsed(@loog) do
+      Tempfile.open do |file|
+        File.open(file, 'wb') do |f|
+          request = Typhoeus::Request.new(
+            home.append('pull').append("#{id}.fb").to_s,
+            headers:,
+            connecttimeout: @timeout,
+            timeout: @timeout
+          )
+          request.on_body do |chunk|
+            f.write(chunk)
+          end
+          request.run
+          check_code(request.response)
+        end
+        data = File.binread(file)
+        throw :"Pulled #{data.size} bytes of job ##{id} factbase at #{@host}"
+      end
+    end
+    data
+  end
+
+  # The job with this ID is finished already?
+  def finished?(id)
+    finished = false
+    elapsed(@loog) do
+      ret = Typhoeus::Request.get(
+        home.append('finished').append(id).to_s,
+        headers:
+      )
+      check_code(ret)
+      finished = ret.body == 'yes'
+      throw :"The job ##{id} is #{finished ? '' : 'not yet '}finished at #{@host}"
+    end
+    finished
+  end
+
+  def recent(name)
+    job = 0
+    elapsed(@loog) do
+      ret = Typhoeus::Request.get(
+        home.append('recent').append("#{name}.txt").to_s,
+        headers:
+      )
+      check_code(ret)
+      job = ret.body.to_i
+      throw :"The recent \"#{name}\" job's ID is ##{job} at #{@host}"
+    end
+    job
+  end
+
+  def name_exists?(name)
+    exists = 0
+    elapsed(@loog) do
+      ret = Typhoeus::Request.get(
+        home.append('exists').append(name).to_s,
+        headers:
+      )
+      check_code(ret)
+      exists = ret.body == 'yes'
+      throw :"The name \"#{name}\" #{exists ? 'exists' : "doesn't exist"} at #{@host}"
+    end
+    exists
+  end
+
+  private
+
+  def headers
+    {
+      'User-Agent': "judges #{Judges::VERSION}",
+      Connection: 'close',
+      'X-Zerocracy-Token': @token
+    }
+  end
+
+  def home
+    Iri.new('')
+      .host(@host)
+      .port(@port)
+      .scheme(@ssl ? 'https' : 'http')
+  end
+
+  def check_code(ret, allowed = [200])
+    allowed = [allowed] unless allowed.is_a?(Array)
+    mtd = (ret.request.original_options[:method] || '???').upcase
+    url = ret.effective_url
+    @loog.debug(
+      "#{mtd} #{url} -> #{ret.code}\n  " \
+      "#{(ret.headers || {}).map { |k, v| "#{k}: #{v}" }.join("\n  ")}"
+    )
+    return if allowed.include?(ret.code)
+    msg =
+      "Invalid response code ##{ret.code} " \
+      "at #{mtd} #{url} (#{ret.headers['X-Zerocracy-Flash']})"
+    if ret.code == 503
+      msg +=
+        ', most probably it\'s an internal error on the server, ' \
+        'please report this to https://github.com/yegor256/judges'
+    elsif ret.code == 404
+      msg +=
+        ', most probably you are trying to reach a wrong server, which doesn\'t ' \
+        'have the URL that it is expected to have'
+    end
+    raise msg
+  end
+end

data/lib/judges/categories.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+require_relative '../judges'
+
+# Categories of tests.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Judges::Categories
+  # Ctor.
+  # @param [Array<String>] enable List of categories to enable
+  # @param [Array<String>] disable List of categories to enable
+  def initialize(enable, disable)
+    @enable = enable.is_a?(Array) ? enable : []
+    @disable = disable.is_a?(Array) ? disable : []
+  end
+
+  # This test is good to go, with this list of categories?
+  # @param [Array<String>] cats List of them
+  # @return [Boolean] True if yes
+  def ok?(cats)
+    cats = [] if cats.nil?
+    cats = [cats] unless cats.is_a?(Array)
+    cats.each do |c|
+      return false if @disable.any? { |d| d == c }
+      return true if @enable.any? { |d| d == c }
+    end
+    return true if @enable.empty?
+    false
+  end
+end

data/lib/judges/commands/print.rb

@@ -48,7 +48,7 @@ class Judges::Print
     end
     FileUtils.mkdir_p(File.dirname(o))
     if !opts['force'] && File.exist?(o)
-      if File.mtime(f) < File.mtime(o)
+      if File.mtime(f) <= File.mtime(o)
         @loog.info("No need to print to #{o.to_rel}, since it's up to date (#{File.size(o)} bytes)")
         return
       end

data/lib/judges/commands/pull.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+require 'typhoeus'
+require 'iri'
+require_relative '../../judges'
+require_relative '../../judges/impex'
+require_relative '../../judges/baza'
+
+# Pull.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Judges::Pull
+  def initialize(loog)
+    @loog = loog
+  end
+
+  def run(opts, args)
+    raise 'Exactly two arguments required' unless args.size == 2
+    fb = Factbase.new
+    baza = Judges::Baza.new(
+      opts['host'], opts['port'].to_i, opts['token'],
+      ssl: opts['ssl'],
+      timeout: (opts['timeout'] || 5).to_i,
+      loog: @loog
+    )
+    name = args[0]
+    elapsed(@loog) do
+      if baza.name_exists?(name)
+        fb.import(baza.pull(wait(baza, baza.recent(name))))
+        Judges::Impex.new(@loog, args[1]).export(fb)
+        throw :"Pulled #{fb.size} facts by the name '#{name}'"
+      else
+        throw :"There is nothing to pull, the name '#{name}' is absent on the server"
+      end
+    end
+  end
+
+  private
+
+  def wait(baza, id)
+    start = Time.now
+    loop do
+      break if baza.finished?(id)
+      sleep 1
+      raise 'Time is over, the job is still not finished' if Time.now - start > 10 * 60
+    end
+    id
+  end
+end