judges 0.46.0 → 0.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5480ce66a6fbce4d6748a47f42240c77438ef09eed639f6744c762f94ce57ebe
-  data.tar.gz: a445e36911b5dcc457a188fb1ff7a50251f6e19b60313c1185b4af70a773acdc
+  metadata.gz: 104c3aa90435ddf336588ca607ae35e029fbe1e8a03ac4a2efc0f9377be46f49
+  data.tar.gz: e3d467f54ff1df3f5f4c07b1f1545bbd8543bd00af58bea82e4f9160c00885ec
 SHA512:
-  metadata.gz: d4a52cb96f912acb0a97d842f132c2daf855771406253e9ff0bd5b2fa2ba17cbdb15b4e12919b8e41092b7ebc07c954c7fafbaaf4029eb57387075d9cd46e679
-  data.tar.gz: 59d5df2eea5c531989709a7e60c183a4f8f10723e6e0df320ca58ce2a6a2f167c236713a110814eab49d91996e659e2e3ac5fb255a95a6a8516ebec9f874351c
+  metadata.gz: 8b3d6c28de5880acb591607a3c2cc02d1c8cd1f1963df54c989d7719bc3dcd44963a711f9260bcde7c40c45937a80e485f6ff37a3dcff4932a618a94e9fa4e55
+  data.tar.gz: a92d912ba0a01291ed6b990d59f26ec6ac2e5d90ab0d5b92a6dad5e26ca7d9e3f412d79017c1db1effcbd18177376b87354d61f815aca14aeeb0ad87de73c96c

data/Gemfile.lock

@@ -28,18 +28,18 @@ GEM
     ast (2.4.3)
     backtrace (0.4.1)
     base64 (0.3.0)
-    baza.rb (0.5.1)
-      backtrace (> 0)
-      elapsed (> 0)
-      faraday (> 0)
-      faraday-http-cache (> 0)
-      faraday-multipart (> 0)
-      faraday-retry (> 0)
-      iri (> 0)
-      loog (> 0)
-      retries (~> 0)
-      tago (~> 0)
-      typhoeus (~> 1.3)
+    baza.rb (0.6.0)
+      backtrace (~> 0.4)
+      elapsed (~> 0.0)
+      faraday (~> 2.13)
+      faraday-http-cache (~> 2.5)
+      faraday-multipart (~> 1.1)
+      faraday-retry (~> 2.3)
+      iri (~> 0.11)
+      loog (~> 0.6)
+      retries (~> 0.0)
+      tago (~> 0.0)
+      typhoeus (~> 1.4)
     bigdecimal (3.2.2)
     builder (3.3.0)
     concurrent-ruby (1.3.5)

data/bin/judges

@@ -217,6 +217,44 @@ class JudgesGLI extend GLI::App
     c.flag([:retries], type: Integer, default_value: 3)
     run_it(c, 'pull')
   end
+
+  desc 'Download a durable from the server by ID'
+  command :download do |c|
+    c.desc 'Authentication token'
+    c.flag([:token])
+    c.desc 'Server IP/hostname'
+    c.flag([:host], default_value: 'api.zerocracy.com')
+    c.desc 'Server TCP port number'
+    c.flag([:port], default_value: 443, type: Integer)
+    c.desc 'Connection and read timeout in seconds'
+    c.flag([:timeout], default_value: 30, type: Integer)
+    c.desc 'Enable SSL connection'
+    c.switch([:ssl], default_value: true)
+    c.desc 'Unique identifier for the operation'
+    c.flag([:owner], default_value: 'default', type: String)
+    c.desc 'Number of retry attempts'
+    c.flag([:retries], type: Integer, default_value: 3)
+    run_it(c, 'download')
+  end
+
+  desc 'Upload a file as a durable to the server'
+  command :upload do |c|
+    c.desc 'Authentication token'
+    c.flag([:token])
+    c.desc 'Server IP/hostname'
+    c.flag([:host], default_value: 'api.zerocracy.com')
+    c.desc 'Server TCP port number'
+    c.flag([:port], default_value: 443, type: Integer)
+    c.desc 'Connection and read timeout in seconds'
+    c.flag([:timeout], default_value: 30, type: Integer)
+    c.desc 'Enable SSL connection'
+    c.switch([:ssl], default_value: true)
+    c.desc 'Unique identifier for the operation'
+    c.flag([:owner], default_value: 'default', type: String)
+    c.desc 'Number of retry attempts'
+    c.flag([:retries], type: Integer, default_value: 3)
+    run_it(c, 'upload')
+  end
 end
 
 exit JudgesGLI.run(ARGV) if ENV['GLI_TESTING'].nil?

data/features/pull.feature

@@ -7,6 +7,6 @@ Feature: Pull
   Scenario: Pull a small factbase, which is absent on the server
     Given We are online
     Given I make a temp directory
-    Then I run bin/judges with "--verbose pull --token 00000000-0000-0000-0000-000000000000 --wait=15 {FAKE-NAME} simple.fb"
+    Then I run bin/judges with "--verbose pull --token ZRCY-00000000-0000-0000-0000-000000000000 --wait=15 {FAKE-NAME} simple.fb"
     Then Stdout contains "doesn't exist at api.zerocracy.com"
     And Exit code is zero

data/features/push.feature

@@ -9,6 +9,6 @@ Feature: Push
     Given I make a temp directory
     Then I run bin/judges with "--verbose eval simple.fb '(0..1000).each { $fb.insert.foo = 42 }'"
     And Exit code is zero
-    Then I run bin/judges with "push --token 00000000-0000-0000-0000-000000000000 --meta a:b --meta foo:bar --meta=pages_url:https://zerocracy.github.io/zerocracy.html --meta=duration:1055 {FAKE-NAME} simple.fb"
+    Then I run bin/judges with "push --token ZRCY-00000000-0000-0000-0000-000000000000 --meta a:b --meta foo:bar --meta=pages_url:https://zerocracy.github.io/zerocracy.html --meta=duration:1055 {FAKE-NAME} simple.fb"
     Then Stdout contains "Pushed"
     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.46.0'
+  s.version = '0.47.0'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
   s.description =

data/lib/judges/commands/download.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'typhoeus'
+require 'iri'
+require 'baza-rb'
+require 'elapsed'
+require_relative '../../judges'
+
+# The +download+ command.
+#
+# This class is instantiated by the +bin/judge+ command line interface. You
+# are not supposed to instantiate it yourself.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# License:: MIT
+class Judges::Download
+  # Initialize.
+  # @param [Loog] loog Logging facility
+  def initialize(loog)
+    @loog = loog
+  end
+
+  # Run the download 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
+    jname = args[0]
+    path = args[1]
+    name = File.basename(path)
+    baza = BazaRb.new(
+      opts['host'], opts['port'].to_i, opts['token'],
+      ssl: opts['ssl'],
+      timeout: (opts['timeout'] || 30).to_i,
+      loog: @loog,
+      retries: (opts['retries'] || 3).to_i
+    )
+    elapsed(@loog, level: Logger::INFO) do
+      id = baza.durable_find(jname, name)
+      if id.nil?
+        @loog.info("Durable '#{name}' not found in '#{jname}'")
+        return
+      end
+      @loog.info("Durable ##{id} ('#{name}') found in '#{jname}'")
+      baza.durable_lock(id, opts['owner'] || 'default')
+      begin
+        baza.durable_load(id, path)
+        size = File.size(path)
+        throw :"👍 Downloaded durable ##{id} to #{path} (#{size} bytes)"
+      ensure
+        baza.durable_unlock(id, opts['owner'] || 'default')
+      end
+    end
+  end
+end

data/lib/judges/commands/upload.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'typhoeus'
+require 'iri'
+require 'baza-rb'
+require 'elapsed'
+require_relative '../../judges'
+
+# The +upload+ command.
+#
+# This class is instantiated by the +bin/judge+ command line interface. You
+# are not supposed to instantiate it yourself.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# License:: MIT
+class Judges::Upload
+  # Initialize.
+  # @param [Loog] loog Logging facility
+  def initialize(loog)
+    @loog = loog
+  end
+
+  # Run the upload 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
+    jname = args[0]
+    path = args[1]
+    raise "File not found: #{path}" unless File.exist?(path)
+    name = File.basename(path)
+    baza = BazaRb.new(
+      opts['host'], opts['port'].to_i, opts['token'],
+      ssl: opts['ssl'],
+      timeout: (opts['timeout'] || 30).to_i,
+      loog: @loog,
+      retries: (opts['retries'] || 3).to_i
+    )
+    elapsed(@loog, level: Logger::INFO) do
+      id = baza.durable_find(jname, name)
+      size = File.size(path)
+      if id.nil? || id.to_s.strip.empty?
+        id = baza.durable_place(jname, path)
+        throw :"👍 Uploaded #{path} to new durable '#{name}' in '#{jname}' (ID: #{id}, #{size} bytes)"
+      else
+        id = id.to_i
+        baza.durable_lock(id, opts['owner'] || 'default')
+        begin
+          baza.durable_save(id, path)
+          throw :"👍 Uploaded #{path} to existing durable '#{name}' in '#{jname}' (ID: #{id}, #{size} bytes)"
+        ensure
+          baza.durable_unlock(id, opts['owner'] || 'default')
+        end
+      end
+    end
+  end
+end

data/lib/judges.rb

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

data/test/commands/test_download.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'loog'
+require 'webmock/minitest'
+require_relative '../../lib/judges'
+require_relative '../../lib/judges/commands/download'
+require_relative '../test__helper'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# License:: MIT
+class TestDownload < Minitest::Test
+  def test_download_simple_durable
+    WebMock.disable_net_connect!
+    content = 'Hello, World!'
+    stub_request(:get, 'https://example.org/durables/find?file=downloaded.txt&jname=myjudge').to_return(
+      status: 200, body: '42'
+    )
+    stub_request(:get, 'https://example.org/durables/42/lock?owner=default').to_return(status: 302)
+    stub_request(:get, 'https://example.org/durables/42').to_return(
+      status: 200, body: content
+    )
+    stub_request(:get, 'https://example.org/durables/42/unlock?owner=default').to_return(status: 302)
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'downloaded.txt')
+      Judges::Download.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 443,
+          'ssl' => true,
+          'owner' => 'default'
+        },
+        ['myjudge', file]
+      )
+      assert_equal(content, File.read(file))
+    end
+  end
+
+  def test_download_with_custom_owner
+    WebMock.disable_net_connect!
+    content = 'Custom content'
+    stub_request(:get, 'http://example.org/durables/find?file=data.bin&jname=judge1').to_return(
+      status: 200, body: '123'
+    )
+    stub_request(:get, 'http://example.org/durables/123/lock?owner=custom').to_return(status: 302)
+    stub_request(:get, 'http://example.org/durables/123').to_return(
+      status: 200, body: content
+    )
+    stub_request(:get, 'http://example.org/durables/123/unlock?owner=custom').to_return(status: 302)
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'data.bin')
+      Judges::Download.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 80,
+          'ssl' => false,
+          'owner' => 'custom'
+        },
+        ['judge1', file]
+      )
+      assert_equal(content, File.read(file))
+    end
+  end
+
+  def test_fails_on_http_error
+    WebMock.disable_net_connect!
+    stub_request(:get, 'http://example.org/durables/find?file=test.txt&jname=somejudge').to_return(
+      status: 200, body: '99'
+    )
+    stub_request(:get, 'http://example.org/durables/99/lock?owner=none').to_return(status: 302)
+    stub_request(:get, 'http://example.org/durables/99').to_return(status: 404)
+    stub_request(:get, 'http://example.org/durables/99/unlock?owner=none').to_return(status: 302)
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'test.txt')
+      assert_raises(StandardError) do
+        Judges::Download.new(Loog::NULL).run(
+          {
+            'token' => '000',
+            'host' => 'example.org',
+            'port' => 80,
+            'ssl' => false,
+            'owner' => 'none'
+          },
+          ['somejudge', file]
+        )
+      end
+    end
+  end
+
+  def test_fails_with_wrong_number_of_arguments
+    assert_raises(RuntimeError) do
+      Judges::Download.new(Loog::NULL).run({}, ['only_one_arg'])
+    end
+    assert_raises(RuntimeError) do
+      Judges::Download.new(Loog::NULL).run({}, %w[too many args])
+    end
+  end
+
+  def test_handles_not_found_durable
+    WebMock.disable_net_connect!
+    stub_request(:get, 'http://example.org/durables/find?file=missing.txt&jname=notfound').to_return(
+      status: 404
+    )
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'missing.txt')
+      Judges::Download.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 80,
+          'ssl' => false
+        },
+        ['notfound', file]
+      )
+      refute_path_exists(file)
+    end
+  end
+end

data/test/commands/test_update.rb

@@ -162,7 +162,7 @@ class TestUpdate < Minitest::Test
       save_it(File.join(d, 'first/first.rb'), '$global[:fb] ||= $fb; 2 + 2')
       save_it(File.join(d, 'second/second.rb'), '$global[:fb] ||= $fb; $global[:fb].insert')
       file = File.join(d, 'base.fb')
-      Judges::Update.new(Loog::VERBOSE).run(
+      Judges::Update.new(Loog::NULL).run(
         { 'max-cycles' => 3, 'boost' => 'first' },
         [d, file]
       )

data/test/commands/test_upload.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'loog'
+require 'webmock/minitest'
+require_relative '../../lib/judges'
+require_relative '../../lib/judges/commands/upload'
+require_relative '../test__helper'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# License:: MIT
+class TestUpload < Minitest::Test
+  def test_upload_simple_durable
+    WebMock.disable_net_connect!
+    content = 'Hello, World!'
+    stub_request(:get, 'https://example.org/durables/find?file=upload.txt&jname=myjudge').to_return(
+      status: 404
+    )
+    stub_request(:get, 'https://example.org/csrf').to_return(
+      status: 200, body: 'test-csrf-token'
+    )
+    stub_request(:post, 'https://example.org/durables/place').to_return(
+      status: 302, headers: { 'X-Zerocracy-DurableId' => '42' }
+    )
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'upload.txt')
+      File.write(file, content)
+      Judges::Upload.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 443,
+          'ssl' => true,
+          'owner' => 'default'
+        },
+        ['myjudge', file]
+      )
+    end
+  end
+
+  def test_upload_with_custom_owner
+    WebMock.disable_net_connect!
+    content = 'Binary data here'
+    stub_request(:get, 'http://example.org/durables/find?file=data.bin&jname=judge1').to_return(
+      status: 200, body: '123'
+    )
+    stub_request(:get, 'http://example.org/durables/123/lock?owner=custom').to_return(status: 302)
+    stub_request(:put, 'http://example.org/durables/123').to_return(status: 200)
+    stub_request(:get, 'http://example.org/durables/123/unlock?owner=custom').to_return(status: 302)
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'data.bin')
+      File.write(file, content)
+      Judges::Upload.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 80,
+          'ssl' => false,
+          'owner' => 'custom'
+        },
+        ['judge1', file]
+      )
+    end
+  end
+
+  def test_fails_on_http_error
+    WebMock.disable_net_connect!
+    stub_request(:get, 'http://example.org/durables/find?file=test.txt&jname=somejudge').to_return(
+      status: 404
+    )
+    stub_request(:get, 'http://example.org/csrf').to_return(
+      status: 200, body: 'test-csrf-token'
+    )
+    stub_request(:post, 'http://example.org/durables/place').to_return(status: 500)
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'test.txt')
+      File.write(file, 'content')
+      assert_raises(StandardError) do
+        Judges::Upload.new(Loog::NULL).run(
+          {
+            'token' => '000',
+            'host' => 'example.org',
+            'port' => 80,
+            'ssl' => false,
+            'owner' => 'none'
+          },
+          ['somejudge', file]
+        )
+      end
+    end
+  end
+
+  def test_fails_with_wrong_number_of_arguments
+    assert_raises(RuntimeError) do
+      Judges::Upload.new(Loog::NULL).run({}, ['only_one_arg'])
+    end
+    assert_raises(RuntimeError) do
+      Judges::Upload.new(Loog::NULL).run({}, %w[too many args])
+    end
+  end
+
+  def test_fails_when_file_does_not_exist
+    assert_raises(RuntimeError) do
+      Judges::Upload.new(Loog::NULL).run(
+        {
+          'token' => '000',
+          'host' => 'example.org',
+          'port' => 80,
+          'ssl' => false
+        },
+        ['myjudge', '/nonexistent/file.txt']
+      )
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.46.0
+  version: 0.47.0
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -297,6 +297,7 @@ files:
 - judges.gemspec
 - lib/judges.rb
 - lib/judges/categories.rb
+- lib/judges/commands/download.rb
 - lib/judges/commands/eval.rb
 - lib/judges/commands/import.rb
 - lib/judges/commands/inspect.rb
@@ -307,6 +308,7 @@ files:
 - lib/judges/commands/test.rb
 - lib/judges/commands/trim.rb
 - lib/judges/commands/update.rb
+- lib/judges/commands/upload.rb
 - lib/judges/impex.rb
 - lib/judges/judge.rb
 - lib/judges/judges.rb
@@ -315,6 +317,7 @@ files:
 - package-lock.json
 - package.json
 - renovate.json
+- test/commands/test_download.rb
 - test/commands/test_eval.rb
 - test/commands/test_import.rb
 - test/commands/test_inspect.rb
@@ -325,6 +328,7 @@ files:
 - test/commands/test_test.rb
 - test/commands/test_trim.rb
 - test/commands/test_update.rb
+- test/commands/test_upload.rb
 - test/test__helper.rb
 - test/test_bin.rb
 - test/test_categories.rb