musa-dsl 0.22.2 → 0.23.0

data/lib/musa-dsl/series/main-serie-operations.rb

@@ -1,6 +1,6 @@
 module Musa
   module Series
-    module SerieOperations
+    module Operations
       def autorestart
         Autorestart.new self
       end
@@ -108,8 +108,12 @@ module Musa
 
       alias_method :eval, :with
 
-      def map(&yield_block)
-        ProcessWith.new self, &yield_block
+      def map(&block)
+        ProcessWith.new self, &block
+      end
+
+      def anticipate(&block)
+        Anticipate.new self, &block
       end
 
       ###
@@ -117,34 +121,36 @@ module Musa
       ###
 
       class ProcessWith
-        include Musa::Extension::SmartProcBinder
-        include Serie
-
-        attr_reader :source, :on_restart, :block
-        def with_sources; @sources; end
+        include Serie.with(source: true, sources: true, sources_as: :with_sources, smart_block: true)
 
         def initialize(serie, with_series = nil, on_restart = nil, &block)
-          @source = serie
-          @sources = with_series || {}
-          @on_restart = on_restart
-          @block = SmartProcBinder.new(block) if block_given?
+          self.source = serie
+          self.with_sources = with_series || {}
+          self.on_restart = on_restart
+          self.proc = block if block
+
+          init
+        end
 
-          if @source.prototype?
-            @sources = @sources.transform_values { |s| s.prototype }
+        def on_restart(&block)
+          if block
+            @on_restart = block
           else
-            @sources = @sources.transform_values { |s| s.instance }
+            @on_restart
           end
+        end
 
-          mark_regarding! @source
+        def on_restart=(block)
+          @on_restart = block
         end
 
-        def _restart
+        private def _restart
           @source.restart
-          @sources.values.each { |s| s.restart }
+          @sources.values.each(&:restart)
           @on_restart.call if @on_restart
         end
 
-        def _next_value
+        private def _next_value
           main = @source.next_value
           others = @sources.transform_values { |v| v.next_value }
 
@@ -168,31 +174,50 @@ module Musa
 
       private_constant :ProcessWith
 
-      class Switcher
-        include Serie
+      class Anticipate
+        include Serie.with(source: true, block: true)
 
-        attr_accessor :sources
-        def selector; @source; end
+        def initialize(serie, &block)
+          self.source = serie
+          self.proc = block
 
-        def initialize(selector, indexed_series, hash_series)
+          init
+        end
 
-          @source = selector
-          get = @source.prototype? ? :prototype : :instance
+        private def _restart
+          @source.restart
+        end
 
-          if indexed_series && !indexed_series.empty?
-            @sources = indexed_series.collect(&get)
-          elsif hash_series && !hash_series.empty?
-            @sources = hash_series.clone.transform_values(&get)
-          end
+        private def _next_value
+          previous_value = @source.current_value
+          value = @source.next_value
+          peek_next_value = @source.peek_next_value
 
-          if get == :_prototype!
-            @sources.freeze
+          if value.nil?
+            nil
+          else
+            @block.call(previous_value, value, peek_next_value)
           end
+        end
 
-          mark_regarding! @source
+        def infinite?
+          @source.infinite?
+        end
+      end
+
+      private_constant :Anticipate
+
+      class Switcher
+        include Serie.with(source: true, sources: true, sources_as: :options)
+
+        def initialize(selector, indexed_series, hash_series)
+          self.source = selector
+          self.options = indexed_series || hash_series
+
+          init
         end
 
-        def _restart
+        private def _restart
           @source.restart
           if @sources.is_a? Array
             @sources.each(&:restart)
@@ -201,7 +226,7 @@ module Musa
           end
         end
 
-        def _next_value
+        private def _next_value
           value = nil
 
           index_or_key = @source.next_value
@@ -219,46 +244,31 @@ module Musa
       private_constant :Switcher
 
       class MultiplexSelector
-        include Serie
-
-        def selector; @source; end
-        attr_accessor :sources
+        include Serie.with(source: true, sources: true, sources_as: :options)
 
         def initialize(selector, indexed_series, hash_series)
-          @source = selector
-          get = @source.prototype? ? :prototype : :instance
-
-          if indexed_series && !indexed_series.empty?
-            @sources = indexed_series.collect(&get)
-          elsif hash_series && !hash_series.empty?
-            @sources = hash_series.clone.transform_values(&get)
-          end
-
-          _restart false
-
-          if get == :_prototype!
-            @sources.freeze
-          end
+          self.source = selector
+          self.options = indexed_series || hash_series
 
-          mark_regarding! @source
+          init
         end
 
-        def _restart(restart_sources = true)
+        private def _init
           @current_value = nil
+          @first = true
+        end
 
-          if restart_sources
-            @source.restart
-            if @sources.is_a? Array
-              @sources.each(&:restart)
-            elsif @sources.is_a? Hash
-              @sources.each { |_key, serie| serie.restart }
-            end
-          end
+        private def _restart
+          @source.restart
 
-          @first = true
+          if @sources.is_a? Array
+            @sources.each(&:restart)
+          elsif @sources.is_a? Hash
+            @sources.values.each(&:restart)
+          end
         end
 
-        def _next_value
+        private def _next_value
           @current_value =
               if @first || !@current_value.nil?
                 @first = false
@@ -278,34 +288,21 @@ module Musa
       private_constant :MultiplexSelector
 
       class SwitchFullSerie
-        include Serie
-
-        def selector; @source; end
-        attr_accessor :sources
+        include Serie.with(source: true, sources: true, sources_as: :options)
 
         def initialize(selector, indexed_series, hash_series)
-          @source = selector
-          get = @source.prototype? ? :prototype : :instance
-
-          if indexed_series && !indexed_series.empty?
-            @sources = indexed_series.collect(&get)
-          elsif hash_series && !hash_series.empty?
-            @sources = hash_series.clone.transform_values(&get)
-          end
-
-          if get == :_prototype!
-            @sources.freeze
-          end
+          self.source = selector
+          self.options = indexed_series || hash_series
 
-          mark_regarding! @source
+          init
         end
 
-        def _restart
+        private def _restart
           @source.restart
           @sources.each(&:restart)
         end
 
-        def _next_value
+        private def _next_value
           value = nil
 
           value = @sources[@index_or_key].next_value unless @index_or_key.nil?
@@ -327,21 +324,18 @@ module Musa
       private_constant :SwitchFullSerie
 
       class InfiniteRepeater
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true)
 
         def initialize(serie)
-          @source = serie
-
-          mark_regarding! @source
+          self.source = serie
+          init
         end
 
-        def _restart
+        private def _restart
           @source.restart
         end
 
-        def _next_value
+        private def _next_value
           value = @source.next_value
 
           if value.nil?
@@ -360,38 +354,47 @@ module Musa
       private_constant :InfiniteRepeater
 
       class Repeater
-        include Serie
-
-        attr_reader :source, :times, :condition
+        include Serie.with(source: true)
 
         def initialize(serie, times = nil, &condition)
-          @source = serie
+          self.source = serie
+          self.times = times
+          self.condition = condition
 
-          @times = times
-          @external_condition = condition
+          init
+        end
 
-          _restart false
-          @condition = calculate_condition
+        attr_reader :times
 
-          mark_regarding! @source
+        def times=(value)
+          @times = value
+          calculate_condition
         end
 
-        def _prototype!
-          super
-          @condition = calculate_condition
+        def condition(&block)
+          if block
+            @external_condition = block
+            calculate_condition
+          else
+            @external_condition
+          end
         end
 
-        def _instance!
-          super
-          @condition = calculate_condition
+        def condition=(block)
+          @external_condition = block
+          calculate_condition
         end
 
-        def _restart(restart_sources = true)
+        private def _init
           @count = 0
-          @source.restart if restart_sources
+          calculate_condition
+        end
+
+        private def _restart
+          @source.restart
         end
 
-        def _next_value
+        private def _next_value
           value = @source.next_value
 
           if value.nil?
@@ -411,38 +414,39 @@ module Musa
         end
 
         private def calculate_condition
-          if @external_condition
-            @external_condition
-          elsif @times
-            proc { @count < @times }
-          else
-            proc { false }
-          end
+          @condition = if @external_condition
+                         @external_condition
+                       elsif @times
+                         proc { @count < @times }
+                       else
+                         proc { false }
+                       end
         end
       end
 
       private_constant :Repeater
 
       class LengthLimiter
-        include Serie
-
-        attr_reader :source, :length
+        include Serie.with(source: true)
 
         def initialize(serie, length)
-          @source = serie
-          @length = length
-
-          _restart false
+          self.source = serie
+          self.length = length
 
-          mark_regarding! @source
+          init
         end
 
-        def _restart(restart_sources = true)
+        attr_accessor :length
+
+        private def _init
           @position = 0
-          @source.restart if restart_sources
         end
 
-        def _next_value
+        private def _restart
+          @source.restart
+        end
+
+        private def _next_value
           if @position < @length
             @position += 1
             @source.next_value
@@ -457,25 +461,26 @@ module Musa
       private_constant :LengthLimiter
 
       class Skipper
-        include Serie
-
-        attr_reader :source, :length
+        include Serie.with(source: true)
 
         def initialize(serie, length)
-          @source = serie
-          @length = length
+          self.source = serie
+          self.length = length
 
-          _restart false
-
-          mark_regarding! @source
+          init
         end
 
-        def _restart(restart_sources = true)
-          @source.restart if restart_sources
+        attr_accessor :length
+
+        private def _init
           @first = true
         end
 
-        def _next_value
+        private def _restart
+          @source.restart
+        end
+
+        private def _next_value
           @length.times { @source.next_value } if @first
           @first = nil
 
@@ -490,40 +495,25 @@ module Musa
       private_constant :Skipper
 
       class Flattener
-        include Serie
-
-        attr_reader :source
+        include Serie.base
 
         def initialize(serie)
           @source = serie
-
-          _restart false
-
           mark_regarding! @source
+          init
         end
 
-        def _prototype!
-          super
-          _restart false
-        end
-
-        def _instance!
-          super
-          _restart false
+        private def _init
+          @stack = [@source]
+          @restart_each_serie = false
         end
 
-        def _restart(restart_sources = true)
-          if restart_sources
-            @source.restart
-            @restart_each_serie = true
-          else
-            @restart_each_serie = false
-          end
-
-          @stack = [@source]
+        private def _restart
+          @source.restart
+          @restart_each_serie = true
         end
 
-        def _next_value
+        private def _next_value
           if @stack.last
             value = @stack.last.next_value
 
@@ -550,26 +540,24 @@ module Musa
       private_constant :Flattener
 
       class MergeSerieOfSeries
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true)
 
         def initialize(serie)
-          @source = serie
-          _restart false
-
-          mark_regarding! @source
+          self.source = serie
+          init
         end
 
-        def _restart(restart_sources = true)
-          if restart_sources
-            @source.restart
-            @restart_each_serie = true
-          end
+        private def _init
           @current_serie = nil
+          @restart_each_serie = false
+        end
+
+        private def _restart
+          @source.restart
+          @restart_each_serie = true
         end
 
-        def _next_value
+        private def _next_value
           value = nil
 
           restart_current_serie_if_needed = false
@@ -606,27 +594,28 @@ module Musa
       private_constant :MergeSerieOfSeries
 
       class Processor
-        include Musa::Extension::SmartProcBinder
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true, smart_block: true)
 
         def initialize(serie, parameters, &processor)
-          @source = serie
-          @parameters = parameters
-          @processor = SmartProcBinder.new(processor)
+          self.source = serie
 
-          _restart false
+          self.parameters = parameters
+          self.proc = processor if processor
 
-          mark_regarding! @source
+          init
         end
 
-        def _restart(restart_source = true)
-          @source.restart if restart_source
+        attr_accessor :parameters
+
+        private def _init
           @pending_values = []
         end
 
-        def _next_value
+        private def _restart
+          @source.restart
+        end
+
+        private def _next_value
           if @pending_values.empty?
 
             v = @source.next_value
@@ -634,7 +623,7 @@ module Musa
             if v.nil?
               nil
             else
-              value = @processor.call(v, **@parameters)
+              value = @block.call(v, **@parameters)
 
               if value.is_a?(Array)
                 @pending_values = value
@@ -660,23 +649,22 @@ module Musa
       end
 
       class Autorestart
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true)
 
         def initialize(serie)
-          @source = serie
+          self.source = serie
+          init
+        end
 
+        private def _init
           @restart_on_next = false
-
-          mark_regarding! @source
         end
 
-        def _restart
+        private def _restart
           @source.restart
         end
 
-        def _next_value
+        private def _next_value
           if @restart_on_next
             @source.restart
             @restart_on_next = false
@@ -693,53 +681,59 @@ module Musa
       private_constant :Autorestart
 
       class Cutter
-        include Serie
-
-        attr_reader :source, :length
+        include Serie.with(source: true)
 
         def initialize(serie, length)
-          @source = serie
-          @length = length
+          self.source = serie
+          self.length = length
+          init
+        end
 
-          mark_regarding! @source
+        def source=(serie)
+          super
+          @previous&.source = serie
         end
 
-        def _restart
-          @source.restart
+        attr_reader :length
+
+        def length=(value)
+          @length = value
+          @previous&.length = value
         end
 
-        def _next_value
-          @previous.materialize if @previous
+        private def _restart
+          @source.restart
+        end
 
+        private def _next_value
+          @previous&.materialize
           @previous = CutSerie.new @source, @length if @source.peek_next_value
         end
 
-        private
-
         class CutSerie
-          include Serie
+          include Serie.with(source: true)
 
           def initialize(serie, length)
-            @source = serie
-            @length = length
+            self.source = serie.instance
+            self.length = length
 
             @values = []
-            _restart
-
-            mark_as_instance!
+            init
           end
 
+          attr_accessor :length
+
           def _prototype!
             # TODO review why cannot get prototype of a cut serie
-            raise PrototypingSerieError, 'Cannot get prototype of a cut serie'
+            raise PrototypingError, 'Cannot get prototype of a cut serie'
           end
 
-          def _restart
+          private def _init
             @count = 0
           end
 
-          def _next_value
-            value ||= @values[@count]
+          private def _next_value
+            value = @values[@count]
             value ||= @values[@count] = @source.next_value if @count < @length
 
             @count += 1
@@ -751,30 +745,29 @@ module Musa
             (@values.size..@length - 1).each { |i| @values[i] = @source.next_value }
           end
         end
+
+        private_constant :CutSerie
       end
 
       private_constant :Cutter
 
       class Locker
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true)
 
         def initialize(serie)
-          @source = serie
+          self.source = serie
+
           @values = []
           @first_round = true
 
-          _restart
-
-          mark_regarding! @source
+          init
         end
 
-        def _restart
+        private def _init
           @index = 0
         end
 
-        def _next_value
+        private def _next_value
           if @first_round
             value = @source.next_value
 
@@ -796,34 +789,33 @@ module Musa
       private_constant :Locker
 
       class Reverser
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true)
 
         def initialize(serie)
-          @source = serie
-          _restart false, false
-
-          mark_regarding! @source
+          self.source = serie
+          init
         end
 
-        def _instance!
+        def source=(serie)
+          raise ArgumentError, "A serie to reverse can't be infinite" if serie.infinite?
           super
-          _restart false, true
+          init
         end
 
-        def _restart(restart_sources = true, get_reversed = true)
-          @source.restart if restart_sources
-          @reversed = FromArray.new(next_values_array_of(@source).reverse).instance if get_reversed
+        private def _init
+          @reversed = nil
         end
 
-        def _next_value
-          @reversed.next_value
+        private def _restart
+          @source.restart
         end
 
-        private
+        private def _next_value
+          @reversed ||= Constructors.S(*next_values_array_of(@source).reverse).instance
+          @reversed.next_value
+        end
 
-        def next_values_array_of(serie)
+        private def next_values_array_of(serie)
           array = []
 
           until (value = serie.next_value).nil?
@@ -837,25 +829,27 @@ module Musa
       private_constant :Reverser
 
       class Randomizer
-        include Serie
-
-        attr_reader :source, :random
+        include Serie.with(source: true)
 
         def initialize(serie, random)
-          @source = serie
-          @random = random
+          self.source = serie
+          self.random = random
 
-          _restart false
+          init
+        end
 
-          mark_regarding! @source
+        attr_accessor :random
+
+        private def _init
+          @values = @source.to_a(duplicate: false, restart: false)
         end
 
-        def _restart(restart_sources = true)
-          @source.restart if restart_sources
-          @values = @source.to_a
+        private def _restart
+          @source.restart
+          @values = @source.to_a(duplicate: false, restart: false)
         end
 
-        def _next_value
+        private def _next_value
           if !@values.empty?
             position = @random.rand(0...@values.size)
             value = @values[position]
@@ -872,30 +866,46 @@ module Musa
       private_constant :Randomizer
 
       class Shifter
-        include Serie
-
-        attr_reader :source, :shift
+        include Serie.with(source: true)
 
         def initialize(serie, shift)
-          raise ArgumentError, "cannot shift to right an infinite serie #{serie}" if shift > 0 && serie.infinite?
-          raise ArgumentError, 'cannot shift to right: function not yet implemented' if shift > 0
+          self.source = serie
+          self.shift = shift
 
-          @source = serie
-          @shift = shift
-
-          _restart false
+          init
+        end
 
-          mark_regarding! @source
+        def source=(serie)
+          raise ArgumentError, "cannot shift to right an infinite serie" if @shift > 0 && serie.infinite?
+          super
+          # should _restart(false) ??? if so, we lost the shifted values of the previous serie; if not we don't shift the new serie values
+          # I think it's better to not _restart unless it's explicitly called by the caller
         end
 
-        def _restart(restart_sources = true)
-          @source.restart if restart_sources
+        attr_reader :shift
+
+        def shift=(value)
+          raise ArgumentError, "cannot shift to right an infinite serie" if value > 0 && @source&.infinite?
+          raise NotImplementedError, 'cannot shift to right: function not yet implemented' if value > 0
 
+          @shift = value
+        end
+
+        private def _init
           @shifted = []
-          @shift.abs.times { @shifted << @source.next_value } if @shift < 0
+          @first = true
         end
 
-        def _next_value
+        private def _restart
+          @source.restart
+        end
+
+        private def _next_value
+          if @first
+            @shift.abs.times { @shifted << @source.next_value } if @shift < 0
+            @first = false
+          end
+
           value = @source.next_value
           return value unless value.nil?
 
@@ -906,28 +916,28 @@ module Musa
       private_constant :Shifter
 
       class Remover
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true, block: true)
 
         def initialize(serie, &block)
-          @source = serie
-          @block = block
-          @history = []
+          self.source = serie
+          self.proc = block
 
-          _restart false
+          @history = []
 
-          mark_regarding! @source
+          init
         end
 
-        def _restart(restart_sources = true)
-          @source.restart if restart_sources
+        private def _init
           @history.clear
         end
 
-        def _next_value
+        private def _restart
+          @source.restart
+        end
+
+        private def _next_value
           if value = @source.next_value
-            while @block.call(value, @history)
+            while value && @block.call(value, @history)
               @history << value
               value = @source.next_value
             end
@@ -940,24 +950,20 @@ module Musa
       private_constant :Remover
 
       class Selector
-        include Serie
-
-        attr_reader :source
+        include Serie.with(source: true, block: true)
 
         def initialize(serie, &block)
-          @source = serie
-          @block = block
+          self.source = serie
+          self.proc = block
 
-          _restart false
-
-          mark_regarding! @source
+          init
         end
 
-        def _restart(restart_sources = true)
-          @source.restart if restart_sources
+        private def _restart
+          @source.restart
         end
 
-        def _next_value
+        private def _next_value
           value = @source.next_value
           until value.nil? || @block.call(value)
             value = @source.next_value
@@ -969,23 +975,22 @@ module Musa
       private_constant :Selector
 
       class HashFromSeriesArray
-        include Serie
-
-        attr_reader :source, :keys
+        include Serie.with(source: true)
 
         def initialize(serie, keys)
-          @source = serie
-          @keys = keys
-          _restart false
+          self.source = serie
+          self.keys = keys
 
-          mark_regarding! @source
+          init
         end
 
-        def _restart(restart_sources = true)
-          @source.restart if restart_sources
+        attr_accessor :keys
+
+        private def _restart
+          @source.restart
         end
 
-        def _next_value
+        private def _next_value
           array = @source.next_value
 
           return nil unless array