bmg 0.21.3 → 0.21.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 83f3d7ebfe5587af85b9823b7ab5a9d11d6e9b30
-  data.tar.gz: 34418e3d5ccfe156c3b0320e6821030a09ba1cdc
+  metadata.gz: 91f0681124b487847c3af44ea65635ebb02df727
+  data.tar.gz: e7613c53a87c753c3a8a8dfb5876de592219b0c3
 SHA512:
-  metadata.gz: f1e68f36ad0cd1a5c9ba2d2dd5fdcd8f02220c3588e5ef995439db58c46dab2bb6fa91ff249f3541ae2096e9d12f3c0d9a9d424c99310c7e90fef7cd4f460994
-  data.tar.gz: 0c9c97791462f47799be4ae510d5be7b0aa3c30360592899fbfb336f31c25762d8fe5d35d87202413f85916ce8fc9199c48d40a26a22b480fc72d497edbe1f1d
+  metadata.gz: 5948cf2f15c306b95cd289c01ea84602c250655a75de6bd884289efa4c1cb3535acbd811d77166750006f405a2d294a50135bc1eda92f390746aa0ae754c87d8
+  data.tar.gz: 9b82273935815d8808321d08dc292d3e4b3bb81a6eb97ef757715e4d7b0f6ff511d6ea648cb9851dee767cb29bb27559611a31494ad3fdcddbd8298fdcfa40e2

data/README.md

@@ -197,15 +197,17 @@ type = Bmg::Type::ANY.with_keys([[:id]])
 r = Bmg.redis(type, {
   key_prefix: "suppliers",
   redis: Redis.new,
-  serializer: :marshal
+  serializer: :marshal,
+  ttl: 365 * 24 * 60 * 60
 })
 ```
 
-The key prefix will be used to distinguish the tuples from other
-elements in the same database (e.g. tuples from other relvars).
-The serializer is either `:marshal` or `:json`. Please note that
-types are not preserved when using the second one (all attribute
-values will come back as strings, but keys will be symbolized).
+The key prefix will be used to distinguish the tuples from other elements in the
+same database (e.g. tuples from other relvars). The serializer is either
+`:marshal` or `:json`. Please note that types are not preserved when using the
+second one (all attribute values will come back as strings, but keys will be
+symbolized). The `ttl` is used to set the validity period of a tuple in redis
+and is optional.
 
 The redis relvars support basic algorithms for insert/update/delete.
 No optimization is currently supported.
@@ -245,14 +247,15 @@ r.allbut([:a, :b, ...])                      # remove specified attributes
 r.autowrap(split: '_')                       # structure a flat relation, split: '_' is the default
 r.autosummarize([:a, :b, ...], x: :sum)      # (experimental) usual summarizers supported
 r.constants(x: 12, ...)                      # add constant attributes (sometimes useful in unions)
+r.cross_product(right)                       # cross product, alias `cross_join`
 r.extend(x: ->(t){ ... }, ...)               # add computed attributes
 r.extend(x: :y)                              # shortcut for r.extend(x: ->(t){ t[:y] })
 r.exclude(predicate)                         # shortcut for restrict(!predicate)
 r.group([:a, :b, ...], :x)                   # relation-valued attribute from attributes
 r.image(right, :x, [:a, :b, ...])            # relation-valued attribute from another relation
 r.images({:x => r1, :y => r2}, [:a, ...])    # shortcut over image(r1, :x, ...).image(r2, :y, ...)
-r.join(right, [:a, :b, ...])                 # natural join on a join key
-r.join(right, :a => :x, :b => :y, ...)       # natural join after right reversed renaming
+r.join(right, [:a, :b, ...])                 # join on a join key
+r.join(right, :a => :x, :b => :y, ...)       # join after right reversed renaming
 r.left_join(right, [:a, :b, ...], {...})     # left join with optional default right tuple
 r.left_join(right, {:a => :x, ...}, {...})   # left join after right reversed renaming
 r.matching(right, [:a, :b, ...])             # semi join, aka where exists
@@ -267,10 +270,10 @@ r.restrict(a: "foo", b: "bar", ...)          # relational restriction, aka where
 r.rxmatch([:a, :b, ...], /xxx/)              # regex match kind of restriction
 r.summarize([:a, :b, ...], x: :sum)          # relational summarization
 r.suffix(:_foo, but: [:a, ...])              # suffix kind of renaming
-t.transform(:to_s)                           # all-attrs transformation
-t.transform(&:to_s)                          # similar, but Proc-driven
-t.transform(:foo => :upcase, ...)            # specific-attrs tranformation
-t.transform([:to_s, :upcase])                # chain-transformation
+r.transform(:to_s)                           # all-attrs transformation
+r.transform(&:to_s)                          # similar, but Proc-driven
+r.transform(:foo => :upcase, ...)            # specific-attrs tranformation
+r.transform([:to_s, :upcase])                # chain-transformation
 r.ungroup([:a, :b, ...])                     # ungroup relation-valued attributes within parent tuple
 r.ungroup(:a)                                # shortcut over ungroup([:a])
 r.union(right)                               # relational union

data/lib/bmg/algebra/shortcuts.rb

@@ -57,6 +57,14 @@ module Bmg
         self.left_join(right.rename(renaming), on.keys, *args)
       end
 
+      def cross_product(right)
+        return join(right) unless self.type.typechecked? || right.type.typechecked?
+        return join(right) unless self.type.knows_attrlist? && right.type.knows_attrlist?
+
+        self.type.cross_join_compatible!(right)
+        return join(right)
+      end
+
       def matching(right, on = [])
         return super unless on.is_a?(Hash)
         renaming = Hash[on.map{|k,v| [v,k] }]

data/lib/bmg/type.rb

@@ -310,7 +310,7 @@ module Bmg
       }
     end
 
-  private
+  public
 
     def known_attributes!(attrs)
       extra = attrs - self.attrlist
@@ -331,5 +331,12 @@ module Bmg
       end
     end
 
+    def cross_join_compatible!(right)
+      shared = self.attrlist & right.type.attrlist
+      unless shared.empty?
+        raise TypeError, "Cross product incompatible — duplicate attribute(s): #{shared.join(', ')}"
+      end
+    end
+
   end # class Type
 end # module Bmg

data/lib/bmg/version.rb

@@ -2,7 +2,7 @@ module Bmg
   module Version
     MAJOR = 0
     MINOR = 21
-    TINY  = 3
+    TINY  = 5
   end
   VERSION = "#{Version::MAJOR}.#{Version::MINOR}.#{Version::TINY}"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bmg
 version: !ruby/object:Gem::Version
-  version: 0.21.3
+  version: 0.21.5
 platform: ruby
 authors:
 - Bernard Lambeau
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-18 00:00:00.000000000 Z
+date: 2024-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: predicate