judges 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01de840b5ca098985b5b4cbdc1ea16d96237d3bbed4617971662f5628fad46bf
-  data.tar.gz: e502a04924b0186921fbbc2026e4f7d78eed0ee47ec2f6cdfcfb01c65e092050
+  metadata.gz: 5dc4d51701430ff754d2fb33b4938d6ad105f0d08590c875c88095b0992bab17
+  data.tar.gz: 7b5b223a403e3d5d82128589a4838ac66b8518644e0c110e5a688e6139fa92d6
 SHA512:
-  metadata.gz: 38e602fda2bc3a1cce738e1633094d7dc0bc8a50fb43ff97e1e28d4da36752bbdb56fac51f98a2cec884b7a3245b701566c7500d817f4a242fbfb0c28cd9b62d
-  data.tar.gz: d9d5761f6384e7898da2cbab0b39a659d22f91a1af61a834f52c038f0162b8ebf08f576a8ea846b9a3818fb5f822c6d018552478d979365fa0226955f7cdc5d3
+  metadata.gz: 5a293823a64b90aa7edb793b4d9fc35c7e06d7012d70073e96a9080232d48b5c12ec0f0f1b20759412eb033a4921cbeef43129101050c784b90ecf11e55d4900
+  data.tar.gz: 5cd0c89a797662738454256c960afa5edf46b77e6109157cb8d8d44c534a130a7dcd0522dfe5091c878f7e9f3c0a7e95c1f47c283696ba4cd0fb7e592e61d3de

data/Gemfile.lock

@@ -79,7 +79,7 @@ GEM
       bigdecimal
     cucumber-gherkin (27.0.0)
       cucumber-messages (>= 19.1.4, < 23)
-    cucumber-html-formatter (21.4.0)
+    cucumber-html-formatter (21.4.1)
       cucumber-messages (> 19, < 25)
     cucumber-messages (22.0.0)
     cucumber-tag-expressions (6.1.0)
@@ -90,14 +90,14 @@ GEM
     erubi (1.13.0)
     ethon (0.16.0)
       ffi (>= 1.15.0)
-    factbase (0.0.60)
-      backtrace (~> 0.3)
-      decoor (~> 0.0)
+    factbase (0.2.0)
+      backtrace (> 0)
+      decoor (> 0)
       json (~> 2.7)
-      loog (~> 0.2)
+      loog (> 0)
       nokogiri (~> 1.10)
-      others (~> 0.0)
-      tago (~> 0.0)
+      others (> 0)
+      tago (> 0)
       yaml (~> 0.3)
     ffi (1.17.0-aarch64-linux-gnu)
     ffi (1.17.0-arm-linux-gnu)
@@ -106,7 +106,7 @@ GEM
     ffi (1.17.0-x86-linux-gnu)
     ffi (1.17.0-x86_64-darwin)
     ffi (1.17.0-x86_64-linux-gnu)
-    gli (2.21.1)
+    gli (2.21.5)
     hashdiff (1.1.0)
     i18n (1.14.5)
       concurrent-ruby (~> 1.0)
@@ -187,7 +187,7 @@ GEM
     reline (0.5.9)
       io-console (~> 0.5)
     retries (0.0.5)
-    rexml (3.3.1)
+    rexml (3.3.2)
       strscan
     rspec-core (3.13.0)
       rspec-support (~> 3.13.0)

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

data/lib/judges/baza.rb

@@ -28,7 +28,12 @@ require 'base64'
 require_relative '../judges'
 require_relative '../judges/elapsed'
 
-# Baza.
+# Interface to the API of zerocracy.com.
+#
+# You make an instance of this class and then call one of its methods.
+# The object will make HTTP request to www.zerocracy.com and interpret the
+# results returned.
+#
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko
 # License:: MIT
@@ -43,6 +48,11 @@ class Judges::Baza
     @retries = retries
   end
 
+  # Push factbase to the server.
+  # @param [String] name The name of the job on the server
+  # @param [Bytes] data The data to push to the server (binary)
+  # @param [Array<String>] meta List of metas, possibly empty
+  # @return [Integer] Job ID on the server
   def push(name, data, meta)
     id = 0
     hdrs = headers.merge(
@@ -70,6 +80,9 @@ class Judges::Baza
     id
   end
 
+  # Pull factbase from the server.
+  # @param [Integer] id The ID of the job on the server
+  # @return [Bytes] Binary data pulled
   def pull(id)
     data = 0
     elapsed(@loog) do
@@ -99,6 +112,8 @@ class Judges::Baza
   end
 
   # The job with this ID is finished already?
+  # @param [Integer] id The ID of the job on the server
+  # @return [Boolean] TRUE if the job is already finished
   def finished?(id)
     finished = false
     elapsed(@loog) do
@@ -117,6 +132,8 @@ class Judges::Baza
   end
 
   # Lock the name.
+  # @param [String] name The name of the job on the server
+  # @param [String] owner The owner of the lock (any string)
   def lock(name, owner)
     elapsed(@loog) do
       with_retries(max_tries: @retries) do
@@ -132,6 +149,8 @@ class Judges::Baza
   end
 
   # Unlock the name.
+  # @param [String] name The name of the job on the server
+  # @param [String] owner The owner of the lock (any string)
   def unlock(name, owner)
     elapsed(@loog) do
       with_retries(max_tries: @retries) do
@@ -146,6 +165,9 @@ class Judges::Baza
     end
   end
 
+  # Get the ID of the job by the name.
+  # @param [String] name The name of the job on the server
+  # @return [Integer] The ID of the job on the server
   def recent(name)
     job = 0
     elapsed(@loog) do
@@ -163,6 +185,9 @@ class Judges::Baza
     job
   end
 
+  # Check whether the name of the job exists on the server.
+  # @param [String] name The name of the job on the server
+  # @return [Boolean] TRUE if such name exists
   def name_exists?(name)
     exists = 0
     elapsed(@loog) do

data/lib/judges/commands/eval.rb

@@ -25,7 +25,11 @@ require_relative '../../judges'
 require_relative '../../judges/impex'
 require_relative '../../judges/elapsed'
 
-# Eval.
+# The +eval+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/import.rb

@@ -27,7 +27,11 @@ require_relative '../../judges/impex'
 require_relative '../../judges/to_rel'
 require_relative '../../judges/elapsed'
 
-# Import.
+# The +import+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/inspect.rb

@@ -23,7 +23,11 @@
 require_relative '../../judges'
 require_relative '../../judges/impex'
 
-# Inspect.
+# The +inspect+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/join.rb

@@ -24,7 +24,11 @@ require_relative '../../judges'
 require_relative '../../judges/impex'
 require_relative '../../judges/elapsed'
 
-# Join.
+# The +join+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/print.rb

@@ -28,7 +28,11 @@ require_relative '../../judges'
 require_relative '../../judges/impex'
 require_relative '../../judges/elapsed'
 
-# Update.
+# The +print+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/pull.rb

@@ -26,7 +26,11 @@ require_relative '../../judges'
 require_relative '../../judges/impex'
 require_relative '../../judges/baza'
 
-# Pull.
+# The +pull+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/push.rb

@@ -26,7 +26,11 @@ require_relative '../../judges'
 require_relative '../../judges/impex'
 require_relative '../../judges/baza'
 
-# Push.
+# The +push+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/test.rb

@@ -32,7 +32,11 @@ require_relative '../../judges/options'
 require_relative '../../judges/categories'
 require_relative '../../judges/elapsed'
 
-# Test.
+# The +test+ 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 Yegor Bugayenko
 # License:: MIT
@@ -71,6 +75,7 @@ class Judges::Test
           @loog.info("🛠️ Testing #{f.to_rel}:")
           begin
             fb = Factbase.new
+            prepare(fb, yaml)
             yaml['before']&.each do |n|
               j = judges.get(n)
               @loog.info("Running #{j.script} judge as a pre-condition...")
@@ -113,7 +118,7 @@ class Judges::Test
     judges.any? { |n| n.match?(%r{^#{name}(/#{tre})?$}) }
   end
 
-  def test_one(fb, opts, judge, tname, yaml, assert: true)
+  def prepare(fb, yaml)
     inputs = yaml['input']
     inputs&.each do |i|
       f = fb.insert
@@ -127,6 +132,9 @@ class Judges::Test
         end
       end
     end
+  end
+
+  def test_one(fb, opts, judge, tname, yaml, assert: true)
     options = Judges::Options.new(opts['option']) + Judges::Options.new(yaml['options'])
     runs = opts['runs'] || yaml['runs'] || 1
     (1..runs).each do |r|

data/lib/judges/commands/trim.rb

@@ -25,7 +25,11 @@ require_relative '../../judges'
 require_relative '../../judges/impex'
 require_relative '../../judges/elapsed'
 
-# Trim.
+# The +trim+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/commands/update.rb

@@ -30,7 +30,11 @@ require_relative '../../judges/options'
 require_relative '../../judges/impex'
 require_relative '../../judges/elapsed'
 
-# Update.
+# The +update+ 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 Yegor Bugayenko
 # License:: MIT

data/lib/judges/judge.rb

@@ -46,6 +46,7 @@ class Judges::Judge
     $global = global
     $local = local
     $valve = FakeValve.new unless defined?($valve)
+    options.to_h.each { |k, v| ENV.store(k.to_s, v.to_s) }
     unless @lib.nil?
       raise "Lib dir #{@lib.to_rel} is absent" unless File.exist?(@lib)
       raise "Lib #{@lib.to_rel} is not a directory" unless File.directory?(@lib)

data/lib/judges.rb

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

data/test/commands/test_test.rb

@@ -92,25 +92,22 @@ class TestTest < Minitest::Test
     Dir.mktmpdir do |d|
       home = File.join(d, 'judges')
       FileUtils.mkdir_p(File.join(home, 'first'))
-      File.write(File.join(d, 'judges/first/the-first.rb'), '$fb.insert.foo = 42')
+      File.write(File.join(d, 'judges/first/the-first.rb'), 'x = $fb.size; $fb.insert.foo = x')
       FileUtils.mkdir_p(File.join(home, 'second'))
-      File.write(File.join(d, 'judges/second/the-second.rb'), '$fb.insert.foo = 55')
-      File.write(
-        File.join(d, 'judges/first/something.yml'),
-        <<-YAML
-        input: []
-        expected:
-          - /fb[count(f)=1]
-        YAML
-      )
+      File.write(File.join(d, 'judges/second/the-second.rb'), '$fb.insert.bar = 55')
       File.write(
         File.join(d, 'judges/second/something.yml'),
         <<-YAML
-        input: []
+        input:
+          -
+            hi: 42
         before:
           - first
         expected:
-          - /fb[count(f)=2]
+          - /fb[count(f)=3]
+          - /fb/f[hi=42]
+          - /fb/f[foo=1]
+          - /fb/f[bar=55]
         YAML
       )
       Judges::Test.new(Loog::NULL).run({}, [home])

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-17 00:00:00.000000000 Z
+date: 2024-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace