musa-dsl 0.23.3 → 0.23.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7ac7a74db8d0006786f871ba33f6d417704910b11eaab5a568fff617962ad52
-  data.tar.gz: 771ea64584e00fe078f4959537472032ae8438e4cb38b9a7cf1f6798a92a91de
+  metadata.gz: aedf1b2e55be310702169b869ff68a41c79d0d787002b21918c096ad18373dcf
+  data.tar.gz: 4bc6bd9694bffe3c97040e2d33e4a451accdeb5e621346c030fc699c2325ba5d
 SHA512:
-  metadata.gz: 9dd7592546589149d420e6681befca0acea4afde5d07676bb1bfa1f01ec9ff0ce541673618fbd5cd16e549d69034698c682e9a5a8eec61547cbc5be6f8e6c5bf
-  data.tar.gz: 5e4d56c555bc66cf5574a73d58c1c4f17027e4b6256d1b2f866337cefb8f776b8b6ce3987ad586c5171da4e69308a8d957e98b83d1f2387ccff3211e6eaf152a
+  metadata.gz: 30173d87a84a7d4288ddd00f5b212a9178f6f1836f673972f4c29c6528d57231588c4e9152ce06ba24319e834aac087a25f793ca8bf862d83d8bfae898c7d620
+  data.tar.gz: de0f34c68858de9629d2e65f9c0d794c2bb122855716476130b35f921297b731facd1b039c339235ec7168bedafa1652611722cc9ac684e3f66748b5275fa101

data/Gemfile

@@ -1,5 +1,7 @@
 source 'https://rubygems.org'
 
+ruby '2.7.3'
+
 gem 'logger', '~> 1.4', '>= 1.4.3'
 
 group :neuma do

data/lib/musa-dsl/generative/markov.rb

@@ -9,7 +9,6 @@ module Musa
       include Musa::Extension::SmartProcBinder
       include Musa::Series::Serie.base
 
-
       def initialize(transitions:, start:, finish: nil, random: nil)
         @transitions = transitions.clone.freeze
 
@@ -21,6 +20,7 @@ module Musa
 
         @procedure_binders = {}
 
+        mark_as_prototype!
         init
       end
 

data/lib/musa-dsl/series/base-series.rb

@@ -12,24 +12,36 @@ module Musa
 
     module Serie
       def self.base
-        SerieImplementation
+        Module.new do
+          include SerieImplementation
+
+          def has_source; false; end
+          private def mandatory_source; false; end
+
+          def has_sources; false; end
+          private def mandatory_sources; false; end
+        end
       end
 
       def self.with(source: false,
                     source_as: nil,
                     private_source: nil,
+                    mandatory_source: nil,
                     sources: false,
                     sources_as: nil,
                     private_sources: nil,
+                    mandatory_sources: nil,
                     smart_block: false,
                     block: false,
                     block_as: nil)
 
         source_as ||= :source
         source_setter = (source_as.to_s + '=').to_sym
+        _mandatory_source = source if mandatory_source.nil?
 
         sources_as ||= :sources
         sources_setter = (sources_as.to_s + '=').to_sym
+        _mandatory_sources = sources if mandatory_sources.nil?
 
         block_as ||= :proc
         block_setter = (block_as.to_s + '=').to_sym
@@ -38,15 +50,19 @@ module Musa
           include SerieImplementation
 
           if source
+            private def has_source; true; end
+            define_method(:mandatory_source) { _mandatory_source }
+            private :mandatory_source
+
             define_method source_as do
               @source
             end
 
             define_method source_setter do |serie|
-              raise ArgumentError, "New #{source_as} should be a #{@get}" unless @source.nil? || @source.prototype? == serie&.prototype?
+              unless @source.nil? || @source.undefined? || serie.state == @source.state
+                raise ArgumentError, "New serie for #{source_as} should be a #{@state} instead of a #{serie.state}"
+              end
 
-              serie ||= Musa::Series::Constructors.NIL
-              @get = serie&.instance? ? :instance : :prototype
               @source = serie
               mark_regarding! @source
             end
@@ -55,45 +71,49 @@ module Musa
               private source_as
               private source_setter
             end
+          else
+            private def has_source; false; end
+            private def mandatory_source; false; end
           end
 
           if sources
-            define_method sources_as do ||
+            private def has_sources; true; end
+            define_method(:mandatory_sources) { _mandatory_sources }
+            private :mandatory_source
+
+            define_method sources_as do
               @sources
             end
 
             define_method sources_setter do |series|
-              case series
-              when Array
-                getter = @get || ((series.first)&.instance? ? :instance : :prototype)
-                @sources = series.collect(&getter)
-              when Hash
-                getter = @get || ((series.values.first)&.instance? ? :instance : :prototype)
-                @sources = series.transform_values(&getter)
-              else
-                raise ArgumentError, "Only allowed Array or Hash"
+              unless series.is_a?(Hash) || series.is_a?(Array)
+                raise ArgumentError, "New series for #{sources_as} should be a Hash or an Array instead of a #{series.class.name}"
               end
 
-              mark_as! getter
+              @sources = series
+              try_to_resolve_undefined_state_if_needed
             end
 
             if private_sources
               private sources_as
               private sources_setter
             end
+          else
+            private def has_sources; false; end
+            private def mandatory_sources; false; end
           end
 
           if smart_block
             define_method block_as do |&block|
               if block
-                @block = Musa::Extension::SmartProcBinder::SmartProcBinder.new(block)
+                @block = Extension::SmartProcBinder::SmartProcBinder.new(block)
               else
                 @block.proc
               end
             end
 
             define_method block_setter do |block|
-              @block = Musa::Extension::SmartProcBinder::SmartProcBinder.new(block)
+              @block = Extension::SmartProcBinder::SmartProcBinder.new(block)
             end
 
           elsif block
@@ -113,35 +133,53 @@ module Musa
       end
 
       module Prototyping
+        def state
+          try_to_resolve_undefined_state_if_needed
+          @state || :undefined
+        end
+
         def prototype?
-          @is_instance ? false : true
+          try_to_resolve_undefined_state_if_needed
+          @state&.==(:prototype)
         end
 
         def instance?
-          @is_instance ? true : false
+          try_to_resolve_undefined_state_if_needed
+          @state&.==(:instance)
+        end
+
+        def undefined?
+          try_to_resolve_undefined_state_if_needed
+          @state.nil? || @state == :undefined
+        end
+
+        def defined?
+          !undefined?
         end
 
         def prototype
-          if @is_instance
-            if !@instance_of
-              @instance_of = clone
-              @instance_of._prototype!
-              @instance_of.mark_as_prototype!
-              @instance_of.init if @instance_of.respond_to?(:init)
-            end
+          try_to_resolve_undefined_state_if_needed
 
+          if prototype?
+            self
+          elsif instance?
+            # if the series has been directly created as an instance (i.e., because is an operation over an instance)
+            # the prototype doesn't exist.
+            #
             @instance_of
           else
-            self
+            raise PrototypingError, 'Can\'t get the prototype of an undefined serie'
           end
         end
 
         alias_method :p, :prototype
 
         def instance
-          if @is_instance
+          try_to_resolve_undefined_state_if_needed
+
+          if instance?
             self
-          else
+          elsif prototype?
             new_instance = clone
 
             new_instance._instance!
@@ -149,6 +187,8 @@ module Musa
             new_instance.init if new_instance.respond_to?(:init)
 
             new_instance
+          else
+            raise PrototypingError, 'Can\'t get an instance of an undefined serie'
           end
         end
 
@@ -163,61 +203,128 @@ module Musa
         protected def _prototype!
           @source = @source.prototype if @source
 
-          if @sources
-            if @sources.is_a?(Array)
-              @sources = @sources.collect(&:prototype)
-            elsif @sources.is_a?(Hash)
-              @sources = @sources.transform_values(&:prototype)
-            end
+          case @sources
+          when Array
+            @sources = @sources.collect(&:prototype)
+          when Hash
+            @sources = @sources.transform_values(&:prototype)
           end
         end
 
         protected def _instance!
           @source = @source.instance if @source
 
-          if @sources
-            if @sources.is_a?(Array)
-              @sources = @sources.collect(&:instance)
-            elsif @sources.is_a?(Hash)
-              @sources = @sources.transform_values(&:instance)
-            end
+          case @sources
+          when Array
+            @sources = @sources.collect(&:instance)
+          when Hash
+            @sources = @sources.transform_values(&:instance)
           end
         end
 
-        protected def mark_as!(getter)
-          case getter
+        protected def mark_as!(state)
+          case state
+          when nil, :undefined
+            mark_as_undefined!
           when :prototype
             mark_as_prototype!
           when :instance
             mark_as_instance!
           else
-            raise ArgumentError, "Only can be marked as :prototype or :instance"
+            raise ArgumentError, "Unexpected state #{state}. Only accepted nil, :undefined, :prototype or :instance."
           end
         end
 
         protected def mark_regarding!(source)
-          if source.prototype?
+          if source.nil? || source.undefined?
+            mark_as_undefined!
+          elsif source.prototype?
             mark_as_prototype!
-          else
+          elsif source.instance?
             mark_as_instance!
           end
         end
 
+        protected def mark_as_undefined!
+          @state = :undefined
+          self
+        end
+
         protected def mark_as_prototype!
-          @get = :prototype
+          notify = @state != :prototype
 
-          @is_instance = nil
+          @state = :prototype
+
+          _sources_resolved if notify
           self
         end
 
         protected def mark_as_instance!(prototype = nil)
-          @get = :instance
+          notify = @state != :instance
 
+          @state = :instance
           @instance_of = prototype
-          @is_instance = true
+
+          _sources_resolved if notify
           self
         end
 
+        protected def _sources_resolved; end
+
+        private def try_to_resolve_undefined_state_if_needed
+
+          return unless @state.nil? || @state == :undefined
+
+          states = []
+
+          if has_source
+            if mandatory_source
+              states << @source&.state || :undefined
+            elsif @source
+              states << @source.state
+            end
+          end
+
+          if has_sources
+            sources = case @sources
+                      when Array
+                        @sources
+                      when Hash
+                        @sources.values
+                      when nil
+                        []
+                      end
+
+            undefined_sources =
+              sources.empty? ||
+                sources.any?(&:undefined?) ||
+                sources.any?(&:instance?) && sources.any?(&:prototype?)
+
+            instance_sources = sources.all?(&:instance?) unless undefined_sources
+
+            sources_state = if undefined_sources
+                              :undefined
+                            elsif instance_sources
+                              :instance
+                            else
+                              :prototype
+                            end
+
+            if mandatory_sources
+              states << sources_state
+            elsif !(@sources.nil? || @sources.empty?)
+              states << sources_state
+            end
+          end
+
+          # in case of having source and sources, if both states are equal the final state is that one, else the final state is undefined
+          #
+          new_state = states.first if states.first == states.last
+          new_state ||= :undefined
+
+          mark_as!(new_state)
+        end
+
         class PrototypingError < RuntimeError
           def initialize(message = nil)
             message ||= 'This serie is a prototype serie: cannot be consumed. To consume the serie use an instance serie via .instance method'
@@ -245,7 +352,7 @@ module Musa
         private def _init; end
 
         def restart(...)
-          raise PrototypingError unless @is_instance
+          check_state_permissions
           init
           _restart(...)
 
@@ -255,7 +362,7 @@ module Musa
         private def _restart; end
 
         def next_value
-          raise PrototypingError unless @is_instance
+          check_state_permissions
 
           unless @_have_current_value && @_current_value.nil?
             if @_have_peeked_next_value
@@ -274,7 +381,7 @@ module Musa
         alias_method :v, :next_value
 
         def peek_next_value
-          raise PrototypingError unless @is_instance
+          check_state_permissions
 
           if !@_have_peeked_next_value
             @_have_peeked_next_value = true
@@ -285,16 +392,20 @@ module Musa
         end
 
         def current_value
-          raise PrototypingError unless @is_instance
+          check_state_permissions
 
           @_current_value
         end
 
         def infinite?
+          check_state_permissions(allows_prototype: true)
           @source&.infinite? || false
         end
 
-        def to_a(recursive: nil, duplicate: nil, restart: nil, dr: nil)
+        def to_a(duplicate: nil, recursive: nil, restart: nil, dr: nil)
+          check_state_permissions(allows_prototype: true)
+          raise 'Cannot convert to array an infinite serie' if infinite?
+
           recursive ||= false
 
           dr = instance? if dr.nil?
@@ -302,8 +413,6 @@ module Musa
           duplicate = dr if duplicate.nil?
           restart = dr if restart.nil?
 
-          raise 'Cannot convert to array an infinite serie' if infinite?
-
           array = []
 
           serie = instance
@@ -324,12 +433,37 @@ module Musa
 
         alias_method :a, :to_a
 
+        private def process_for_to_a(value)
+          case value
+          when Serie
+            value.to_a(recursive: true, restart: false, duplicate: false)
+          when Array
+            a = value.clone
+            a.collect! { |v| v.is_a?(Serie) ? v.to_a(recursive: true, restart: false, duplicate: false) : process_for_to_a(v) }
+          when Hash
+            h = value.clone
+            h.transform_values! { |v| v.is_a?(Serie) ? v.to_a(recursive: true, restart: false, duplicate: false) : process_for_to_a(v) }
+          else
+            value
+          end
+        end
+
         def to_node(**attributes)
           Nodificator.to_node(self, **attributes)
         end
 
         alias_method :node, :to_node
 
+        private def check_state_permissions(allows_prototype: nil)
+          try_to_resolve_undefined_state_if_needed
+
+          raise PrototypingError if !allows_prototype && prototype?
+
+          unless instance? || prototype?
+            raise PrototypingError, 'This serie is in undefined state: cannot be consumed. To consume the serie be sure the serie\'s sources are all in a defined state.'
+          end
+        end
+
         class Nodificator
           extend Musa::GenerativeGrammar
 
@@ -339,21 +473,6 @@ module Musa
         end
 
         private_constant :Nodificator
-
-        private def process_for_to_a(value)
-          case value
-          when Serie
-            value.to_a(recursive: true, restart: false, duplicate: false)
-          when Array
-            a = value.clone
-            a.collect! { |v| v.is_a?(Serie) ? v.to_a(recursive: true, restart: false, duplicate: false) : process_for_to_a(v) }
-          when Hash
-            h = value.clone
-            h.transform_values! { |v| v.is_a?(Serie) ? v.to_a(recursive: true, restart: false, duplicate: false) : process_for_to_a(v) }
-          else
-            value
-          end
-        end
       end
 
       private_constant :SerieImplementation

data/lib/musa-dsl/series/buffer-serie.rb

@@ -30,7 +30,7 @@ module Musa
 
       def buffer
         @buffer ||= Buffer.new(@history)
-        @buffer.send(@get).tap { |_| @buffers << _ }
+        @buffer.send(state).tap { |_| @buffers << _ }
       end
 
       private def clear_old_history
@@ -51,6 +51,7 @@ module Musa
         def initialize(history)
           @history = history
           @last_nil_index = -1
+          mark_as_prototype!
           init
         end
 
@@ -102,19 +103,31 @@ module Musa
         @nils = [0]
         @buffers = Set[]
 
-        @singleton = nil
         @buffer = nil
 
         init
       end
 
-      def instance
-        @singleton ||= super
+      def buffer
+        Buffer.new(self)
       end
 
-      def buffer
-        @buffer ||= Buffer.new(self)
-        @buffer
+      def _sources_resolved
+        (prototype || self).singleton = self if instance?
+      end
+
+      protected def singleton=(the_instance)
+        @singleton ||= the_instance
+      end
+
+      def singleton
+        if instance?
+          prototype.nil? ? @singleton : prototype.singleton
+        elsif prototype?
+          @singleton
+        else
+          raise "ES UNDEFINED!"
+        end
       end
 
       private def _restart(buffer)
@@ -163,9 +176,7 @@ module Musa
       private def clear_old_history
         min_last_nil_index = @buffers.collect(&:last_nil_index).min
 
-        if min_last_nil_index && min_last_nil_index >=0
-
-          pre_nils = @nils.clone
+        if min_last_nil_index && min_last_nil_index >= 0
           @history = @history.drop(min_last_nil_index)
 
           @nils.collect! { |_| _ - min_last_nil_index }
@@ -182,9 +193,6 @@ module Musa
 
         def initialize(base)
           self.source = base
-
-          mark_as_prototype! # necesario para que se creen instancias diferentes cada vez que se ejecute BufferSerie.buffer()
-
           init
         end
 
@@ -198,13 +206,18 @@ module Musa
           @index -= offset
         end
 
-        private def _init
-          @source._register(self) if instance?
+        # private def _init
+        #   @source.prototype.singleton._register(self) if instance?
+        #   @index = @last_nil_index
+        # end
+        #
+        private def _sources_resolved
+          @source.singleton._register(self) if instance?
           @index = @last_nil_index
         end
 
         private def _restart
-          @source.restart(self)
+          @source.singleton.restart(self)
           @needs_restart = false
         end
 
@@ -216,7 +229,7 @@ module Musa
               @index += 1
               value = @history[@index]
             else
-              value = _next_value unless @source.next_value.nil?
+              value = _next_value unless @source.singleton.next_value.nil?
             end
 
             if value.nil?

data/lib/musa-dsl/series/hash-or-array-serie-splitter.rb

@@ -5,26 +5,30 @@ module Musa
     end
 
     class Splitter
+      include Series::Serie.with(source: true)
       include Enumerable
-      include Series::Serie::Prototyping
+
+      private def has_source; true; end
+      private def has_sources; false; end
 
       def initialize(source)
-        @source = source
+        self.source = source
         @series = {}
+
+        init
       end
 
       def source=(serie)
-        @source = serie
+        super
         @proxy.source = @source if @proxy
       end
 
-      protected def _instance!
-        super
+      def _sources_resolved
         @proxy = SplitterProxy.new(@source)
       end
 
       def [](key_or_index)
-        raise "Can't get a component because Splitter is a prototype. To get a component you need a Splitter instance." unless @is_instance
+        raise "Can't get a component because Splitter is a prototype. To get a component you need a Splitter instance." unless instance?
 
         if @series.key?(key_or_index)
           @series[key_or_index]
@@ -34,7 +38,7 @@ module Musa
       end
 
       def each
-        raise "Can't iterate because Splitter is a prototype. To iterate you need a Splitter instance." unless @is_instance
+        raise "Can't iterate because Splitter is in state '#{state}'. To iterate you need a Splitter in state 'instance'." unless instance?
 
         if block_given?
           if @proxy.hash_mode?
@@ -162,6 +166,8 @@ module Musa
         end
       end
 
+      private_constant :SplitterProxy
+
       class Split
         include Series::Serie.base
 

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

@@ -10,6 +10,10 @@ using Musa::Extension::ExplodeRanges
 
 module Musa
   module Series::Constructors
+    def UNDEFINED
+      UndefinedSerie.new
+    end
+
     def NIL
       NilSerie.new
     end
@@ -99,8 +103,22 @@ module Musa
     ### Implementation
     ###
 
+    class UndefinedSerie
+      include Series::Serie.base
+
+      def initialize
+        mark_as_undefined!
+      end
+    end
+
+    private_constant :UndefinedSerie
+
     class NilSerie
-      include Musa::Series::Serie.base
+      include Series::Serie.base
+
+      def initialize
+        mark_as_prototype!
+      end
 
       def _next_value; nil; end
     end
@@ -108,7 +126,7 @@ module Musa
     private_constant :NilSerie
 
     class FromArray
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(values = nil, extends = nil)
         @values = values
@@ -143,15 +161,14 @@ module Musa
     # private_constant :FromArray
 
     class Sequence
-      include Musa::Series::Serie.with(sources: true)
+      include Series::Serie.with(sources: true)
 
       def initialize(series)
         self.sources = series
-
         init
       end
 
-      attr_accessor :sources
+      attr_reader :sources
 
       private def _init
         @index = 0
@@ -189,9 +206,9 @@ module Musa
     private_constant :Sequence
 
     class FromEvalBlockWithParameters
-      include Musa::Series::Serie.with(smart_block: true)
+      include Series::Serie.with(smart_block: true)
 
-      using Musa::Extension::DeepCopy
+      using Extension::DeepCopy
 
       def initialize(*parameters, **key_parameters, &block)
         raise ArgumentError, 'Yield block is undefined' unless block
@@ -245,7 +262,7 @@ module Musa
     private_constant :FromEvalBlockWithParameters
 
     class ForLoop
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(from, to, step)
         @from = from
@@ -303,7 +320,7 @@ module Musa
     private_constant :ForLoop
 
     class RandomValueFromArray
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(values, random)
         @values = values
@@ -332,7 +349,7 @@ module Musa
     private_constant :RandomValueFromArray
 
     class RandomNumberFromRange
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(from, to, step, random)
         @from = from
@@ -392,7 +409,7 @@ module Musa
     private_constant :RandomNumberFromRange
 
     class RandomValuesFromArray
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(values, random)
         @values = values.clone.freeze
@@ -424,7 +441,7 @@ module Musa
     private_constant :RandomValuesFromArray
 
     class RandomNumbersFromRange
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(from, to, step, random)
         @from = from
@@ -486,7 +503,7 @@ module Musa
     private_constant :RandomNumbersFromRange
 
     class FromHashOfSeries
-      include Musa::Series::Serie.with(sources: true)
+      include Series::Serie.with(sources: true)
 
       def initialize(hash_of_series, cycle_all_series)
         self.sources = hash_of_series
@@ -545,7 +562,7 @@ module Musa
     private_constant :FromHashOfSeries
 
     class FromArrayOfSeries
-      include Musa::Series::Serie.with(sources: true)
+      include Series::Serie.with(sources: true)
 
       def initialize(series_array, cycle_all_series)
         self.sources = series_array
@@ -604,7 +621,7 @@ module Musa
     private_constant :FromArrayOfSeries
 
     class SinFunction
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(start, steps, amplitude, center)
         @start = start.to_f
@@ -679,7 +696,7 @@ module Musa
     private_constant :SinFunction
 
     class Fibonacci
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize
         mark_as_prototype!
@@ -707,7 +724,7 @@ module Musa
     private_constant :Fibonacci
 
     class HarmonicNotes
-      include Musa::Series::Serie.base
+      include Series::Serie.base
 
       def initialize(error, extended)
         @error = error

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

@@ -125,7 +125,9 @@ module Musa
       ###
 
       class ProcessWith
-        include Serie.with(source: true, sources: true, sources_as: :with_sources, smart_block: true)
+        include Serie.with(source: true,
+                           sources: true, sources_as: :with_sources, mandatory_sources: false,
+                           smart_block: true)
 
         def initialize(serie, with_series = nil, on_restart = nil, &block)
           self.source = serie
@@ -800,12 +802,6 @@ module Musa
           init
         end
 
-        def source=(serie)
-          raise ArgumentError, "A serie to reverse can't be infinite" if serie.infinite?
-          super
-          init
-        end
-
         private def _init
           @reversed = nil
         end
@@ -815,6 +811,8 @@ module Musa
         end
 
         private def _next_value
+          raise ArgumentError, "A serie to reverse can't be infinite" if @source.infinite?
+
           @reversed ||= Constructors.S(*next_values_array_of(@source).reverse).instance
           @reversed.next_value
         end

data/lib/musa-dsl/series/proxy-serie.rb

@@ -22,10 +22,6 @@ module Musa
         @source.next_value if @source
       end
 
-      def infinite?
-        @source.infinite? if @source
-      end
-
       private def method_missing(method_name, *args, **key_args, &block)
         if @source
           if @source.respond_to?(method_name)

data/lib/musa-dsl/series/series-composer.rb

@@ -4,13 +4,58 @@ require_relative '../core-ext/with'
 
 module Musa
   module Series
+    module Operations
+      def composer(&block)
+        ComposerAsOperationSerie.new(self, &block)
+      end
+
+      class ComposerAsOperationSerie
+        include Serie.with(source: true)
+
+        def initialize(serie, &block)
+          self.source = serie
+          @block = block
+
+          init
+        end
+
+        attr_reader :composer
+
+        private def _init
+          @composer = Composer::Composer.new(input: @source, &@block)
+          @output = @composer.output
+        end
+
+        private def _restart
+          @output.restart
+        end
+
+        private def _next_value
+          @output.next_value
+        end
+      end
+    end
+
     module Composer
       class Composer
         using Musa::Extension::Arrayfy
 
-        def initialize(inputs: [:input], outputs: [:output], auto_commit: nil, &block)
+        def initialize(input: nil, inputs: [:input], outputs: [:output], auto_commit: nil, &block)
           auto_commit = true if auto_commit.nil?
 
+          inputs = case inputs
+                   when Array
+                     inputs.collect { |_| [_, nil] }.to_h
+                   when nil
+                     {}
+                   when Hash
+                     inputs
+                   else
+                     raise ArgumentError, "inputs: expected a Hash with input names and source series { name: serie, ... } or an Array with names [name, ...] but received #{inputs}"
+                   end
+
+          inputs[:input] = input if input
+
           @pipelines = {}
 
           def @pipelines.[]=(name, pipeline)
@@ -22,8 +67,9 @@ module Musa
           @inputs = {}
           @outputs = {}
 
-          inputs&.each do |input|
-            p = PROXY()
+          inputs.keys&.each do |input|
+            p = PROXY(inputs[input])
+
             @inputs[input] = @pipelines[input] = Pipeline.new(input, input: p, output: p.buffered, pipelines: @pipelines)
 
             @dsl.define_singleton_method(input) { input }
@@ -98,7 +144,8 @@ module Musa
           end
 
           def commit!
-            first_serie_operation = @first_proc&.call(NIL())
+            first_serie_operation = @first_proc&.call(UNDEFINED())
+
             @input ||= first_serie_operation
 
             @routes.each_value do |route|

data/musa-dsl.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name        = 'musa-dsl'
-  s.version     = '0.23.3'
-  s.date        = '2021-07-28'
+  s.version     = '0.23.8'
+  s.date        = '2021-08-03'
   s.summary     = 'A simple Ruby DSL for making complex music'
   s.description = 'Musa-DSL: A Ruby framework and DSL for algorithmic sound and musical thinking and composition'
   s.authors     = ['Javier Sánchez Yeste']

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: musa-dsl
 version: !ruby/object:Gem::Version
-  version: 0.23.3
+  version: 0.23.8
 platform: ruby
 authors:
 - Javier Sánchez Yeste
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-28 00:00:00.000000000 Z
+date: 2021-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: citrus