judges 0.0.34 → 0.0.35

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d6543b9b405aa797aa98883b8294c15e61215db07121c7c0e4616081f9457de
-  data.tar.gz: 86c543a69bf748262f0f1072f151f8e1f3de9f8d015192699d811d809452328c
+  metadata.gz: 410f436fd79010f188d3768f992bef64ddc4a445773e2c790aacc059597ea227
+  data.tar.gz: d9eeba81aa97bb9f62ab370aee3e9a3fbaee752f5b1e41df5d33387aece0a151
 SHA512:
-  metadata.gz: a487dade2d9e24c24298aab0132fdf653688a2133904c2cad712692762759e9fe8c3e9076e99d09b67a73b8a2580445600ffb2766db0a6d4ef01052de2163392
-  data.tar.gz: 76111d01a21353718aadde66a0af44d5b341bce928c670704298118ffa8cd0d147e5d50ce21329d7a1adb69e0241243a6a2c3af273d0f6e126bb49fff9618c82
+  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/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)
+      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,6 +82,8 @@ GEM
     docile (1.4.0)
     drb (2.2.1)
     erubi (1.12.0)
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
     factbase (0.0.38)
       json (~> 2.7)
       loog (~> 0.2)
@@ -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,9 +218,15 @@ 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)
@@ -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

@@ -147,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/judges.gemspec

@@ -26,7 +26,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.0.34'
+  s.version = '0.0.35'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
   s.description =
@@ -43,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 '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/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

data/lib/judges/commands/push.rb

@@ -0,0 +1,53 @@
+# 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'
+
+# Push.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Judges::Push
+  def initialize(loog)
+    @loog = loog
+  end
+
+  def run(opts, args)
+    raise 'Exactly two arguments required' unless args.size == 2
+    name = args[0]
+    fb = Judges::Impex.new(@loog, args[1]).import
+    baza = Judges::Baza.new(
+      opts['host'], opts['port'].to_i, opts['token'],
+      ssl: opts['ssl'],
+      timeout: (opts['timeout'] || 5).to_i,
+      loog: @loog
+    )
+    elapsed(@loog) do
+      id = baza.push(name, fb.export)
+      throw :"Pushed #{fb.size} facts, job ID is #{id}"
+    end
+  end
+end

data/lib/judges/commands/update.rb

@@ -57,9 +57,12 @@ class Judges::Update
         end
         diff = cycle(opts, packs, fb, options)
         impex.export(fb)
-        break if diff.zero?
+        if diff.zero?
+          @loog.info("The update cycle ##{c} has made no changes to the factbase, let's stop")
+          break
+        end
         if !opts['max-cycles'].nil? && c >= opts['max-cycles']
-          @loog.info('Too many cycles already, as set by --max-cycles, breaking')
+          @loog.info("Too many cycles already, as set by --max-cycles=#{opts['max-cycles']}, breaking")
           break
         end
         @loog.info(

data/lib/judges.rb

@@ -25,5 +25,5 @@
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko
 # License:: MIT
 module Judges
-  VERSION = '0.0.34'
+  VERSION = '0.0.35'
 end

data/test/commands/test_pull.rb

@@ -0,0 +1,58 @@
+# 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 'minitest/autorun'
+require 'webmock/minitest'
+require 'loog'
+require 'factbase'
+require_relative '../../lib/judges'
+require_relative '../../lib/judges/commands/pull'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class TestPull < Minitest::Test
+  def test_pull_simple_factbase
+    WebMock.disable_net_connect!
+    stub_request(:get, 'http://example.org/exists/foo').to_return(body: 'yes')
+    stub_request(:get, 'http://example.org/recent/foo.txt').to_return(body: '42')
+    stub_request(:get, 'http://example.org/finished/42').to_return(body: 'yes')
+    fb = Factbase.new
+    fb.insert.foo = 42
+    stub_request(:get, 'http://example.org/pull/42.fb').to_return(body: fb.export)
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'base.fb')
+      Judges::Pull.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 80,
+          'ssl' => false
+        },
+        ['foo', file]
+      )
+      fb = Factbase.new
+      fb.import(File.binread(file))
+    end
+  end
+end

data/test/commands/test_push.rb

@@ -0,0 +1,77 @@
+# 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 'minitest/autorun'
+require 'webmock/minitest'
+require 'loog'
+require_relative '../../lib/judges'
+require_relative '../../lib/judges/commands/push'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class TestPush < Minitest::Test
+  def test_push_simple_factbase
+    WebMock.disable_net_connect!
+    stub_request(:put, 'https://example.org/push/foo').to_return(
+      status: 200, body: '42'
+    )
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'base.fb')
+      fb = Factbase.new
+      fb.insert.foo_bar = 42
+      File.binwrite(file, fb.export)
+      Judges::Push.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 443,
+          'ssl' => true
+        },
+        ['foo', file]
+      )
+    end
+  end
+
+  def test_fails_on_http_error
+    WebMock.disable_net_connect!
+    stub_request(:put, 'http://example.org/push/foo').to_return(status: 500)
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'base.fb')
+      fb = Factbase.new
+      fb.insert.foo_bar = 42
+      File.binwrite(file, fb.export)
+      assert_raises do
+        Judges::Push.new(Loog::NULL).run(
+          {
+            'token' => '000',
+            'host' => 'example.org',
+            'port' => 80,
+            'ssl' => false
+          },
+          ['foo', file]
+        )
+      end
+    end
+  end
+end

data/test/test_baza.rb

@@ -0,0 +1,75 @@
+# 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 'minitest/autorun'
+require 'webmock/minitest'
+require 'loog'
+require_relative '../lib/judges'
+require_relative '../lib/judges/baza'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class TestBaza < Minitest::Test
+  def test_simple_push
+    WebMock.disable_net_connect!
+    stub_request(:put, 'https://example.org/push/simple').to_return(
+      status: 200, body: '42'
+    )
+    assert_equal(
+      42,
+      Judges::Baza.new('example.org', 443, '000').push('simple', 'hello, world!')
+    )
+  end
+
+  def test_simple_recent_check
+    WebMock.disable_net_connect!
+    stub_request(:get, 'https://example.org/recent/simple.txt').to_return(
+      status: 200, body: '42'
+    )
+    assert_equal(
+      42,
+      Judges::Baza.new('example.org', 443, '000').recent('simple')
+    )
+  end
+
+  def test_simple_exists_check
+    WebMock.disable_net_connect!
+    stub_request(:get, 'https://example.org/exists/simple').to_return(
+      status: 200, body: 'yes'
+    )
+    assert(
+      Judges::Baza.new('example.org', 443, '000').name_exists?('simple')
+    )
+  end
+
+  def test_simple_pull
+    WebMock.disable_net_connect!
+    stub_request(:get, 'https://example.org/pull/333.fb').to_return(
+      status: 200, body: 'hello, world!'
+    )
+    assert(
+      Judges::Baza.new('example.org', 443, '000').pull(333).start_with?('hello')
+    )
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.0.34
+  version: 0.0.35
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-27 00:00:00.000000000 Z
+date: 2024-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.3
 - !ruby/object:Gem::Dependency
   name: factbase
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.21'
+- !ruby/object:Gem::Dependency
+  name: iri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: loog
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
 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.
@@ -118,6 +160,8 @@ files:
 - features/join.feature
 - features/misc.feature
 - features/print.feature
+- features/pull.feature
+- features/push.feature
 - features/step_definitions/steps.rb
 - features/support/env.rb
 - features/test.feature
@@ -130,12 +174,15 @@ files:
 - fixtures/try/try.rb
 - judges.gemspec
 - lib/judges.rb
+- lib/judges/baza.rb
 - lib/judges/categories.rb
 - lib/judges/commands/eval.rb
 - lib/judges/commands/import.rb
 - lib/judges/commands/inspect.rb
 - lib/judges/commands/join.rb
 - lib/judges/commands/print.rb
+- lib/judges/commands/pull.rb
+- lib/judges/commands/push.rb
 - lib/judges/commands/test.rb
 - lib/judges/commands/trim.rb
 - lib/judges/commands/update.rb
@@ -153,12 +200,15 @@ files:
 - test/commands/test_inspect.rb
 - test/commands/test_join.rb
 - test/commands/test_print.rb
+- test/commands/test_pull.rb
+- test/commands/test_push.rb
 - test/commands/test_test.rb
 - test/commands/test_trim.rb
 - test/commands/test_update.rb
 - test/fb/test_if_absent.rb
 - test/fb/test_once.rb
 - test/test__helper.rb
+- test/test_baza.rb
 - test/test_categories.rb
 - test/test_impex.rb
 - test/test_judges.rb