fbe 0.0.39 → 0.0.41

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32f31aad59acf471e8f0075c5ed1d0449a2039fb7d13cd3e0b4c3804b6ef1271
-  data.tar.gz: 65356a4c23c7a6630a0c0387a511cd0d367c72eb2609cb3ded007f9efacbf6e9
+  metadata.gz: 562ad71216aae43bcbc061bc11381c765eacae86bf7f7deb5e5c2a7a68e9d279
+  data.tar.gz: '0942fcb9385e3828e1d50dfde029c8368e3b9f2cd5cd5b0630b732f6b5cf32cf'
 SHA512:
-  metadata.gz: b50e3e2aaf0a16e640c8dc8068574fdb2dac380b767b00b2ae348c58a7ce0940b4db5dd85719aa263ee19ef5c2d402afef9a41cd31637f9a0e4418415a18ebc5
-  data.tar.gz: 732aedff1ade21b5db01cf591ad343889e234fd7e646d4012c399c9f053651fb220b5c9a746de63bff129efa37614d99c5ef9842fa688b4a7abda687d7c49d06
+  metadata.gz: d683b6cd0ecbf15ec069fee0bf0b92ad1387010bf2ea9cb0fd12d85d3f245d03552941c0ca054cf3d2b3a3730a1bc2419ae16383b442c55bfe674e7e9b8aac42
+  data.tar.gz: 4d74ef7c0765883a5f2829cc4b960650736aa2fc7dc0e829bba50de93a34c334196a5f37a324611b8d5b5d8bbeac4e7b4ef725937e4ea7d58ab9215ec50e0722

data/lib/fbe/if_absent.rb

@@ -27,7 +27,8 @@ require 'others'
 require_relative '../fbe'
 require_relative 'fb'
 
-# Injects a fact if it's absent in the factbase.
+# Injects a fact if it's absent in the factbase, otherwise (it is already
+# there) returns NIL.
 def Fbe.if_absent(fb: Fbe.fb)
   attrs = {}
   f =
@@ -50,7 +51,7 @@ def Fbe.if_absent(fb: Fbe.fb)
     "(eq #{k} #{vv})"
   end.join(' ')
   q = "(and #{q})"
-  return unless fb.query(q).each.to_a.empty?
+  return nil unless fb.query(q).each.to_a.empty?
   n = fb.insert
   attrs.each { |k, v| n.send("#{k}=", v) }
   n

data/lib/fbe/just_one.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+# MIT License
+#
+# Copyright (c) 2024 Zerocracy
+#
+# 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 'time'
+require 'others'
+require_relative '../fbe'
+require_relative 'fb'
+
+# Injects a fact if it's absent in the factbase, otherwise (it is already
+# there) returns the existing one.
+def Fbe.just_one(fb: Fbe.fb)
+  attrs = {}
+  f =
+    others(map: attrs) do |*args|
+      k = args[0]
+      if k.end_with?('=')
+        @map[k[0..-2].to_sym] = args[1]
+      else
+        @map[k.to_sym]
+      end
+    end
+  yield f
+  q = attrs.except('_id', '_time', '_version').map do |k, v|
+    vv = v.to_s
+    if v.is_a?(String)
+      vv = "'#{vv.gsub('"', '\\\\"').gsub("'", "\\\\'")}'"
+    elsif v.is_a?(Time)
+      vv = v.utc.iso8601
+    end
+    "(eq #{k} #{vv})"
+  end.join(' ')
+  q = "(and #{q})"
+  before = fb.query(q).each.to_a.first
+  return before unless before.nil?
+  n = fb.insert
+  attrs.each { |k, v| n.send("#{k}=", v) }
+  n
+end

data/lib/fbe/overwrite.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# MIT License
+#
+# Copyright (c) 2024 Zerocracy
+#
+# 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 '../fbe'
+require_relative 'fb'
+
+# Overwrite a property in the fact.
+#
+# If the property doesn't exist in the fact, it will be added. If it does
+# exist, it will be removed (the entire fact will be destroyed, new fact
+# created, and property set).
+#
+# @param [Factbase::Fact] fact The fact to modify
+# @param [String] property The name of the property to set
+# @param [Any] vqlue The value to set
+def Fbe.overwrite(fact, property, value, fb: Fbe.fb)
+  before = {}
+  fact.all_properties.each do |prop|
+    before[prop.to_s] = fact[prop]
+  end
+  fb.query("(and #{before.map { |k, vv| vv.is_a?(Array) ? '' : " (eq #{k} #{vv})" }.join})").delete!
+  n = fb.insert
+  before[property.to_s] = value
+  before.each do |k, vv|
+    next if k.start_with?('_')
+    vv = [vv] unless vv.is_a?(Array)
+    vv.each do |v|
+      n.send("#{k}=", v)
+    end
+  end
+end

data/lib/fbe.rb

@@ -27,5 +27,5 @@
 # License:: MIT
 module Fbe
   # Current version of the gem (changed by .rultor.yml on every release)
-  VERSION = '0.0.39'
+  VERSION = '0.0.41'
 end

data/test/fbe/test_just_one.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# MIT License
+#
+# Copyright (c) 2024 Zerocracy
+#
+# 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 'factbase'
+require_relative '../test__helper'
+require_relative '../../lib/fbe/just_one'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Zerocracy
+# License:: MIT
+class TestJustOne < Minitest::Test
+  def test_ignores
+    fb = Factbase.new
+    fb.insert.foo = 'hello dude'
+    n =
+      Fbe.just_one(fb:) do |f|
+        f.foo = 'hello dude'
+      end
+    assert(!n.nil?)
+  end
+
+  def test_injects
+    fb = Factbase.new
+    n =
+      Fbe.just_one(fb:) do |f|
+        f.foo = 42
+      end
+    assert_equal(42, n.foo)
+  end
+end

data/test/fbe/test_overwrite.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# MIT License
+#
+# Copyright (c) 2024 Zerocracy
+#
+# 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 'factbase'
+require_relative '../test__helper'
+require_relative '../../lib/fbe/overwrite'
+
+# Test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2024 Zerocracy
+# License:: MIT
+class TestOverwrite < Minitest::Test
+  def test_simple_overwrite
+    fb = Factbase.new
+    f = fb.insert
+    f.foo = 42
+    f.bar = 'hey'
+    f.many = 3
+    f.many = 3.14
+    Fbe.overwrite(f, :foo, 55, fb:)
+    assert_equal(55, fb.query('(always)').each.to_a.first['foo'].first)
+    assert_equal('hey', fb.query('(always)').each.to_a.first['bar'].first)
+    assert_equal(2, fb.query('(always)').each.to_a.first['many'].size)
+  end
+
+  def test_simple_insert
+    fb = Factbase.new
+    f = fb.insert
+    Fbe.overwrite(f, :foo, 42, fb:)
+    assert_equal(42, fb.query('(always)').each.to_a.first['foo'].first)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fbe
 version: !ruby/object:Gem::Version
-  version: 0.0.39
+  version: 0.0.41
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -230,9 +230,11 @@ files:
 - lib/fbe/if_absent.rb
 - lib/fbe/issue.rb
 - lib/fbe/iterate.rb
+- lib/fbe/just_one.rb
 - lib/fbe/middleware.rb
 - lib/fbe/middleware/quota.rb
 - lib/fbe/octo.rb
+- lib/fbe/overwrite.rb
 - lib/fbe/pmp.rb
 - lib/fbe/regularly.rb
 - lib/fbe/sec.rb
@@ -247,7 +249,9 @@ files:
 - test/fbe/test_if_absent.rb
 - test/fbe/test_issue.rb
 - test/fbe/test_iterate.rb
+- test/fbe/test_just_one.rb
 - test/fbe/test_octo.rb
+- test/fbe/test_overwrite.rb
 - test/fbe/test_pmp.rb
 - test/fbe/test_regularly.rb
 - test/fbe/test_sec.rb