factbase 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e27fe11aa944dcd02303229649c86810bd2585e18c86ec227b113d2a50633ec4
-  data.tar.gz: a3fad9da51b5201a84f71177475a8b768bb037f6f7dc9fbc01f61b076e9a6559
+  metadata.gz: f31200ddcd8de0d737dbabea9aefc051794f86bbae0891f8d624545912972add
+  data.tar.gz: 7c1688856cde3e72f8e9f53e846b39c7cef508a0df95cc88d0631bfae36ce07f
 SHA512:
-  metadata.gz: cef5dbc22c5692f7e3219cfc11802ba7b114cdd5d30ae65e20960186b919ff69b6a5015e7fc5985644713dd852b624e9575784496b62e8155c254871dac9b3d4
-  data.tar.gz: ed05d5bf86469a9c30c7f66c03222b65ec4b3a02ac9a403bda966914538c83e27be9d4ffc6a0e7e8890dc00a57d2e21810cc3b6ac8b98bd66a28d9dcefcbe469
+  metadata.gz: 26c83d3a288f8106bfe17856bccb9c1bde6b130384e9a4546456a76c1b6a69fff9c49954789aaeee6413f7cfae638d6f1320f1de4f7ac000b3c552b31449ebbd
+  data.tar.gz: 761d577bc112c4d542667508924406570ff449fbab87af3a18fc0ce7c8a94cccf6d40f400b1b1c3f6bd76d95a51678a680fd17feeee0b89caacbac2b56e8e6f6

data/.rultor.yml

@@ -16,8 +16,8 @@ release:
     [[ "${tag}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || exit -1
     bundle exec rake
     rm -rf *.gem
-    sed -i "s/0\.0\.0/${tag}/g" lib/factbase.rb
-    git add lib/factbase.rb
+    sed -i "s/0\.0\.0/${tag}/g" lib/factbase/version.rb
+    git add lib/factbase/version.rb
     git commit -m "version set to ${tag}"
     gem build factbase.gemspec
     chmod 0600 ../rubygems.yml

data/Gemfile.lock

@@ -22,7 +22,7 @@ GEM
     builder (3.3.0)
     concurrent-ruby (1.3.5)
     date (3.4.1)
-    decoor (0.0.1)
+    decoor (0.1.0)
     docile (1.4.1)
     elapsed (0.0.1)
       loog (> 0)

data/README.md

@@ -210,33 +210,33 @@ This is the result of the benchmark:
 <!-- benchmark_begin -->
 ```text
                                                                    user
-insert 20000 facts                                             0.606861
-export 20000 facts                                             0.029288
-import 410768 bytes (20000 facts)                              0.029856
-insert 10 facts                                                0.042954
-query 10 times w/txn                                           1.951537
-query 10 times w/o txn                                         0.038436
-modify 10 attrs w/txn                                          1.815854
-delete 10 facts w/txn                                          1.023006
-(and (eq what 'issue-was-closed') (exists... -> 200            2.130857
-(and (eq what 'issue-was-closed') (exists... -> 200/txn        1.146039
-(and (eq what 'issue-was-closed') (exists... -> zero           2.424541
-(and (eq what 'issue-was-closed') (exists... -> zero/txn       1.297135
-(gt time '2024-03-23T03:21:43Z')                               0.109071
-(gt cost 50)                                                   0.092356
-(eq title 'Object Thinking 5000')                              0.002707
-(and (eq foo 42.998) (or (gt bar 200) (absent zzz)))           0.024449
-(eq id (agg (always) (max id)))                                0.257526
-(join "c<=cost,b<=bar" (eq id (agg (always) (max id))))        0.650843
-delete!                                                        0.075867
-Taped.append() x50000                                          0.038991
-Taped.each() x125                                              1.321896
-Taped.delete_if() x375                                         0.830375
+insert 20000 facts                                             0.618307
+export 20000 facts                                             0.021391
+import 410726 bytes (20000 facts)                              0.030150
+insert 10 facts                                                0.045651
+query 10 times w/txn                                           1.970434
+query 10 times w/o txn                                         0.039459
+modify 10 attrs w/txn                                          1.819769
+delete 10 facts w/txn                                          1.056563
+(and (eq what 'issue-was-closed') (exists... -> 200            2.125753
+(and (eq what 'issue-was-closed') (exists... -> 200/txn        1.135618
+(and (eq what 'issue-was-closed') (exists... -> zero           2.422668
+(and (eq what 'issue-was-closed') (exists... -> zero/txn       1.288236
+(gt time '2024-03-23T03:21:43Z')                               0.108849
+(gt cost 50)                                                   0.090092
+(eq title 'Object Thinking 5000')                              0.002640
+(and (eq foo 42.998) (or (gt bar 200) (absent zzz)))           0.023785
+(eq id (agg (always) (max id)))                                0.252980
+(join "c<=cost,b<=bar" (eq id (agg (always) (max id))))        0.655997
+delete!                                                        0.075510
+Taped.append() x50000                                          0.042923
+Taped.each() x125                                              1.343819
+Taped.delete_if() x375                                         0.830124
 ```
 
 The results were calculated in [this GHA job][benchmark-gha]
-on 2025-06-03 at 09:54,
+on 2025-06-21 at 08:24,
 on Linux with 4 CPUs.
 <!-- benchmark_end -->
 
-[benchmark-gha]: https://github.com/yegor256/factbase/actions/runs/15414210508
+[benchmark-gha]: https://github.com/yegor256/factbase/actions/runs/15793882855

data/factbase.gemspec

@@ -4,7 +4,7 @@
 # SPDX-License-Identifier: MIT
 
 require 'English'
-require_relative 'lib/factbase'
+require_relative 'lib/factbase/version'
 
 Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=

data/lib/factbase/term.rb

@@ -118,9 +118,9 @@ class Factbase::Term
   def evaluate(fact, maps, fb)
     send(@op, fact, maps, fb)
   rescue NoMethodError => e
-    raise "Probably the term '#{@op}' is not defined at #{self}:\n#{Backtrace.new(e)}"
+    raise "Probably the term '#{@op}' is not defined at #{self}: #{e.message}"
   rescue StandardError => e
-    raise "#{e.message} at #{self}:\n#{Backtrace.new(e)}"
+    raise "#{e.message} at #{self}"
   end
 
   # Simplify it if possible.

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+# Just version.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# License:: MIT
+class Factbase
+  # Current version of the gem (changed by .rultor.yml on every release)
+  VERSION = '0.12.0' unless const_defined?(:VERSION)
+end

data/lib/factbase.rb

@@ -81,8 +81,7 @@ require 'yaml'
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class Factbase
-  # Current version of the gem (changed by .rultor.yml on every release)
-  VERSION = '0.11.1' unless const_defined?(:VERSION)
+  require_relative 'factbase/version'
 
   # An exception that may be thrown in a transaction, to roll it back.
   class Rollback < StandardError; 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.1
+  version: 0.12.0
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -249,6 +249,7 @@ files:
 - lib/factbase/to_json.rb
 - lib/factbase/to_xml.rb
 - lib/factbase/to_yaml.rb
+- lib/factbase/version.rb
 - renovate.json
 - test/factbase/cached/test_cached_factbase.rb
 - test/factbase/cached/test_cached_query.rb