factbase 0.11.2 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be29589dd79cd9d1737bc03dc28e3e4dc6c3115fc09c3369e8d4b617f8a57829
-  data.tar.gz: 57283b8114c03feaf19bbbae3a2b117ab1399026c0b5b9af2059af3356978717
+  metadata.gz: f31200ddcd8de0d737dbabea9aefc051794f86bbae0891f8d624545912972add
+  data.tar.gz: 7c1688856cde3e72f8e9f53e846b39c7cef508a0df95cc88d0631bfae36ce07f
 SHA512:
-  metadata.gz: afad81287f3b28820595f309a6f538a4415541fb212c2df31b034b0fa512698703db6c8be4c3c4389ec6cf355a944b6dc069ebf68b53fe085648d55a0cf1c10c
-  data.tar.gz: a566f40422aeb136517330c70c88348dbd3ea21786ab999de532a709ccdd09394f22cb64da490c0ccba0ef483ba46d2e2416865b4b66856e626904ac05b0809c
+  metadata.gz: 26c83d3a288f8106bfe17856bccb9c1bde6b130384e9a4546456a76c1b6a69fff9c49954789aaeee6413f7cfae638d6f1320f1de4f7ac000b3c552b31449ebbd
+  data.tar.gz: 761d577bc112c4d542667508924406570ff449fbab87af3a18fc0ce7c8a94cccf6d40f400b1b1c3f6bd76d95a51678a680fd17feeee0b89caacbac2b56e8e6f6

data/.rultor.yml

@@ -1,4 +1,3 @@
-
 # SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 ---

data/lib/factbase/terms/debug.rb

@@ -19,4 +19,29 @@ module Factbase::Debug
     puts "#{self} -> #{r}"
     r
   end
+
+  def assert(fact, maps, fb)
+    assert_args(2)
+    message = @operands[0]
+    unless message.is_a?(String)
+      raise ArgumentError,
+            "A string expected as first argument of 'assert', but '#{message}' provided"
+    end
+    t = @operands[1]
+    unless t.is_a?(Factbase::Term)
+      raise ArgumentError,
+            "A term expected as second argument of 'assert', but '#{t}' provided"
+    end
+    result = t.evaluate(fact, maps, fb)
+    # Convert result to boolean-like evaluation
+    # Arrays are truthy if they contain at least one truthy element
+    truthy =
+      if result.is_a?(Array)
+        result.any? { |v| v && v != 0 }
+      else
+        result && result != 0
+      end
+    raise message unless truthy
+    true
+  end
 end

data/lib/factbase/version.rb

@@ -9,5 +9,5 @@
 # License:: MIT
 class Factbase
   # Current version of the gem (changed by .rultor.yml on every release)
-  VERSION = '0.11.2' unless const_defined?(:VERSION)
+  VERSION = '0.12.0' unless const_defined?(:VERSION)
 end

data/test/factbase/terms/test_debug.rb

@@ -33,4 +33,79 @@ class TestDebug < Factbase::Test
       end
     assert_match(/Too many \(\d+\) operands for 'traced' \(\d+ expected\)/, e.message)
   end
+
+  def test_assert_with_true_condition
+    t = Factbase::Term.new(:assert, ['all must be positive', Factbase::Term.new(:gt, [:foo, 0])])
+    assert(t.evaluate(fact('foo' => 5), [], Factbase.new))
+  end
+
+  def test_assert_with_false_condition
+    t = Factbase::Term.new(:assert, ['all must be positive', Factbase::Term.new(:gt, [:foo, 0])])
+    e =
+      assert_raises(RuntimeError) do
+        t.evaluate(fact('foo' => -1), [], Factbase.new)
+      end
+    assert_equal("all must be positive at (assert 'all must be positive' (gt foo 0))", e.message)
+  end
+
+  def test_assert_with_zero_value
+    t = Factbase::Term.new(:assert, ['value must not be zero', Factbase::Term.new(:gt, [:foo, 0])])
+    e =
+      assert_raises(RuntimeError) do
+        t.evaluate(fact('foo' => 0), [], Factbase.new)
+      end
+    assert_equal("value must not be zero at (assert 'value must not be zero' (gt foo 0))", e.message)
+  end
+
+  def test_assert_with_array_true_condition
+    t = Factbase::Term.new(:assert, ['at least one positive', Factbase::Term.new(:gt, [:foo, 0])])
+    assert(t.evaluate(fact('foo' => [1, 2, 3]), [], Factbase.new))
+  end
+
+  def test_assert_with_array_false_condition
+    t = Factbase::Term.new(:assert, ['at least one positive', Factbase::Term.new(:gt, [:foo, 0])])
+    e =
+      assert_raises(RuntimeError) do
+        t.evaluate(fact('foo' => [-1, -2, -3]), [], Factbase.new)
+      end
+    assert_equal("at least one positive at (assert 'at least one positive' (gt foo 0))", e.message)
+  end
+
+  def test_assert_with_mixed_array
+    t = Factbase::Term.new(:assert, ['at least one positive', Factbase::Term.new(:gt, [:foo, 0])])
+    assert(t.evaluate(fact('foo' => [-1, 0, 3]), [], Factbase.new))
+  end
+
+  def test_assert_raises_when_message_not_string
+    e =
+      assert_raises(StandardError) do
+        Factbase::Term.new(:assert, [123, Factbase::Term.new(:gt, [:foo, 0])]).evaluate(fact, [], Factbase.new)
+      end
+    assert_match(/A string expected as first argument of 'assert', but '123' provided/, e.message)
+  end
+
+  def test_assert_raises_when_second_arg_not_term
+    e =
+      assert_raises(StandardError) do
+        Factbase::Term.new(:assert, %w[message not_a_term]).evaluate(fact, [], Factbase.new)
+      end
+    assert_match(/A term expected as second argument of 'assert', but 'not_a_term' provided/, e.message)
+  end
+
+  def test_assert_raises_when_too_few_args
+    e =
+      assert_raises(StandardError) do
+        Factbase::Term.new(:assert, ['message']).evaluate(fact, [], Factbase.new)
+      end
+    assert_match(/Too few \(\d+\) operands for 'assert' \(\d+ expected\)/, e.message)
+  end
+
+  def test_assert_raises_when_too_many_args
+    e =
+      assert_raises(StandardError) do
+        Factbase::Term.new(:assert, ['message', Factbase::Term.new(:gt, [:foo, 0]), 'extra']).evaluate(fact, [],
+                                                                                                       Factbase.new)
+      end
+    assert_match(/Too many \(\d+\) operands for 'assert' \(\d+ expected\)/, e.message)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: factbase
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 0.12.0
 platform: ruby
 authors:
 - Yegor Bugayenko