reflekt 1.0.3 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d09b97f103669d2806a5c6e32da41e978fecff763c558d5aa8fb0739bf8e984a
-  data.tar.gz: 5f40bbfaa6444d452a0f91c1371d0d9aa75a5cd7edd5da8e36ac81d7f0c7532d
+  metadata.gz: 8fca22a79b9c2f962c5bd4583de7c8f35a27e5a350503aac4888d8072a2e843c
+  data.tar.gz: bf44e0c83c0e1e281b1aab9ecc3b86728152941484995167803d81de28e53170
 SHA512:
-  metadata.gz: c7198d5f60ee546e1becc9e7e75141705b0f4a01214e70bba2ba597872b2ff7dbd0cd60deb877a18fde3b4c25ba48ce94bede291bd9ddc089c3d195710dd5728
-  data.tar.gz: 23b79441dfa54881f1a537d259f686b8528f950aa1caac960c43403d7f5f24301a903ba99cc84d7bf1e743f6f6e16001141cff40a8c70139bf55032f38193131
+  metadata.gz: 3e59ad6e1e3a7e293d904da162c40478ca34a8b6daf0abefd3a0e0e58e525a249cccfd3d36602b0550925efb048e4df4a500c33865e93ebb7a13d2cbb7fea83a
+  data.tar.gz: b5762a194aa4c94849c4e3540cb9e51e2ea1feb779f51a6f4b424aa4c25aec7410137fb0d5a4ca9c1891ee4b350b58e6a7f34b81d4c57fd0f279a31b509f5b1e

data/lib/{Accessor.rb → accessor.rb}

@@ -8,6 +8,7 @@
 #   - @@reflekt_skipped_methods on the instance's singleton class
 ################################################################################
 
+module Reflekt
 class Accessor
 
   attr_accessor :config
@@ -35,3 +36,4 @@ class Accessor
   end
 
 end
+end

data/lib/{Execution.rb → action.rb}

@@ -1,13 +1,14 @@
 ################################################################################
-# A shadow execution.
+# A shadow action.
 #
 # @hierachy
-#   1. Execution <- YOU ARE HERE
+#   1. Action <- YOU ARE HERE
 #   2. Reflection
 #   3. Meta
 ################################################################################
 
-class Execution
+module Reflekt
+class Action
 
   attr_accessor :unique_id
   attr_accessor :caller_object
@@ -19,17 +20,17 @@ class Execution
   attr_accessor :parent
   attr_accessor :child
   attr_accessor :control
-  attr_accessor :reflections
+  attr_accessor :experiments
   attr_accessor :is_reflecting
   attr_accessor :is_base
 
   ##
-  # Create Execution.
+  # Create Action.
   #
   # @param object [Object] The calling object.
   # @param method [Symbol] The calling method.
-  # @param reflect_amount [Integer] The number of reflections to create per execution.
-  # @param stack [ShadowStack] The shadow execution call stack.
+  # @param reflect_amount [Integer] The number of experiments to create per action.
+  # @param stack [ActionStack] The shadow action call stack.
   ##
   def initialize(caller_object, method, reflect_amount, stack)
 
@@ -51,7 +52,7 @@ class Execution
 
     # Reflections.
     @control = nil
-    @reflections = Array.new(reflect_amount)
+    @experiments = Array.new(reflect_amount)
 
     # State.
     if @stack.peek() == nil
@@ -64,12 +65,12 @@ class Execution
 
   end
 
-  def has_empty_reflections?
-    @reflections.include? nil
+  def has_empty_experiments?
+    @experiments.include? nil
   end
 
   ##
-  # Is the Execution currently reflecting methods?
+  # Is the Action currently reflecting methods?
   ##
   def is_reflecting?
     @is_reflecting
@@ -79,10 +80,11 @@ class Execution
     if is_reflecting?
       return false
     end
-    if has_empty_reflections?
+    if has_empty_experiments?
       return false
     end
     return true
   end
 
 end
+end

data/lib/action_stack.rb

@@ -0,0 +1,46 @@
+################################################################################
+# Track the actions in a shadow call stack.
+#
+# @pattern Stack
+################################################################################
+
+module Reflekt
+class ActionStack
+
+  def initialize()
+    @bottom = nil
+    @top = nil
+  end
+
+  def peek()
+    @top
+  end
+
+  def base()
+    @bottom
+  end
+
+  ##
+  # Place Action at the top of stack.
+  #
+  # @param action [Action] The action to place.
+  # @return [Action] The placed action.
+  ##
+  def push(action)
+
+    # Place first action at bottom of stack.
+    if @bottom.nil?
+      @bottom = action
+    # Connect subsequent actions to each other.
+    else
+      @top.parent = action
+      action.child = @top
+    end
+
+    # Place action at top of stack.
+    @top = action
+
+  end
+
+end
+end

data/lib/{Clone.rb → clone.rb}

@@ -7,17 +7,18 @@
 #   on object, not indirectly through clone which results in "undefined method".
 #
 # @hierachy
-#   1. Execution
+#   1. Action
 #   2. Reflection
 #   3. Clone <- YOU ARE HERE
 ################################################################################
 
+module Reflekt
 class Clone
 
-  def initialize(execution)
+  def initialize(action)
 
-    # Clone the execution's calling object.
-    @caller_object_clone = execution.caller_object.clone
+    # Clone the action's calling object.
+    @caller_object_clone = action.caller_object.clone
 
     # TODO: Clone any other instances that this clone references.
     # TODO: Replace clone's references to these new instances.
@@ -29,3 +30,4 @@ class Clone
   end
 
 end
+end

data/lib/{Config.rb → config.rb}

@@ -1,3 +1,4 @@
+module Reflekt
 class Config
 
   attr_accessor :enabled
@@ -31,7 +32,7 @@ class Config
     }
 
     # An absolute path to the directory that contains the output directory.
-    # Defaults to current execution path.
+    # Defaults to current action path.
     @output_path = nil
 
     # Name of output directory.
@@ -40,3 +41,4 @@ class Config
   end
 
 end
+end

data/lib/{Control.rb → control.rb}

@@ -2,13 +2,13 @@
 # A shapshot of real data.
 #
 # @note
-#   A control's @number property will always be zero.
+#   A control's @number will always be 0.
 #
 # @nomenclature
 #   args, inputs/output and meta represent different stages of a value.
 #
 # @hierachy
-#   1. Execution
+#   1. Action
 #   2. Control <- YOU ARE HERE
 #   3. Meta
 #
@@ -18,43 +18,46 @@
 #   - :error [Symbol] The control reflection produces a system error.
 ################################################################################
 
-require 'Reflection'
-require 'MetaBuilder'
+require_relative 'reflection'
+require_relative 'meta_builder'
 
+module Reflekt
 class Control < Reflection
 
   ##
   # Reflect on a method.
   #
-  # Creates a shadow execution.
+  # Create a shadow action.
   # @param *args [Dynamic] The method's arguments.
   ##
   def reflect(*args)
 
-    # Get aggregated rule sets.
+    # Get trained rule sets.
     input_rule_sets = @aggregator.get_input_rule_sets(@klass, @method)
     output_rule_set = @aggregator.get_output_rule_set(@klass, @method)
 
+    # Fail when no trained rule sets.
+    if input_rule_sets.nil?
+      @status = :fail
+    end
+
     # When arguments exist.
     unless args.size == 0
 
-      # When aggregated rule sets exist.
+      # Validate arguments against trained rule sets.
       unless input_rule_sets.nil?
-
-        # Validate arguments against aggregated rule sets.
         unless @aggregator.test_inputs(args, input_rule_sets)
           @status = :fail
         end
-
       end
 
       # Create metadata for each argument.
-      # TODO: Create metadata for other inputs such as properties on the instance.
+      # TODO: Create metadata for other inputs such as instance variables.
       @inputs = MetaBuilder.create_many(args)
 
     end
 
-    # Action method with new/old arguments.
+    # Action method with real arguments.
     begin
 
       # Run reflection.
@@ -79,3 +82,4 @@ class Control < Reflection
   end
 
 end
+end

data/lib/experiment.rb

@@ -0,0 +1,83 @@
+################################################################################
+# A snapshot of random data.
+#
+# @note
+#   A reflection's random values are generated from aggregated control rule sets.
+#
+# @nomenclature
+#   args, inputs/output and meta represent different stages of a value.
+#
+# @hierachy
+#   1. Action
+#   2. Experiment <- YOU ARE HERE
+#   3. Meta
+#
+# @status
+#   - :pass [Symbol] The reflection passes the rules.
+#   - :fail [Symbol] The reflection fails the rules or produces a system error.
+#   - :error [Symbol] The control reflection produces a system error.
+################################################################################
+
+require_relative 'reflection'
+require_relative 'meta_builder'
+
+module Reflekt
+class Experiment < Reflection
+
+  ##
+  # Reflect on a method.
+  #
+  # Create a shadow action.
+  # @param *args [Dynamic] The method's arguments.
+  ##
+  def reflect(*args)
+
+    # Get aggregated rule sets.
+    input_rule_sets = @aggregator.get_input_rule_sets(@klass, @method)
+    output_rule_set = @aggregator.get_output_rule_set(@klass, @method)
+
+    # Fail when no trained rule sets.
+    if input_rule_sets.nil?
+      @status = :fail
+    end
+
+    # When arguments exist.
+    unless args.size == 0
+
+      # Create random arguments from aggregated rule sets.
+      unless input_rule_sets.nil?
+        args = randomize(args, input_rule_sets)
+      end
+
+      # Create metadata for each argument.
+      # TODO: Create metadata for other inputs such as instance variables.
+      @inputs = MetaBuilder.create_many(args)
+
+    end
+
+    # Action method with random arguments.
+    begin
+
+      # Run reflection.
+      output = @clone.send(@method, *args)
+      @output = MetaBuilder.create(output)
+
+      # Validate output against aggregated control rule sets.
+      unless output_rule_set.nil?
+        unless @aggregator.test_output(output, output_rule_set)
+          @status = :fail
+        end
+      end
+
+    # When a system error occurs.
+    rescue StandardError => message
+
+      @status = :fail
+      @message = message
+
+    end
+
+  end
+
+end
+end

data/lib/{Meta.rb → meta.rb}

@@ -5,18 +5,19 @@
 # @see lib/meta for each meta.
 #
 # @hierachy
-#   1. Execution
+#   1. Action
 #   2. Reflection
 #   3. Meta <- YOU ARE HERE
 ################################################################################
 
+module Reflekt
 class Meta
 
   ##
   # Each meta defines its type.
   ##
   def initialize()
-    @type = nil
+    @type = :null
   end
 
   ##
@@ -28,12 +29,12 @@ class Meta
   end
 
   ##
-  # Each meta serializes metadata.
-  #
   # @return [Hash]
   ##
   def serialize()
-    {}
+    {
+      :type => @type
+    }
   end
 
   ##############################################################################
@@ -69,3 +70,4 @@ class Meta
   end
 
 end
+end

data/lib/meta/{ArrayMeta.rb → array_meta.rb}

@@ -1,5 +1,6 @@
-require 'Meta'
+require_relative '../meta'
 
+module Reflekt
 class ArrayMeta < Meta
 
   def initialize()
@@ -32,3 +33,4 @@ class ArrayMeta < Meta
   end
 
 end
+end

data/lib/meta/{BooleanMeta.rb → boolean_meta.rb}

@@ -1,5 +1,6 @@
-require 'Meta'
+require_relative '../meta'
 
+module Reflekt
 class BooleanMeta < Meta
 
   def initialize()
@@ -24,3 +25,4 @@ class BooleanMeta < Meta
   end
 
 end
+end

data/lib/meta/{FloatMeta.rb → float_meta.rb}

@@ -1,5 +1,6 @@
-require 'Meta'
+require_relative '../meta'
 
+module Reflekt
 class FloatMeta < Meta
 
   def initialize()
@@ -24,3 +25,4 @@ class FloatMeta < Meta
   end
 
 end
+end

data/lib/meta/{IntegerMeta.rb → integer_meta.rb}

@@ -1,5 +1,6 @@
-require 'Meta'
+require_relative '../meta'
 
+module Reflekt
 class IntegerMeta < Meta
 
   def initialize()
@@ -24,3 +25,4 @@ class IntegerMeta < Meta
   end
 
 end
+end