factbase 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da15ba272d70a23c1f7138efd317a27e19f37846c7305b005e75fb23d9222004
-  data.tar.gz: 37588b7eb0b03659b5e6373a4f42bda9e89cd652cc954bc6a7988faf705d35ad
+  metadata.gz: a78379a3da6efaffa3672290e0ec7f38f2ec5b83032719388e07b517a4fb9e99
+  data.tar.gz: c172a777ddbb8e3799cf8e1fb55437a5172086724a8ed623ed08ff373ece7b87
 SHA512:
-  metadata.gz: ba914de891e44ee3580e42be96710c3a2deecd75c2ba7fae07d78bb84920af2ffbf602b587e0aa81c1b138b9603f0c58903c21a933177e04e3fdcf1124d367b6
-  data.tar.gz: 3c681187d0df5285eb0922f7ae718c12009c26adb84c9a9ba7ad2676c095e5dcd68e01dce538a87c52f02e3475d62e4833349995c6d69cd444f3a9730fd4ba52
+  metadata.gz: 39ee04049fe211ef67de1eee8281ced0f6c2cba9eb132d80ab10c4d0d6dc3c22dde24675a1ee5810cf0b53be9c8f1e4e8afc622873537f44179cd9251fccff9e
+  data.tar.gz: 62390b4ef6e29ead3174f6b6a6d68d72e69cf2a35d667faf6c5aff05f310f1e42360da6917798f999a411e37894863b3956babf849d837fbc3ec4ced9306510d

data/lib/factbase/accum.rb

@@ -23,7 +23,7 @@
 require 'others'
 require_relative '../factbase'
 
-# Accumulator of props.
+# Accumulator of props, a decorator of +Factbase::Fact+.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko

data/lib/factbase/pre.rb

@@ -24,7 +24,18 @@ require 'loog'
 require 'decoor'
 require_relative '../factbase'
 
-# A decorator of a Factbase, that runs a provided block on every +insert+.
+# A decorator of a +Factbase+, that runs a provided block on every +insert+.
+#
+# For example, you can use this decorator if you want to put some properties
+# into every fact that gets into the factbase:
+#
+#  fb = Factbase::Pre.new(Factbase.new) do |f, fbt|
+#    f.when = Time.now
+#  end
+#
+# The second argument passed to the block is the factbase, while the first
+# one is the fact just inserted.
+#
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko
 # License:: MIT
@@ -43,7 +54,7 @@ class Factbase::Pre
 
   def insert
     f = @fb.insert
-    @block.call(f)
+    @block.call(f, self)
     f
   end
 

data/lib/factbase.rb

@@ -81,7 +81,7 @@ require 'yaml'
 # License:: MIT
 class Factbase
   # Current version of the gem (changed by .rultor.yml on every release)
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 
   # An exception that may be thrown in a transaction, to roll it back.
   class Rollback < StandardError; end

data/test/factbase/test_accum.rb

@@ -67,4 +67,13 @@ class TestAccum < Minitest::Test
     a = Factbase::Accum.new(f, {}, false)
     assert(a['foo'].nil?)
   end
+
+  def test_prints_to_string
+    map = {}
+    f = Factbase::Fact.new(Mutex.new, map)
+    props = {}
+    a = Factbase::Accum.new(f, props, true)
+    a.foo = 42
+    assert_equal('[ foo: [42] ]', f.to_s)
+  end
 end

data/test/factbase/test_pre.rb

@@ -35,4 +35,18 @@ class TestPre < Minitest::Test
     assert_equal(42, f.foo)
     assert_equal(1, fb.query('(always)').each.to_a.size)
   end
+
+  def test_in_transaction
+    fb =
+      Factbase::Pre.new(Factbase.new) do |f, fbt|
+        f.total = fbt.size
+      end
+    fb.txn do |fbt|
+      fbt.insert
+      fbt.insert
+    end
+    arr = fb.query('(always)').each.to_a
+    assert_equal(1, arr[0].total)
+    assert_equal(2, arr[1].total)
+  end
 end

data/test/factbase/test_rules.rb

@@ -58,7 +58,10 @@ class TestRules < Minitest::Test
       '(when (exists a) (exists b))'
     )
     f = fb.insert
-    assert(f.to_s.length.positive?)
+    f.foo = 42
+    s = f.to_s
+    assert(s.length.positive?, s)
+    assert_equal('[ foo: [42] ]', s)
   end
 
   def test_query_one

data/test/factbase/test_tee.rb

@@ -59,4 +59,13 @@ class TestTee < Minitest::Test
     t = Factbase::Tee.new(prim, t)
     assert_equal(7, t['$bar'])
   end
+
+  def test_prints_to_string
+    prim = Factbase::Fact.new(Mutex.new, {})
+    prim.foo = 42
+    upper = Factbase::Fact.new(Mutex.new, {})
+    upper.bar = 13
+    t = Factbase::Tee.new(prim, upper)
+    assert_equal('[ foo: [42] ]', t.to_s)
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factbase
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-08 00:00:00.000000000 Z
+date: 2024-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace