judges 0.0.10 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 550115852b44ae26b7af9cb776bcbf9e5b7e043579ab8eec3930854f573a6768
-  data.tar.gz: 7efe473542ffd401220d8e5b65d853ba144ad8ceab0273f9531e3d462e072afc
+  metadata.gz: 63754c5826506b6066688aa2373dafcd87fc20cd193631c15ce67f1496dc361b
+  data.tar.gz: a7c70946e0c24bffc91849d81e15866335ef0ebeb64b7f1cefd2c3d6c2d48506
 SHA512:
-  metadata.gz: '096f25e43ee418b94ae0a2f4b3d678c170170dfda2228191a269931bcfa1150e4f50151830e1132b3282ccaa768b2129deb8f29e55faebefd0bc7c2bd5ce2700'
-  data.tar.gz: d3f8922eeee30008f3883a7592667ce084a1d96785c4b04c51478c028ba99aa28eaddd151ac13a1bb7a101de8cc0f05434d22edcf6bbb1691b4bb76a4bd89067
+  metadata.gz: 6360db23fb5fc573d479a43d40b4c1d1e274bd21320cb4c2acba0e71a6ac8775c3398fef776dc1d7412ccd96782394e53d9631180c5a09314aab9e791738829a
+  data.tar.gz: e5b7a0c2460d589bf9cb69e42183585d13ac6ac1b400f338e3c73057be0d2fdb9c703bcc2896f73d8dbd5f850b22452d8f5a2b147e299a1ed9fd2b1aabe2f564

data/.github/workflows/codecov.yml

@@ -30,7 +30,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7
+          ruby-version: 3.2
       - run: bundle update
       - run: bundle exec rake
       - uses: codecov/codecov-action@v4.0.0-beta.3

data/.github/workflows/rake.yml

@@ -32,7 +32,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-20.04, macos-12]
-        ruby: [2.7, 3.2]
+        ruby: [3.2]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4

data/.rubocop.yml

@@ -49,3 +49,5 @@ Layout/EmptyLineAfterGuardClause:
   Enabled: false
 Layout/CaseIndentation:
   Enabled: false
+Naming/MethodParameterName:
+  MinNameLength: 2

data/bin/judges

@@ -29,53 +29,63 @@ require 'factbase'
 Encoding.default_external = Encoding::UTF_8
 Encoding.default_internal = Encoding::UTF_8
 
-class App
-  extend GLI::App
+include GLI::App
 
-  loog = Loog::REGULAR
+loog = Loog::REGULAR
 
-  program_desc 'Automated executor of judges for a factbase'
+program_desc('Automated executor of judges for a factbase')
 
-  version '0.0.10'
+version('0.0.12')
 
-  desc 'Make it more verbose, logging as much as possible'
-  switch([:v, :verbose])
+synopsis_format(:full)
 
-  pre do |global, command, options, args|
-    if global[:verbose]
-      loog = Loog::VERBOSE
-    end
-    true
+subcommand_option_handling(:normal)
+
+desc 'Make it more verbose, logging as much as possible'
+switch([:v, :verbose])
+
+pre do |global, command, options, args|
+  if global[:verbose]
+    loog = Loog::VERBOSE
+  end
+  true
+end
+
+desc 'Update the factbase by passing all judges one by one'
+command :update do |c|
+  c.desc 'Options to pass to every judge'
+  c.flag([:o, :option], default_value: 'yes', type: Array, arg_name: '<key=value>')
+  c.action do |global, options, args|
+    require_relative '../lib/judges/commands/update'
+    Judges::Update.new(loog).run(options, args)
   end
+end
 
-  desc 'Update the factbase by passing all judges one by one'
-  command :update do |c|
-    c.desc 'Environment variable to pass to every judge'
-    c.flag([:e, :environment], default_value: 'yes')
-    c.action do |global, options, args|
-      require_relative '../lib/judges/commands/update'
-      Judges::Update.new(loog).run(options, args)
-    end
+desc 'Join two factbases'
+command :print do |c|
+  c.action do |global, options, args|
+    require_relative '../lib/judges/commands/join'
+    Judges::Join.new(loog).run(options, args)
   end
+end
 
-  desc 'Print the factbase into 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.switch([:auto])
-    c.action do |global, options, args|
-      require_relative '../lib/judges/commands/print'
-      Judges::Print.new(loog).run(options, args)
-    end
+desc 'Print the factbase into 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.switch([:auto])
+  c.action do |global, options, args|
+    require_relative '../lib/judges/commands/print'
+    Judges::Print.new(loog).run(options, args)
   end
+end
 
-  desc 'Run automated tests for all judges'
-  command :test do |c|
-    c.action do |global, options, args|
-      require_relative '../lib/judges/commands/test'
-      Judges::Test.new(loog).run(options, args)
-    end
+desc 'Run automated tests for all judges'
+command :test do |c|
+  c.action do |global, options, args|
+    require_relative '../lib/judges/commands/test'
+    Judges::Test.new(loog).run(options, args)
   end
 end
 
-exit App.run(ARGV)
+exit run(ARGV)

data/features/cli.feature

@@ -24,8 +24,8 @@ Feature: Simple Run
     And Exit code is zero
 
   Scenario: Simple test of a few judges
-    Given I run bin/judges with "update ./fixtures temp/simple.fb"
-    Then Stdout contains "judges processed"
+    Given I run bin/judges with "test ./fixtures"
+    Then Stdout contains "judges tested"
     And Exit code is zero
 
   Scenario: Simple print of a small factbase

data/features/step_definitions/steps.rb

@@ -47,7 +47,7 @@ end
 
 When(%r{^I run bin/judges with "([^"]*)"$}) do |arg|
   home = File.join(File.dirname(__FILE__), '../..')
-  @stdout = `ruby -I#{home}/lib #{home}/bin/judges #{arg}`
+  @stdout = `GLI_DEBUG=true ruby -I#{home}/lib #{home}/bin/judges #{arg}`
   @exitstatus = $CHILD_STATUS.exitstatus
 end
 

data/fixtures/reward_for_good_bug/no-reward.yml

@@ -25,7 +25,7 @@ input:
     time: 2024-01-01T03:15:45
     seen:
       - one
-      - this judge
+      - reward_for_good_bug
       - two
 expected:
   - /fb[count(f)=1]

data/fixtures/reward_for_good_bug/reward_it.rb

@@ -20,7 +20,10 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-$fb.query("(and (eq kind 'bug was accepted') (not (eq seen 'this judge')))").each do |f|
+$loog.info("Trying to reward a good reported bug (judge=#{$judge})...")
+
+once($fb).query("(eq kind 'bug was accepted')").each do |f|
+  $loog.info('Good candidate found!')
   n = $fb.insert
   n.kind = 'nominate for good bug'
   n.payee = f.reporter

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.10'
+  s.version = '0.0.12'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
   s.description = '
@@ -41,8 +41,8 @@ Gem::Specification.new do |s|
   s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
   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'
+  s.add_runtime_dependency 'backtrace', '~> 0.3'
+  s.add_runtime_dependency 'factbase', '~>0.0.12'
   s.add_runtime_dependency 'gli', '~>2.21'
   s.add_runtime_dependency 'loog', '~>0.2'
   s.add_runtime_dependency 'nokogiri', '~> 1.10'

data/lib/judges/commands/join.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 'factbase'
+require 'fileutils'
+require_relative '../../judges'
+require_relative '../../judges/to_rel'
+require_relative '../../judges/packs'
+require_relative '../../judges/options'
+
+# Join.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Judges::Join
+  def initialize(loog)
+    @loog = loog
+  end
+
+  def run(_opts, args)
+    raise 'Exactly two arguments required' unless args.size == 2
+    master = args[0]
+    raise "The master factbase is absent: #{master.to_rel}" unless File.exist?(master)
+    slave = args[1]
+    raise "The slave factbase is absent: #{slave.to_rel}" unless File.exist?(slave)
+    fb = Factbase.new
+    fb.import(File.read(master))
+    @loog.info("Master factbase imported from #{master.to_rel} (#{File.size(master)} bytes)")
+    fb.import(File.read(slave))
+    @loog.info("Slave factbase imported from #{slave.to_rel} (#{File.size(slave)} bytes)")
+    File.write(master, fb.export)
+    @loog.info("Master factbase exported to #{master.to_rel} (#{File.size(master)} bytes)")
+  end
+end

data/lib/judges/commands/print.rb

@@ -23,6 +23,7 @@
 require 'fileutils'
 require 'factbase'
 require_relative '../../judges'
+require_relative '../../judges/to_rel'
 require_relative '../../judges/packs'
 
 # Update.
@@ -37,7 +38,7 @@ class Judges::Print
   def run(opts, args)
     raise 'At lease one argument required' if args.empty?
     f = args[0]
-    raise "The file is absent: #{f}" unless File.exist?(f)
+    raise "The file is absent: #{f.to_rel}" unless File.exist?(f)
     o = args[1]
     if o.nil?
       raise 'Either provide output file name or use --auto' unless opts[:auto]
@@ -46,7 +47,7 @@ class Judges::Print
     end
     fb = Factbase.new
     fb.import(File.read(f))
-    @loog.info("Factbase imported from #{f} (#{File.size(f)} bytes)")
+    @loog.info("Factbase imported from #{f.to_rel} (#{File.size(f)} bytes)")
     FileUtils.mkdir_p(File.dirname(o))
     output =
       case opts[:format].downcase
@@ -58,6 +59,6 @@ class Judges::Print
           fb.to_xml
       end
     File.write(o, output)
-    @loog.info("Factbase printed to #{o} (#{File.size(o)} bytes)")
+    @loog.info("Factbase printed to #{o.to_rel} (#{File.size(o)} bytes)")
   end
 end

data/lib/judges/commands/test.rb

@@ -20,10 +20,13 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-require 'factbase'
 require 'nokogiri'
+require 'factbase'
+require 'backtrace'
 require_relative '../../judges'
+require_relative '../../judges/to_rel'
 require_relative '../../judges/packs'
+require_relative '../../judges/options'
 
 # Test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
@@ -37,13 +40,27 @@ class Judges::Test
   def run(_opts, args)
     raise 'Exactly one argument required' unless args.size == 1
     dir = args[0]
-    done = Judges::Packs.new(dir).each_with_index do |p, i|
-      p.tests.each do |t|
-        test_one(p, t)
+    @loog.info("Testing judges in '#{dir.to_rel}'...")
+    errors = []
+    done = Judges::Packs.new(dir, @loog).each_with_index do |p, i|
+      @loog.info("\n👉 Testing '#{p.script}' (##{i}) in '#{p.dir.to_rel}'...")
+      p.tests.each do |f|
+        yaml = YAML.load_file(f, permitted_classes: [Time])
+        @loog.info("Testing '#{f.to_rel}':")
+        begin
+          test_one(p, yaml)
+        rescue StandardError => e
+          @loog.warn(Backtrace.new(e))
+          errors << f
+        end
       end
-      @loog.info("Pack ##{i} found in #{p.dir}")
     end
-    @loog.info("#{done} judges tested")
+    if errors.empty?
+      @loog.info("\nAll #{done} judges tested successfully")
+    else
+      @loog.info("\n#{done} judges tested, #{errors.size} of them failed")
+      raise "#{errors.size} tests failed" unless errors.empty?
+    end
   end
 
   private
@@ -55,17 +72,17 @@ class Judges::Test
       i.each do |k, vv|
         if vv.is_a?(Array)
           vv.each do |v|
-            send(f, "#{k}=", v)
+            f.send("#{k}=", v)
           end
         else
-          f.send('foo=', 42)
+          f.send("#{k}=", vv)
         end
       end
     end
-    pack.run(fb, {})
+    pack.run(fb, Judges::Options.new(yaml['options']))
     xml = Nokogiri::XML.parse(fb.to_xml)
     yaml['expected'].each do |xp|
-      raise "#{pack.script} with '#{xp}' doesn't match:\n#{xml}" if xml.xpath(xp).empty?
+      raise "#{pack.script} doesn't match '#{xp}':\n#{xml}" if xml.xpath(xp).empty?
     end
   end
 end

data/lib/judges/commands/update.rb

@@ -22,8 +22,11 @@
 
 require 'factbase'
 require 'fileutils'
+require 'backtrace'
 require_relative '../../judges'
+require_relative '../../judges/to_rel'
 require_relative '../../judges/packs'
+require_relative '../../judges/options'
 
 # Update.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
@@ -34,7 +37,7 @@ class Judges::Update
     @loog = loog
   end
 
-  def run(_opts, args)
+  def run(opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     dir = args[0]
     raise "The directory is absent: #{dir}" unless File.exist?(dir)
@@ -42,17 +45,26 @@ class Judges::Update
     fb = Factbase.new
     if File.exist?(file)
       fb.import(File.read(file))
-      @loog.info("Factbase imported from #{file} (#{File.size(file)} bytes)")
+      @loog.info("Factbase imported from '#{file.to_rel}' (#{File.size(file)} bytes)")
     else
-      @loog.info("There is no Factbase to import from #{file}")
+      @loog.info("There is no Factbase to import from '#{file.to_rel}' (file is absent)")
     end
-    done = Judges::Packs.new(dir).each_with_index do |p, i|
-      @loog.info("Pack ##{i} found in #{p.dir}")
-      p.run(fb, {})
+    options = Judges::Options.new(opts['options'])
+    @loog.debug("The following options provided:\n\t#{options.to_s.gsub("\n", "\n\t")}")
+    errors = []
+    done = Judges::Packs.new(dir, @loog).each_with_index do |p, i|
+      @loog.info("Pack ##{i} found in #{p.dir.to_rel}")
+      begin
+        p.run(fb, options)
+      rescue StandardError => e
+        @loog.warn(Backtrace.new(e))
+        errors << p.script
+      end
     end
-    @loog.info("#{done} judges processed")
+    @loog.info("#{done} judges processed (#{errors.size} errors)")
     FileUtils.mkdir_p(File.dirname(file))
     File.write(file, fb.export)
-    @loog.info("Factbase exported to #{file} (#{File.size(file)} bytes)")
+    @loog.info("Factbase exported to '#{file.to_rel}' (#{File.size(file)} bytes)")
+    raise "Failed to update correctly (#{errors.size} errors)" unless errors.empty?
   end
 end

data/lib/judges/fb/once.rb

@@ -0,0 +1,61 @@
+# 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.
+
+# Returns a decorated global factbase, which only touches facts once
+def once(fb, judge: $judge)
+  Factbase::Once.new(fb, judge)
+end
+
+# Runs only once.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Factbase::Once
+  def initialize(fb, func)
+    @fb = fb
+    @func = func
+  end
+
+  def query(expr)
+    expr = "(and #{expr} (not (eq seen '#{@func}')))"
+    After.new(@fb.query(expr), @func)
+  end
+
+  def insert
+    @fb.insert
+  end
+
+  # What happens after a fact is processed.
+  class After
+    def initialize(query, func)
+      @query = query
+      @func = func
+    end
+
+    def each
+      @query.each do |f|
+        yield f
+        f.seen = @func
+      end
+    end
+  end
+end

data/lib/judges/options.rb

@@ -0,0 +1,69 @@
+# 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'
+
+# Options for Ruby scripts in the judges.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Judges::Options
+  # Ctor.
+  # @param pairs [Array<String>] List of pairs, like ["token=af73cd3", "max_speed=1"]
+  def initialize(pairs)
+    @pairs = pairs
+  end
+
+  # Convert them all to a string (printable in a log).
+  def to_s
+    touch # this will trigger method_missing() method, which will create @hash
+    @hash.map do |k, v|
+      v = v.to_s
+      v = "#{v[0..3]}#{'*' * (v.length - 4)}" if v.length > 8
+      "#{k}=#{v}"
+    end.join("\n")
+  end
+
+  # Get option by name.
+  def method_missing(*args)
+    @hash ||= begin
+      pp = @pairs || []
+      pp = @pairs.map { |k, v| "#{k}=#{v}" } if pp.is_a?(Hash)
+      pp.to_h do |pair|
+        p = pair.split('=', 2)
+        [p[0].to_sym, p[1].match?(/^[0-9]+$/) ? p[1].to_i : p[1]]
+      end
+    end
+    k = args[0].downcase
+    @hash[k]
+  end
+
+  # rubocop:disable Style/OptionalBooleanParameter
+  def respond_to?(_method, _include_private = false)
+    # rubocop:enable Style/OptionalBooleanParameter
+    true
+  end
+
+  def respond_to_missing?(_method, _include_private = false)
+    true
+  end
+end

data/lib/judges/pack.rb

@@ -21,7 +21,9 @@
 # SOFTWARE.
 
 require 'yaml'
+require 'time'
 require_relative '../judges'
+require_relative '../judges/fb/once'
 
 # A single pack.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
@@ -30,21 +32,24 @@ require_relative '../judges'
 class Judges::Pack
   attr_reader :dir
 
-  def initialize(dir)
+  def initialize(dir, loog)
     @dir = dir
+    @loog = loog
   end
 
   # Run it with the given Factbase and environment variables.
-  def run(fbase, env)
+  def run(fbase, options)
     $fb = fbase
-    env.each do |k, v|
-      # rubocop:disable Security/Eval
-      eval("$#{k} = '#{v}'", binding, __FILE__, __LINE__) # $foo = 42
-      # rubocop:enable Security/Eval
-    end
+    $judge = File.basename(@dir)
+    $options = options
+    $loog = @loog
     s = File.join(@dir, script)
     raise "Can't load '#{s}'" unless File.exist?(s)
-    load s
+    begin
+      load(s, true)
+    ensure
+      $fb = $judge = $options = $loog = nil
+    end
   end
 
   # Get the name of the .rb script in the pack.
@@ -52,10 +57,8 @@ class Judges::Pack
     File.basename(Dir.glob(File.join(@dir, '*.rb')).first)
   end
 
-  # Iterate over .yml tests.
+  # Return all .yml tests files.
   def tests
-    Dir.glob(File.join(@dir, '*.yml')).map do |f|
-      YAML.load_file(f)
-    end
+    Dir.glob(File.join(@dir, '*.yml'))
   end
 end

data/lib/judges/packs.rb

@@ -28,8 +28,9 @@ require_relative 'pack'
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko
 # License:: MIT
 class Judges::Packs
-  def initialize(dir)
+  def initialize(dir, loog)
     @dir = dir
+    @loog = loog
   end
 
   # Iterate over them all.
@@ -37,7 +38,7 @@ class Judges::Packs
   def each
     Dir.glob(File.join(@dir, '**/*.rb')).each do |f|
       d = File.dirname(File.absolute_path(f))
-      yield Judges::Pack.new(d)
+      yield Judges::Pack.new(d, @loog)
     end
   end
 

data/{.github/workflows/zerocracy.yaml → lib/judges/to_rel.rb}

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright (c) 2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -17,26 +19,22 @@
 # 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.
----
-name: zerocracy
-on:
-  schedule:
-    - cron: '0,10,20,30,50,50 * * * *'
-concurrency:
-  group: zerocracy
-  cancel-in-progress: true
-jobs:
-  yamllint:
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: zerocracy/judges-action@master
-        with:
-          factbase: recent.fb
-      - run: mkdir gh-pages && cp recent.yml gh-pages
-      - uses: JamesIves/github-pages-deploy-action@v4.6.0
-        with:
-          branch: gh-pages
-          folder: gh-pages/recent.yml
-          factbase: recent.fb
-          clean: true
+
+require 'pathname'
+
+# Adding method +to_rel+ to all Ruby objects.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class Object
+  # Generates a relative name of a file (to the current dir).
+  def to_rel
+    s = File.absolute_path(to_s)
+    p = Pathname.new(s).relative_path_from(Dir.getwd)
+    if p.directory?
+      "#{p}/"
+    else
+      p.to_s
+    end
+  end
+end

data/test/commands/test_join.rb

@@ -0,0 +1,52 @@
+# 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 'loog'
+require 'nokogiri'
+require_relative '../../lib/judges'
+require_relative '../../lib/judges/commands/join'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class TestJoin < Minitest::Test
+  def test_simple_join
+    Dir.mktmpdir do |d|
+      master = File.join(d, 'master.fb')
+      fb1 = Factbase.new
+      fb1.insert.zz = 5
+      File.write(master, fb1.export)
+      slave = File.join(d, 'slave.fb')
+      fb2 = Factbase.new
+      fb2.insert.foo_bar = 42
+      File.write(slave, fb2.export)
+      Judges::Join.new(Loog::VERBOSE).run({}, [master, slave])
+      fb = Factbase.new
+      fb.import(File.read(master))
+      xml = Nokogiri::XML.parse(fb.to_xml)
+      assert(!xml.xpath('/fb/f[zz="5"]').empty?, fb.to_xml)
+      assert(!xml.xpath('/fb/f[foo_bar="42"]').empty?, fb.to_xml)
+    end
+  end
+end

data/test/commands/test_test.rb

@@ -69,4 +69,22 @@ class TestTest < Minitest::Test
       end
     end
   end
+
+  def test_with_options
+    Dir.mktmpdir do |d|
+      File.write(File.join(d, 'foo.rb'), '$fb.insert.foo = $options.bar')
+      File.write(
+        File.join(d, 'something.yml'),
+        <<-YAML
+        input: []
+        options:
+          bar: 42
+        expected:
+          - /fb[count(f)=1]
+          - /fb/f[foo='42']
+        YAML
+      )
+      Judges::Test.new(Loog::VERBOSE).run(nil, [d])
+    end
+  end
 end

data/test/commands/test_update.rb

@@ -22,6 +22,7 @@
 
 require 'minitest/autorun'
 require 'loog'
+require 'nokogiri'
 require_relative '../../lib/judges'
 require_relative '../../lib/judges/commands/update'
 
@@ -30,12 +31,31 @@ require_relative '../../lib/judges/commands/update'
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko
 # License:: MIT
 class TestUpdate < Minitest::Test
-  def test_simple_update
+  def test_build_factbase_from_scratch
     Dir.mktmpdir do |d|
-      File.write(File.join(d, 'foo.rb'), '$fb.query("(eq foo 42)").each { |f| f.bar = 4 }')
-      fb = File.join(d, 'base.fb')
-      Judges::Update.new(Loog::VERBOSE).run(nil, [d, fb])
-      assert(File.exist?(fb))
+      File.write(File.join(d, 'foo.rb'), '$fb.insert.zzz = $options.foo_bar + 1')
+      file = File.join(d, 'base.fb')
+      Judges::Update.new(Loog::VERBOSE).run({ 'options' => ['foo_bar=42'] }, [d, file])
+      fb = Factbase.new
+      fb.import(File.read(file))
+      xml = Nokogiri::XML.parse(fb.to_xml)
+      assert(!xml.xpath('/fb/f[zzz="43"]').empty?)
+    end
+  end
+
+  def test_extend_existing_factbase
+    Dir.mktmpdir do |d|
+      file = File.join(d, 'base.fb')
+      fb = Factbase.new
+      fb.insert.foo_bar = 42
+      File.write(file, fb.export)
+      File.write(File.join(d, 'foo.rb'), '$fb.insert.tt = 4')
+      Judges::Update.new(Loog::VERBOSE).run({}, [d, file])
+      fb = Factbase.new
+      fb.import(File.read(file))
+      xml = Nokogiri::XML.parse(fb.to_xml)
+      assert(!xml.xpath('/fb/f[tt="4"]').empty?)
+      assert(!xml.xpath('/fb/f[foo_bar="42"]').empty?)
     end
   end
 end

data/test/fb/test_once.rb

@@ -0,0 +1,40 @@
+# 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 'tmpdir'
+require 'factbase'
+require_relative '../../lib/judges'
+require_relative '../../lib/judges/fb/once'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class TestOnce < Minitest::Test
+  def test_touch_once
+    fb = once(Factbase.new, judge: 'something')
+    fb.insert
+    fb.query('()').each { |f| f.foo = 42 }
+    assert(fb.query('()').extend(Enumerable).to_a.empty?)
+  end
+end

data/test/test_options.rb

@@ -0,0 +1,54 @@
+# 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_relative '../lib/judges'
+require_relative '../lib/judges/options'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class TestOptions < Minitest::Test
+  def test_basic
+    opts = Judges::Options.new(['token=a77', 'max=42'])
+    assert_equal('a77', opts.token)
+    assert_equal(42, opts.max)
+  end
+
+  def test_with_nil
+    opts = Judges::Options.new(nil)
+    assert(opts.foo.nil?)
+  end
+
+  def test_with_hash
+    opts = Judges::Options.new('foo' => 42, 'bar' => 'hello')
+    assert_equal(42, opts.foo)
+    assert_equal('hello', opts.bar)
+    assert(opts.xxx.nil?)
+  end
+
+  def test_converts_to_string
+    opts = Judges::Options.new('foo' => 44, 'bar' => 'long-string-maybe-secret')
+    assert_equal("foo=44\nbar=long********************", opts.to_s)
+  end
+end

data/test/test_pack.rb

@@ -22,6 +22,7 @@
 
 require 'minitest/autorun'
 require 'tmpdir'
+require 'loog'
 require 'factbase'
 require_relative '../lib/judges'
 require_relative '../lib/judges/pack'
@@ -34,7 +35,7 @@ class TestPack < Minitest::Test
   def test_basic_run
     Dir.mktmpdir do |d|
       File.write(File.join(d, 'foo.rb'), '$fb.insert')
-      pack = Judges::Pack.new(d)
+      pack = Judges::Pack.new(d, Loog::VERBOSE)
       fb = Factbase.new
       pack.run(fb, {})
       assert_equal(1, fb.size)
@@ -44,7 +45,7 @@ class TestPack < Minitest::Test
   def test_run_isolated
     Dir.mktmpdir do |d|
       File.write(File.join(d, 'bar.rb'), '$fb.insert')
-      pack = Judges::Pack.new(d)
+      pack = Judges::Pack.new(d, Loog::VERBOSE)
       fb1 = Factbase.new
       pack.run(fb1, {})
       assert_equal(1, fb1.size)
@@ -53,4 +54,24 @@ class TestPack < Minitest::Test
       assert_equal(1, fb2.size)
     end
   end
+
+  def test_with_supplemenary_functions
+    Dir.mktmpdir do |d|
+      File.write(File.join(d, 'x.rb'), 'once($fb).insert')
+      pack = Judges::Pack.new(d, Loog::VERBOSE)
+      pack.run(Factbase.new, {})
+    end
+  end
+
+  def test_sets_judge_value_correctly
+    Dir.mktmpdir do |d|
+      j = 'this_is_it'
+      dir = File.join(d, j)
+      FileUtils.mkdir(dir)
+      File.write(File.join(dir, 'foo.rb'), '$loog.info("judge=" + $judge)')
+      log = Loog::Buffer.new
+      Judges::Pack.new(dir, log).run(Factbase.new, {})
+      assert(log.to_s.include?("judge=#{j}"))
+    end
+  end
 end

data/test/test_packs.rb

@@ -22,6 +22,7 @@
 
 require 'minitest/autorun'
 require 'tmpdir'
+require 'loog'
 require_relative '../lib/judges'
 require_relative '../lib/judges/packs'
 
@@ -35,10 +36,10 @@ class TestPacks < Minitest::Test
       File.write(File.join(d, 'foo.rb'), 'hey')
       File.write(File.join(d, 'something.yml'), "---\nfoo: 42")
       found = 0
-      Judges::Packs.new(d).each do |p|
+      Judges::Packs.new(d, Loog::VERBOSE).each do |p|
         assert_equal('foo.rb', p.script)
         found += 1
-        assert_equal(42, p.tests.first['foo'])
+        assert_equal('something.yml', File.basename(p.tests.first))
       end
       assert_equal(1, found)
     end

data/test/test_to_rel.rb

@@ -0,0 +1,41 @@
+# 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_relative '../lib/judges'
+require_relative '../lib/judges/to_rel'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Yegor Bugayenko
+# License:: MIT
+class TestToRel < Minitest::Test
+  def test_simple_mapping
+    n = File.absolute_path(File.join('.', 'lib/../lib/commands/update.rb'))
+    assert_equal('lib/commands/update.rb', n.to_rel)
+  end
+
+  def test_maps_dir_name
+    n = File.absolute_path(File.join('.', 'lib/../lib/judges/commands'))
+    assert_equal('lib/judges/commands/', n.to_rel)
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.0.10
+  version: 0.0.12
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-12 00:00:00.000000000 Z
+date: 2024-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: 0.0.12
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: 0.0.12
 - !ruby/object:Gem::Dependency
   name: gli
   requirement: !ruby/object:Gem::Requirement
@@ -101,7 +101,6 @@ files:
 - ".github/workflows/rake.yml"
 - ".github/workflows/xcop.yml"
 - ".github/workflows/yamllint.yml"
-- ".github/workflows/zerocracy.yaml"
 - ".gitignore"
 - ".pdd"
 - ".rubocop.yml"
@@ -122,19 +121,27 @@ files:
 - fixtures/reward_for_good_bug/simple-reward.yml
 - judges.gemspec
 - lib/judges.rb
+- lib/judges/commands/join.rb
 - lib/judges/commands/print.rb
 - lib/judges/commands/test.rb
 - lib/judges/commands/update.rb
+- lib/judges/fb/once.rb
+- lib/judges/options.rb
 - lib/judges/pack.rb
 - lib/judges/packs.rb
+- lib/judges/to_rel.rb
 - renovate.json
+- test/commands/test_join.rb
 - test/commands/test_print.rb
 - test/commands/test_test.rb
 - test/commands/test_update.rb
+- test/fb/test_once.rb
 - test/test__helper.rb
 - test/test_judges.rb
+- test/test_options.rb
 - test/test_pack.rb
 - test/test_packs.rb
+- test/test_to_rel.rb
 homepage: http://github.com/yegor256/judges
 licenses:
 - MIT