reflekt 0.9.1 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3589292c5c5cba2f3d7c7d5e1d7e02ee1052afe7339929cfa058b787b89c3158
-  data.tar.gz: d33c6774d53d4b7a0978fcfc48fa00e22f3684ccd51e5d42676f01831fb84291
+  metadata.gz: 21ac72b1a4f8bf9bd182f1d1ae5464d11aa87ab0f38c6fa418c9a3e73ff33a5d
+  data.tar.gz: bfd3a381c930d910e3b293e835877712734eecc2a51c7949e7f4747b67377058
 SHA512:
-  metadata.gz: 2e3120f544d87057b4783a4e6e76a9689844f17ed1ad602c8b2c5e5ee241285ef83e276b56fbdb33da0d167c68077eca6f851e859a28392718a26ed129ab18e7
-  data.tar.gz: 47d323198d8d27585ef5fb0d493eca120d0cd2ff532a6578ef3b7490ccbc9e4fc38757bab8fb2ad4ab6c05c0a9fd721b27a5925a90c95503c0de5d4fb7483e12
+  metadata.gz: e9b62612aa60d91bf591eae59c9797c97e9b54fdafd58d2785ed4fdfa8c7bc256cd288e13dd9e83d4fd8d11fbdbe043ce0660f6ba82878f8fd5eabb224d691b0
+  data.tar.gz: 9a38959ce057bdf3f4e7e2091f0aa6666be940e356b5865952a7e9e7749958d77f8beb68d2fd8f9a252f047bb45bccc756b3f9af793c85e3031a4f0cab541c74

data/lib/Control.rb

@@ -2,6 +2,32 @@ require 'Reflection'
 
 class Control < Reflection
 
-  # TODO.
+  ##
+  # Reflect on a method.
+  #
+  # Creates a shadow execution stack.
+  #
+  # @param method - The name of the method.
+  # @param *args - The method arguments.
+  #
+  # @return - A reflection hash.
+  ##
+  def reflect(*args)
+
+    @input = *args
+
+    # Action method with new arguments.
+    begin
+      @output = @clone.send(@method, *@input)
+    # When fail.
+    rescue StandardError => message
+      @status = FAIL
+      @message = message
+    # When pass.
+    else
+      @status = PASS
+    end
+
+  end
 
 end

data/lib/Reflection.rb

@@ -15,11 +15,11 @@ class Reflection
 
   attr_accessor :clone
 
-  def initialize(execution, method, is_control)
+  def initialize(execution, method, ruler)
 
     @execution = execution
     @method = method
-    @is_control = is_control
+    @ruler = ruler
 
     # Clone the execution's object.
     @clone = execution.object.clone
@@ -28,7 +28,7 @@ class Reflection
     # Result.
     @status = nil
     @time = Time.now.to_i
-    @input = []
+    @inputs = []
     @output = nil
 
   end
@@ -45,30 +45,43 @@ class Reflection
   ##
   def reflect(*args)
 
-    # Reflect on real world arguments.
-    if @is_control
-      @input = *args
-    # Reflect on deviated arguments.
-    else
-      args.each do |arg|
-        case arg
-        when Integer
-          @input << rand(9999)
-        else
-          @input << arg
-        end
+    # Create deviated arguments.
+    args.each do |arg|
+      case arg
+      when Integer
+        @inputs << rand(999)
+      else
+        @inputs << arg
       end
     end
 
     # Action method with new arguments.
     begin
-      @output = @clone.send(@method, *@input)
+      # Validate input with controls.
+      unless @ruler.nil?
+        if @ruler.validate_inputs(@execution.caller_class, @method, @inputs)
+          @status = PASS
+        else
+          @status = FAIL
+        end
+      end
+      # Run reflection.
+      @output = @clone.send(@method, *@inputs)
     # When fail.
     rescue StandardError => message
-      @status = MESSAGE
+      @status = FAIL
       @message = message
     # When pass.
     else
+      # Validate output with controls.
+      unless @ruler.nil?
+        if @ruler.validate_output(@execution.caller_class, @method, @output)
+          @status = PASS
+        else
+          @status = FAIL
+        end
+        return
+      end
       @status = PASS
     end
 
@@ -79,7 +92,7 @@ class Reflection
     reflection = {
       TIME => @time,
       STATUS => @status,
-      INPUT => normalize_input(@input),
+      INPUT => normalize_input(@inputs),
       OUTPUT => normalize_output(@output),
       MESSAGE => @message
     }

data/lib/Rule.rb

@@ -0,0 +1,38 @@
+require 'set'
+
+class Rule
+
+  attr_accessor :type
+  attr_accessor :min
+  attr_accessor :max
+  attr_accessor :length
+  attr_accessor :types
+  attr_accessor :values
+
+  def initialize()
+
+    @types = Set.new
+    @values = Set.new
+    @min = nil
+    @max = nil
+    @length = nil
+
+  end
+
+  ##
+  # A parameter can accept multiple input types.
+  # Duplicates will not be added to the set.
+  ##
+  def add_type(type)
+    @types.add(type)
+  end
+
+  def add_value(value)
+    @values.add(value)
+  end
+
+  def is_number?
+    @types.include? Integer
+  end
+
+end

data/lib/Ruler.rb

@@ -0,0 +1,112 @@
+require 'Rule'
+
+class Ruler
+
+  INPUT  = "i"
+  OUTPUT = "o"
+  TYPE   = "T"
+  VALUE  = "V"
+
+  def initialize()
+
+    @controls = nil
+
+    # Rules.
+    @inputs = []
+    @output = nil
+
+  end
+
+  def load(controls)
+
+    @controls = controls
+    @controls.each_with_index do |control, index|
+
+      # Multiple inputs.
+      control[INPUT].each_with_index do |input, index|
+        unless input.nil?
+
+          # Create rule.
+          if @inputs[index].nil?
+            rule = Rule.new()
+            @inputs[index] = rule
+          else
+            rule = @inputs[index]
+          end
+
+          # Add rules to rule.
+          unless input[TYPE].nil? || input[TYPE].empty?
+            rule.add_type(input[TYPE].class)
+          end
+          unless input[VALUE].nil? || input[VALUE].empty?
+            rule.add_value(input[VALUE])
+          end
+
+          index = index + 1
+        end
+      end
+
+      # Singular output.
+      output = control[OUTPUT]
+      unless control[OUTPUT].nil?
+
+        # Create rule.
+        if @output.nil?
+          rule = Rule.new()
+          @output = rule
+        else
+          rule = @output
+        end
+
+        ## Add rules to rule.
+        unless output[TYPE].nil? || output[TYPE].empty?
+          rule.add_type(output[TYPE])
+        end
+        unless output[VALUE].nil? || output[VALUE].empty?
+          rule.add_value(output[VALUE])
+        end
+
+      end
+
+    end
+
+  end
+
+  def train()
+
+    @inputs.each do |rule|
+      # Get min/max.
+      if rule.is_number?
+        numbers = rule.values.select {|num| num.class == Integer }
+        numbers.sort!
+        rule.min = numbers.first
+        rule.max = numbers.last
+      end
+
+    end
+
+  end
+
+  def validate_inputs(klass, method, inputs)
+    result = true
+    inputs.each_with_index do |value, index|
+      rule = @inputs[index]
+      if rule.is_number? && value.class == Integer
+        result = false if value < rule.min
+        result = false if value > rule.max
+      end
+    end
+    return result
+  end
+
+  def validate_output(klass, method, outputs)
+    result = true
+    rule = @output
+    if rule.is_number? && value.class == Integer
+      result = false if value < rule.min
+      result = false if value > rule.max
+    end
+    return result
+  end
+
+end

data/lib/reflekt.rb

@@ -4,6 +4,7 @@ require 'rowdb'
 require 'Control'
 require 'Execution'
 require 'Reflection'
+require 'Ruler'
 require 'ShadowStack'
 
 ################################################################################
@@ -60,6 +61,14 @@ module Reflekt
 
           end
 
+          # Get ruler.
+          # The method's ruler will not exist the first time the db generated.
+          if @@reflekt_rules.key? execution.caller_class.to_s.to_sym
+            ruler = @@reflekt_rules[execution.caller_class.to_s.to_sym][method.to_s]
+          else
+            ruler = nil
+          end
+
           # Reflect.
           # The first method call in the Execution creates a Reflection.
           # Subsequent method calls are shadow executions on cloned objects.
@@ -70,7 +79,7 @@ module Reflekt
             method_name = method.to_s
 
             # Create control.
-            control = Control.new(execution, method, true)
+            control = Control.new(execution, method, ruler)
             execution.control = control
 
             # Execute control.
@@ -83,11 +92,12 @@ module Reflekt
             execution.reflections.each_with_index do |value, index|
 
               # Create reflection.
-              reflection = Reflection.new(execution, method, false)
+              reflection = Reflection.new(execution, method, ruler)
               execution.reflections[index] = reflection
 
               # Execute reflection.
               reflection.reflect(*args)
+              @reflection_counts[method] = @reflection_counts[method] + 1
 
               # Save reflection.
               @@reflekt_db.get("#{class_name}.#{method_name}.reflections").push(reflection.result())
@@ -105,8 +115,6 @@ module Reflekt
 
         end
 
-        @reflection_counts[method] = @reflection_counts[method] + 1
-
         # Continue execution / shadow execution.
         super *args
 
@@ -167,9 +175,6 @@ module Reflekt
     # Set configuration.
     @@reflekt_path = File.dirname(File.realpath(__FILE__))
 
-    # Create reflection tree.
-    @@reflekt_stack = ShadowStack.new()
-
     # Build reflections directory.
     if $ENV[:reflekt][:output_path]
       @@reflekt_output_path = File.join($ENV[:reflekt][:output_path], 'reflections')
@@ -184,7 +189,30 @@ module Reflekt
 
     # Create database.
     @@reflekt_db = Rowdb.new(@@reflekt_output_path + '/db.json')
-    @@reflekt_db.defaults({ :reflekt => { :api_version => 1 }}).write()
+    @@reflekt_db.defaults({ :reflekt => { :api_version => 1 }})
+
+    # Create shadow execution stack.
+    @@reflekt_stack = ShadowStack.new()
+
+    # Define rules.
+    # TODO: Fix Rowdb.get(path) not returning data at path after Rowdb.push()?
+    @@reflekt_rules = {}
+    db = @@reflekt_db.value()
+    db.each do |class_name, class_values|
+      @@reflekt_rules[class_name] = {}
+      class_values.each do |method_name, method_values|
+        next if method_values.nil?
+        next unless method_values.class == Hash
+        if method_values.key? "controls"
+
+          ruler = Ruler.new()
+          ruler.load(method_values['controls'])
+          ruler.train()
+
+          @@reflekt_rules[class_name][method_name] = ruler
+        end
+      end
+    end
 
     return true
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: reflekt
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
 platform: ruby
 authors:
 - Maedi Prichard
@@ -33,6 +33,8 @@ files:
 - lib/Control.rb
 - lib/Execution.rb
 - lib/Reflection.rb
+- lib/Rule.rb
+- lib/Ruler.rb
 - lib/ShadowStack.rb
 - lib/reflekt.rb
 - lib/web/script.js