bmg 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c6fe9a06a0c6fbf5f5f0523b3ade5d59ac077c3b
-  data.tar.gz: 3d0dd15b128fe42a6eb603b922de1c8889d266c8
+  metadata.gz: bc75e7b5602e1f76e3581009746302b3a546f3f8
+  data.tar.gz: 5dee61974de7699b5ef4957cd2714d5d241df830
 SHA512:
-  metadata.gz: e608c650a868dc5d4870a6847675dbae8742525a53e255732c6634c85b911f31528d7a57cbd580eb74c3f85610590abfb0e792532a71dee23cf61b20e15aa713
-  data.tar.gz: 1b082e58ffce43e55e85ff36753b0d2d5e579e947a44010dd85a839e82ca4f6a371cb882ae32bc6b34e159936e0f21e1e8f8e944ef4ada4d43ff92ee48fa9b3d
+  metadata.gz: cdad32c048da1719f153a16f355a79b13cd68cd18cf017c47041b7d73992f18c19cbdf9c5c32cf366e8801a0ac98a0ef84237120a7f8e59e9d3274feecd8a715
+  data.tar.gz: 28e09b93f01a6aaa0c8e95adba0bf8b417dbf501e9b5b221c8593a5f53f9cdebe04fb636b7fe641ddf41ba3ff6a706de0ab6c9d4c70b70f49f6a9c055e3041cd

data/lib/bmg.rb

@@ -13,6 +13,7 @@ module Bmg
 
 end
 require_relative 'bmg/version'
+require_relative 'bmg/error'
 require_relative 'bmg/operator'
 require_relative 'bmg/relation'
 require_relative 'bmg/reader'

data/lib/bmg/error.rb

@@ -0,0 +1,9 @@
+module Bmg
+
+  # Main parent of all Bmg errors
+  class Error < StandardError; end
+
+  # Raised by Relation#one when the relation is not a singleton
+  class OneError < Error; end
+
+end

data/lib/bmg/operator.rb

@@ -12,3 +12,4 @@ require_relative 'operator/autosummarize'
 require_relative 'operator/autowrap'
 require_relative 'operator/project'
 require_relative 'operator/rename'
+require_relative 'operator/extend'

data/lib/bmg/operator/extend.rb

@@ -0,0 +1,38 @@
+module Bmg
+  module Operator
+    #
+    # Extend operator.
+    #
+    # Extends operand's tuples with attributes
+    # resulting from given computations
+    #
+    # Example:
+    #
+    #   [{ a: 1 }] extend { b: ->(t){ 2 } } => [{ a: 1, b: 2 }]
+    #
+    class Extend
+      include Operator
+
+      def initialize(operand, extension)
+        @operand = operand
+        @extension = extension
+      end
+
+      def each
+        @operand.each do |tuple|
+          yield extend_it(tuple)
+        end
+      end
+
+    private
+
+      def extend_it(tuple)
+        @extension.each_with_object(tuple.dup) { |(k,v), memo|
+          memo[k] = v.call(tuple)
+          memo
+        }
+      end
+
+    end # class Extend
+  end # module Operator
+end # module Bmg

data/lib/bmg/relation.rb

@@ -6,10 +6,38 @@ module Bmg
       @operand = operand
     end
 
+    ## Consumption methods
+
     def each(&bl)
       @operand.each(&bl)
     end
 
+    # Private helper to implement `one` and `one_or_nil`
+    def one_or_yield(&bl)
+      first = nil
+      each do |x|
+        raise OneError, "Relation has more than one tuple" unless first.nil?
+        first = x
+      end
+      first.nil? ? bl.call : first
+    end
+    private :one_or_yield
+
+    # Returns the only tuple that the relation contains.
+    # Throws a OneException when there is no tuple or more than one
+    def one
+      one_or_yield{ raise OneError, "Relation is empty" }
+    end
+
+    # Returns the only tuple that the relation contains.
+    # Returns nil if the relation is empty.
+    # Throws a OneException when the relation contains more than one tuple
+    def one_or_nil
+      one_or_yield{ nil }
+    end
+
+    ## Relational algebra
+
     def allbut(butlist = [])
       Relation.new Operator::Allbut.new(@operand, butlist)
     end
@@ -22,6 +50,10 @@ module Bmg
       Relation.new Operator::Autosummarize.new(@operand, by, summarization)
     end
 
+    def extend(extension = {})
+      Relation.new Operator::Extend.new(@operand, extension)
+    end
+
     def project(attrlist = [])
       Relation.new Operator::Project.new(@operand, attrlist)
     end

data/lib/bmg/version.rb

@@ -1,8 +1,8 @@
 module Bmg
   module Version
     MAJOR = 0
-    MINOR = 1
-    TINY  = 1
+    MINOR = 2
+    TINY  = 0
   end
   VERSION = "#{Version::MAJOR}.#{Version::MINOR}.#{Version::TINY}"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bmg
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Bernard Lambeau
@@ -78,10 +78,12 @@ files:
 - README.md
 - Rakefile
 - lib/bmg.rb
+- lib/bmg/error.rb
 - lib/bmg/operator.rb
 - lib/bmg/operator/allbut.rb
 - lib/bmg/operator/autosummarize.rb
 - lib/bmg/operator/autowrap.rb
+- lib/bmg/operator/extend.rb
 - lib/bmg/operator/project.rb
 - lib/bmg/operator/rename.rb
 - lib/bmg/reader.rb