reflekt 1.0.9 → 1.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ed0b66e3e9110822e6d14ba1a77fc5627b40edea4223d4252fd30ea4853047c
-  data.tar.gz: 39990e22a2f9ddac9382a8b960b10ead0b81598db3bf86eac4a1c499182e065b
+  metadata.gz: 3e5af4cf8808efaeb9b41e29c925aee883139afaea6fef303f060a91566a101b
+  data.tar.gz: cb877b7821ed829907c52387b5fc04ff3c986f05646170dceb3307cc14a4d648
 SHA512:
-  metadata.gz: 48497c5c451bde6860039fb9570f77a4bd0a9fd4b889d497d9c06079a9e852f3f426e42f01c5480c6bf621f4ba90179e9f95022fcd5e223f3b1da6718936e871
-  data.tar.gz: 4e1f58483092d4f7f626878303060c0527ff0838ab244f4abc9e3f5b5772af19c95a5a5e86e1a2d6361027efa80882ead7dafee544698bf895555a7086a63d97
+  metadata.gz: 6200d9280ccdf2cd5cb1788d80e6795813e5dc7ca398ebca75e507aba2fc8e3bf116ec851f3d103c92eaa1e1a79fd0a6c3f14dc1f59cee74117a8a1f74f60e66
+  data.tar.gz: 9b28f16baeafa725c606c0ea458742f86d0b87cda0e95180658b66598a8a08a0efa46f706214d8e00e98eecfc766eadfafeeb47697cf297f62beef95e2ed452d

data/lib/accessor.rb

@@ -1,39 +1,45 @@
 ################################################################################
-# Access variables via one object to avoid polluting the caller class scope.
+# Access variables via one object to avoid polluting the caller's scope.
 #
 # @pattern Singleton
 #
-# @note Some variables are not accessed via Accessor:
+# @note Variables not accessed via Accessor:
 #   - @reflekt_counts on the instance
 #   - @@reflekt_skipped_methods on the instance's singleton class
 ################################################################################
 
 module Reflekt
-class Accessor
-
-  attr_accessor :config
-  attr_accessor :setup
-  attr_accessor :db
-  attr_accessor :stack
-  attr_accessor :aggregator
-  attr_accessor :renderer
-  attr_accessor :path
-  attr_accessor :output_path
-  attr_accessor :error
-
-  def initialize()
-
-    @config = nil
-    @setup = nil
-    @db = nil
-    @stack = nil
-    @aggregator = nil
-    @renderer = nil
-    @path = nil
-    @output_path = nil
-    @error = false
+  class Accessor
 
-  end
+    attr_accessor :initialized
+    attr_accessor :counts
+    attr_accessor :error
 
-end
+    attr_accessor :config
+    attr_accessor :db
+    attr_accessor :stack
+    attr_accessor :aggregator
+    attr_accessor :renderer
+
+    attr_accessor :package_path
+    attr_accessor :project_path
+    attr_accessor :output_path
+
+    def initialize()
+      @initialized = false
+      @counts = {}
+      @error = nil
+
+      @config = nil
+      @db = nil
+      @stack = nil
+      @aggregator = nil
+      @renderer = nil
+
+      @package_path = nil
+      @project_path = nil
+      @output_path = nil
+    end
+
+  end
 end

data/lib/action.rb

@@ -8,83 +8,120 @@
 ################################################################################
 
 module Reflekt
-class Action
-
-  attr_accessor :unique_id
-  attr_accessor :caller_object
-  attr_accessor :caller_id
-  attr_accessor :caller_class
-  attr_accessor :klass
-  attr_accessor :method
-  attr_accessor :base
-  attr_accessor :parent
-  attr_accessor :child
-  attr_accessor :control
-  attr_accessor :experiments
-  attr_accessor :is_reflecting
-  attr_accessor :is_base
-
-  ##
-  # Create Action.
-  #
-  # @param object [Object] The calling object.
-  # @param method [Symbol] The calling method.
-  # @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)
-
-    @time = Time.now.to_i
-    @unique_id = @time + rand(1..99999)
-    @base = nil
-    @parent = nil
-    @child = nil
-
-    # Dependency.
-    @stack = stack
-
-    # Caller.
-    @caller_object = caller_object
-    @caller_id = caller_object.object_id
-    @caller_class = caller_object.class
-    @klass = @caller_class.to_s.to_sym
-    @method = method
-
-    # Reflections.
-    @control = nil
-    @experiments = Array.new(reflect_amount)
-
-    # State.
-    if @stack.peek() == nil
-      @is_base = true
-    else
-      @is_base = false
-      @base = @stack.base()
+  class Action
+    include LitCLI
+
+    attr_accessor :unique_id
+    attr_accessor :caller_object
+    attr_accessor :caller_id
+    attr_accessor :caller_class
+    attr_accessor :klass
+    attr_accessor :method
+    attr_accessor :base
+    attr_accessor :parent
+    attr_accessor :child
+    attr_accessor :control
+    attr_accessor :experiments
+    attr_accessor :is_actioned
+    attr_accessor :is_reflecting
+    attr_accessor :is_base
+
+    ##
+    # Create Action.
+    #
+    # @param object [Object] The calling object.
+    # @param method [Symbol] The calling method.
+    # @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, config, db, stack, aggregator)
+      @time = Time.now.to_i
+      @unique_id = @time + rand(1..99999)
+      @base = nil
+      @child = nil
+      @parent = nil
+
+      # Dependencies.
+      @db = db
+      @stack = stack
+      @aggregator = aggregator
+
+      # Caller.
+      @caller_object = caller_object
+      @caller_class = caller_object.class
+      @caller_id = caller_object.object_id
+      @klass = @caller_class.to_s.to_sym
+      @method = method
+
+      # Reflections.
+      @control = nil
+      @experiments = Array.new(config.reflect_amount)
+
+      # State.
+      @is_reflecting = false
+      if @stack.peek() == nil
+        @is_base = true
+      else
+        @is_base = false
+        @base = @stack.base()
+      end
     end
-    @is_reflecting = false
 
-  end
+    def reflect(*args)
 
-  def has_empty_experiments?
-    @experiments.include? nil
-  end
+      🔥"^ Create control for #{@method}()", :info, :control, @klass
+      @control = Control.new(self, 0, @aggregator)
 
-  ##
-  # Is the Action currently reflecting methods?
-  ##
-  def is_reflecting?
-    @is_reflecting
-  end
+      @control.reflect(*args)
+      🔥"> Reflected control for #{@method}(): #{args}", @control.status, :result, @klass
+
+      # Stop reflecting when control fails to execute.
+      unless @control.status == :error
+
+        # Save control.
+        @db.get("controls").push(@control.serialize())
+        @db.get("reflections").push(@control.serialize())
+
+        # Multiple experiments per action.
+        @experiments.each_with_index do |value, index|
+
+          🔥"^ Create experiment ##{index + 1} for #{@method}()", :info, :experiment, @klass
+          experiment = Experiment.new(self, index + 1, @aggregator)
+          @experiments[index] = experiment
 
-  def has_finished_reflecting?
-    if is_reflecting?
-      return false
+          # Reflect experiment.
+          experiment.reflect(*args)
+          Reflekt.increase_count(@caller_object, @method)
+          🔥"> Reflected experiment ##{index + 1} for #{@method}()", experiment.status, :result, @klass
+
+          # Save experiment.
+          @db.get("reflections").push(experiment.serialize())
+        end
+
+        # Save results.
+        @db.write()
+      end
     end
-    if has_empty_experiments?
-      return false
+
+    def is_actioned?
+      @is_actioned
     end
-    return true
-  end
 
-end
+    # Is the action currently reflecting methods?
+    def is_reflecting?
+      @is_reflecting
+    end
+
+    def has_empty_experiments?
+      @experiments.include? nil
+    end
+
+    def has_finished_loop?
+      return false if is_actioned? == false
+      return false if is_reflecting?
+      return false if has_empty_experiments?
+
+      true
+    end
+  end
 end

data/lib/action_stack.rb

@@ -5,42 +5,40 @@
 ################################################################################
 
 module Reflekt
-class ActionStack
+  class ActionStack
 
-  def initialize()
-    @bottom = nil
-    @top = nil
-  end
-
-  def peek()
-    @top
-  end
-
-  def base()
-    @bottom
-  end
+    def initialize()
+      @bottom = nil
+      @top = nil
+    end
 
-  ##
-  # Place Action at the top of stack.
-  #
-  # @param action [Action] The action to place.
-  # @return [Action] The placed action.
-  ##
-  def push(action)
+    def peek()
+      @top
+    end
 
-    # 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
+    def base()
+      @bottom
     end
 
-    # Place action at top of stack.
-    @top = action
+    ##
+    # Place Action at the top of stack.
+    #
+    # @param action [Action] The action to place.
+    # @return [Action] The placed action.
+    ##
+    def push(action)
+      # First time? Place 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
 end

data/lib/clone.rb

@@ -13,21 +13,19 @@
 ################################################################################
 
 module Reflekt
-class Clone
+  class Clone
 
-  def initialize(action)
+    def initialize(action)
+      # Clone the action's calling object.
+      @caller_object_clone = action.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.
+    end
 
-    # TODO: Clone any other instances that this clone references.
-    # TODO: Replace clone's references to these new instances.
+    def action(method, *new_args)
+      @caller_object_clone.send(method, *new_args)
+    end
 
   end
-
-  def action(method, *new_args)
-    @caller_object_clone.send(method, *new_args)
-  end
-
-end
 end

data/lib/config.rb

@@ -1,45 +1,48 @@
 module Reflekt
-class Config
-
-  attr_accessor :enabled
-  attr_accessor :reflect_amount
-  attr_accessor :reflect_limit
-  attr_accessor :meta_map
-  attr_accessor :output_path
-  attr_accessor :output_directory
-
-  def initialize()
-
-    # Reflekt is enabled by default and should be disabled on production.
-    @enabled = true
-
-    # The amount of reflections to create per method call.
-    # A control reflection is created in addition to this.
-    @reflect_amount = 5
-
-    # The maximum amount of reflections that can be created per instance/method.
-    # A method called thousands of times doesn't need that many reflections.
-    @reflect_limit = 10
-
-    # The rules that apply to meta types.
-    @meta_map = {
-      :array  => [ArrayRule],
-      :bool   => [BooleanRule],
-      :int    => [IntegerRule],
-      :float  => [FloatRule],
-      :null   => [NullRule],
-      :object => [ObjectRule],
-      :string => [StringRule]
-    }
-
-    # An absolute path to the directory that contains the output directory.
-    # Defaults to current execution path.
-    @output_path = nil
-
-    # Name of output directory.
-    @output_directory = "reflections"
+  class Config
 
-  end
+    attr_accessor :enabled
+    attr_accessor :reflect_amount
+    attr_accessor :reflect_limit
+    attr_accessor :meta_map
+    attr_accessor :project_path
+    attr_accessor :output_directory
 
-end
+    def initialize()
+
+      # Reflekt is enabled by default and should be disabled on production.
+      @enabled = true
+
+      # Reflekt is untracked in git by default.
+      @git_ignore = true
+
+      # The amount of reflections to create per method call.
+      # A control reflection is created in addition to this.
+      @reflect_amount = 5
+
+      # The maximum amount of reflections that can be created per instance per method.
+      # A method called thousands of times doesn't need that many reflections.
+      @reflect_limit = 10
+
+      # The rules that apply to meta types.
+      @meta_map = {
+        :array  => [ArrayRule],
+        :bool   => [BooleanRule],
+        :int    => [IntegerRule],
+        :float  => [FloatRule],
+        :null   => [NullRule],
+        :object => [ObjectRule],
+        :string => [StringRule]
+      }
+
+      # An absolute path to the project root directory.
+      # Defaults to current execution path.
+      @project_path = Dir.pwd
+
+      # Name of output directory.
+      @output_directory = "reflections"
+
+    end
+
+  end
 end