Class: Musa::Variatio::Variatio

Inherits:
Object
  • Object
show all
Defined in:
lib/musa-dsl/generative/variatio.rb

Overview

Combinatorial variation generator.

Generates all combinations of field values using Cartesian product, constructs objects, applies attributes, and optionally finalizes.

Defined Under Namespace

Classes: B

Instance Method Summary collapse

Constructor Details

#initialize(instance_name) { ... } ⇒ void

Creates variation generator with field definitions.

Examples:

variatio = Variatio.new :obj do
  field :x, [1, 2, 3]
  field :y, [:a, :b]
  constructor { |x:, y:| { x: x, y: y } }
end

Parameters:

  • instance_name (Symbol) —

    name for object parameter in blocks

Yields:

  • DSL block defining fields, constructor, attributes, finalize

Yield Returns:

  • (void)

Raises:

  • (ArgumentError) —

    if instance_name not a symbol

  • (ArgumentError) —

    if no block given



168
169
170
171
172
173
174
175
176
177
178
179
 
# File 'lib/musa-dsl/generative/variatio.rb', line 168

def initialize(instance_name, &block)
  raise ArgumentError, 'instance_name should be a symbol' unless instance_name.is_a?(Symbol)
  raise ArgumentError, 'block is needed' unless block

  @instance_name = instance_name

  main_context = MainContext.new &block

  @constructor = main_context._constructor
  @fieldset = main_context._fieldset
  @finalize = main_context._finalize
end

Instance Method Details

#on(**values) ⇒ Array

Generates variations with runtime field value overrides.

Allows overriding field options at generation time, useful for limiting variation space or parameterizing generation.

Examples:

Override field values

variatio = Variatio.new :obj do
  field :x, 1..10
  field :y, [:a, :b, :c]
  constructor { |x:, y:| { x: x, y: y } }
end

# Default: 10 × 3 = 30 variations
variatio.run.size  # => 30

# Override :x to limit variations
variatio.on(x: 1..3).size  # => 9  (3 × 3)
variatio.on(x: [5], y: [:a]).size  # => 1  (1 × 1)

Parameters:

  • values (Hash{Symbol => Array, Range}) —

    field overrides Keys are field names, values are option arrays or ranges

Returns:

  • (Array) —

    all generated variation objects



204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
 
# File 'lib/musa-dsl/generative/variatio.rb', line 204

def on(**values)
  constructor_binder = Musa::Extension::SmartProcBinder::SmartProcBinder.new @constructor
  finalize_binder = Musa::Extension::SmartProcBinder::SmartProcBinder.new @finalize if @finalize

  run_fieldset = @fieldset.clone # TODO: verificar que esto no da problemas

  run_fieldset.components.each do |component|
    if values.key? component.name
      component.options = values[component.name].arrayfy.explode_ranges
    end
  end

  tree_A = generate_eval_tree_A run_fieldset
  tree_B = generate_eval_tree_B run_fieldset

  parameters_set = tree_A.calc_parameters

  combinations = []

  parameters_set.each do |parameters_with_depth|
    instance = @constructor.call **(constructor_binder._apply(nil, parameters_with_depth).last)

    tree_B.run parameters_with_depth, @instance_name => instance

    if @finalize
      finalize_parameters = finalize_binder._apply(nil, parameters_with_depth).last
      finalize_parameters[@instance_name] = instance

      @finalize.call **finalize_parameters
    end

    combinations << instance
  end

  combinations
end

#run ⇒ Array

Generates all variations with default field values.

Equivalent to calling #on with no overrides.

Examples:

variatio = Variatio.new :obj do
  field :x, [1, 2, 3]
  field :y, [:a, :b]
  constructor { |x:, y:| { x: x, y: y } }
end

variations = variatio.run
# => [
#   { x: 1, y: :a }, { x: 1, y: :b },
#   { x: 2, y: :a }, { x: 2, y: :b },
#   { x: 3, y: :a }, { x: 3, y: :b }
# ]

Returns:

  • (Array) —

    all generated variation objects



260
261
262
 
# File 'lib/musa-dsl/generative/variatio.rb', line 260

def run
  on
end