evt-mimic 1.2.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 531e81d3a7bf58ad75e07c0d24f12fe092dfea068455a99b03bdded840ae8cd9
+  data.tar.gz: e96368d98bec7c7153693dd1a0d52373bf57750ba18aec12d7a6ff87187f9cfc
+SHA512:
+  metadata.gz: 6b4055c9ce7f3c6caad3779ba0775f5b7704d97c410b0cd6230624122fbe8f84d23c1dd2154b675a43487c7f8f2659db464a1a7f35df1c8585519aa69741ef32
+  data.tar.gz: edeb321468a5bd20fc6d6f15aa8893136ac910ae016da04463b10d5d60ec52141b8d0835d551262f21fecdfe7de5a59a92dbb760f288991103d881c9bf0d993b

data/lib/mimic.rb

@@ -0,0 +1,13 @@
+require 'securerandom'
+
+require 'invocation'
+
+require 'mimic/preserved_methods'
+require 'mimic/subject_methods'
+require 'mimic/class'
+require 'mimic/build'
+require 'mimic/void'
+require 'mimic/remove_methods'
+require 'mimic/define_methods'
+require 'mimic/recorder'
+require 'mimic/mimic'

data/lib/mimic/build.rb

@@ -0,0 +1,25 @@
+module Mimic
+  module Build
+    def self.call(subject_class, record: nil, &blk)
+      record ||= false
+
+      cls = Class.build(subject_class, &blk)
+
+      subject_methods = Mimic.subject_methods(cls)
+
+      RemoveMethods.(cls, subject_methods)
+
+## TODO goes in Class.build
+## It's about the class def
+      if record
+        cls.class_exec do
+          include Recorder
+        end
+      end
+
+      DefineMethods.(cls, subject_methods, record: record)
+
+      cls
+    end
+  end
+end

data/lib/mimic/class.rb

@@ -0,0 +1,32 @@
+module Mimic
+  module Class
+    def self.build(subject_class, &blk)
+      define_class(subject_class, &blk)
+    end
+
+    def self.define_class(subject_class, &blk)
+      mimic_class = ::Class.new(subject_class, &blk)
+      set_constant(mimic_class, subject_class)
+      mimic_class
+    end
+
+    def self.set_constant(mimic_class, subject_class)
+      class_id = mimic_class.object_id
+      class_name = class_name(subject_class, class_id)
+
+      unless self.const_defined?(class_name, false)
+        self.const_set(class_name, mimic_class)
+      end
+
+      class_name
+    end
+
+    def self.class_name(cls, class_id)
+      if cls.name.nil?
+        return "C#{class_id}"
+      else
+        return "#{cls.name.gsub('::', '_')}_#{class_id}"
+      end
+    end
+  end
+end

data/lib/mimic/controls.rb

@@ -0,0 +1,11 @@
+require 'mimic/controls/subject'
+require 'mimic/controls/subject/no_parameters'
+require 'mimic/controls/subject/positional_parameters'
+require 'mimic/controls/subject/named_parameters'
+require 'mimic/controls/subject/block_parameter'
+require 'mimic/controls/subject/multiple_assignment_parameter'
+require 'mimic/controls/subject/multiple_assignment_named_parameter'
+require 'mimic/controls/subject/mixed_parameters'
+require 'mimic/controls/invocation'
+require 'mimic/controls/recorder'
+require 'mimic/controls/mimic'

data/lib/mimic/controls/invocation.rb

@@ -0,0 +1,17 @@
+module Mimic
+  module Controls
+    module Invocation
+      def self.example
+        method_name = :some_method
+
+        parameters = {}
+        parameters[:some_parameter] = 1
+        parameters[:some_other_parameter] = 11
+
+        invocation = ::Invocation.new(method_name, parameters)
+
+        invocation
+      end
+    end
+  end
+end

data/lib/mimic/controls/mimic.rb

@@ -0,0 +1,9 @@
+module Mimic
+  module Controls
+    module Mimic
+      def self.example
+        ::Mimic.(Subject::Class.example)
+      end
+    end
+  end
+end

data/lib/mimic/controls/recorder.rb

@@ -0,0 +1,13 @@
+module Mimic
+  module Controls
+    module Recorder
+      def self.example
+        Example.new
+      end
+
+      class Example
+        include Mimic::Recorder
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject.rb

@@ -0,0 +1,32 @@
+module Mimic
+  module Controls
+    module Subject
+      def self.example
+        Example
+      end
+
+      def self.implemented_methods
+        Example.instance_methods(false)
+      end
+
+      class Example
+        def a_method
+        end
+
+        def another_method
+        end
+      end
+
+      module Anonymous
+        def self.example
+          ::Class.new(Example)
+        end
+      end
+
+      class MethodMissing
+        def method_missing(*)
+        end
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject/block_parameter.rb

@@ -0,0 +1,12 @@
+module Mimic
+  module Controls
+    module Subject
+      module BlockParameter
+        class Example
+          def some_method(&blk)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject/mixed_parameters.rb

@@ -0,0 +1,12 @@
+module Mimic
+  module Controls
+    module Subject
+      module MixedParameters
+        class Example
+          def some_method(some_parameter, *parameters, some_other_parameter:, **named_parameters, &blk)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject/multiple_assignment_named_parameter.rb

@@ -0,0 +1,12 @@
+module Mimic
+  module Controls
+    module Subject
+      module MultipleAssignmentNamedParameter
+        class Example
+          def some_method(**parameters)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject/multiple_assignment_parameter.rb

@@ -0,0 +1,12 @@
+module Mimic
+  module Controls
+    module Subject
+      module MultipleAssignmentParameter
+        class Example
+          def some_method(*parameters)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject/named_parameters.rb

@@ -0,0 +1,12 @@
+module Mimic
+  module Controls
+    module Subject
+      module NamedParameters
+        class Example
+          def some_method(some_parameter:, some_other_parameter:)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject/no_parameters.rb

@@ -0,0 +1,12 @@
+module Mimic
+  module Controls
+    module Subject
+      module NoParameters
+        class Example
+          def some_method
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mimic/controls/subject/positional_parameters.rb

@@ -0,0 +1,12 @@
+module Mimic
+  module Controls
+    module Subject
+      module PositionalParameters
+        class Example
+          def some_method(some_parameter, some_other_parameter)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mimic/define_methods.rb

@@ -0,0 +1,79 @@
+module Mimic
+  module DefineMethods
+    Error = ::Class.new(RuntimeError)
+
+    def self.call(cls, subject_methods=nil, record: nil)
+      subject_methods ||= Mimic.subject_methods(cls)
+
+      subject_methods.each do |mthd|
+        define_method(cls, mthd, record)
+      end
+
+      nil
+    end
+
+    def self.define_method(cls, mthd, record)
+      method_definition = method_definition(mthd, record)
+      cls.class_eval(method_definition)
+    end
+
+    def self.method_definition(mthd, record)
+      "
+        #{signature(mthd)}
+          #{body(record)}
+        end
+      "
+    end
+
+    def self.signature(mthd)
+      parameter_list = parameter_list(mthd.parameters)
+
+      "def #{mthd.name}(#{parameter_list})"
+    end
+
+    def self.parameter_list(parameters)
+      parameter_list = ''
+      parameters.each do |parameter|
+        parameter_signature = parameter_signature(parameter)
+        parameter_list << "#{parameter_signature}, "
+      end
+
+      parameter_list[0...-2]
+    end
+
+    def self.parameter_signature(parameter)
+      type = parameter[0]
+      name = parameter.fetch(1) { :args }
+
+      case type
+      when :req
+        return "#{name}"
+      when :keyreq
+        return "#{name}:"
+      when :rest
+        return "*#{name}"
+      when :keyrest
+        return "**#{name}"
+      when :block
+        return "&#{name}"
+      else
+        raise Error, "Unknown parameter type (Name: #{name.inspect}, Type: #{type.inspect})"
+      end
+    end
+
+    def self.body(record)
+      body = ''
+      if record
+        body << <<~RECORD
+          invocation = Invocation.build(binding)
+          __record(invocation)
+        RECORD
+      end
+
+      body << "Void.new"
+
+      body
+    end
+  end
+end
+

data/lib/mimic/mimic.rb

@@ -0,0 +1,6 @@
+module Mimic
+  def self.call(subject_class, record: nil, &blk)
+    cls = Build.(subject_class, record: record, &blk)
+    cls.new
+  end
+end

data/lib/mimic/preserved_methods.rb

@@ -0,0 +1,5 @@
+module Mimic
+  def self.preserved_methods
+    @preserved ||= (Object.instance_methods << :method_missing).sort
+  end
+end

data/lib/mimic/proofs.rb

@@ -0,0 +1 @@
+require 'mimic/proofs/method/parameters'

data/lib/mimic/proofs/method/parameters.rb

@@ -0,0 +1,28 @@
+module Mimic
+  module Proofs
+    module Method
+      module Parameters
+        def self.equal?(compare, control, method_name)
+          control_method = control.method(method_name)
+
+          control_parameters = control_method.parameters
+
+          compare_method = compare.method(method_name)
+          compare_parameters = compare_method.parameters
+
+          if ENV['VERBOSE'] == 'on'
+            puts "Control: #{control.class}"
+            pp control_parameters
+
+            puts
+
+            puts "Compare: #{compare.class}"
+            pp compare_parameters
+          end
+
+          compare_parameters == control_parameters
+        end
+      end
+    end
+  end
+end

data/lib/mimic/recorder.rb

@@ -0,0 +1,53 @@
+module Mimic
+  module Recorder
+    attr_writer :__records
+    def __records
+      @__records ||= []
+    end
+    alias :records :__records
+    alias :records= :__records=
+
+    def __record(invocation)
+      __records << invocation
+    end
+    alias :record :__record
+
+    def __invocation(method_name, &blk)
+      invocations = __invocations(method_name, &blk)
+
+      if invocations.empty?
+        return nil
+      end
+
+      return invocations.first
+    end
+    alias :invocation :__invocation
+
+    def __invocations(method_name=nil, &blk)
+      if method_name.nil? && blk.nil?
+        return __records
+      end
+
+      invocations = __records.select { |invocation| invocation.method_name == method_name }
+
+      if blk.nil?
+        return invocations
+      end
+
+      if invocations.empty?
+        return []
+      end
+
+      invocations.select do |invocation|
+        invocation.parameters.find { |k, v| blk.(k, v)}
+      end
+    end
+    alias :invocations :__invocations
+
+    def __invoked?(method_name, &blk)
+      invocation = __invocation(method_name, &blk)
+      !invocation.nil?
+    end
+    alias :invoked? :__invoked?
+  end
+end

data/lib/mimic/remove_methods.rb

@@ -0,0 +1,13 @@
+module Mimic
+  module RemoveMethods
+    def self.call(cls, subject_methods=nil)
+      subject_methods ||= Mimic.subject_methods(cls)
+
+      subject_methods.each do |m|
+        cls.undef_method(m.name)
+      end
+
+      nil
+    end
+  end
+end

data/lib/mimic/subject_methods.rb

@@ -0,0 +1,10 @@
+module Mimic
+  def self.subject_methods(cls)
+    instance_method_names = cls.instance_methods.sort
+    instance_method_names -= Mimic.preserved_methods
+
+    instance_methods = instance_method_names.map do |method_name|
+      cls.instance_method(method_name)
+    end
+  end
+end

data/lib/mimic/void.rb

@@ -0,0 +1,9 @@
+module Mimic
+  class Void
+    class Error < RuntimeError; end
+
+    def method_missing(method_name, *args)
+      raise Error, "Cannot invoke `#{method_name}' on a void"
+    end
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: evt-mimic
+version: !ruby/object:Gem::Version
+  version: 1.2.0.1
+platform: ruby
+authors:
+- The Eventide Project
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-08-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: evt-invocation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: test_bench
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: " "
+email: opensource@eventide-project.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mimic.rb
+- lib/mimic/build.rb
+- lib/mimic/class.rb
+- lib/mimic/controls.rb
+- lib/mimic/controls/invocation.rb
+- lib/mimic/controls/mimic.rb
+- lib/mimic/controls/recorder.rb
+- lib/mimic/controls/subject.rb
+- lib/mimic/controls/subject/block_parameter.rb
+- lib/mimic/controls/subject/mixed_parameters.rb
+- lib/mimic/controls/subject/multiple_assignment_named_parameter.rb
+- lib/mimic/controls/subject/multiple_assignment_parameter.rb
+- lib/mimic/controls/subject/named_parameters.rb
+- lib/mimic/controls/subject/no_parameters.rb
+- lib/mimic/controls/subject/positional_parameters.rb
+- lib/mimic/define_methods.rb
+- lib/mimic/mimic.rb
+- lib/mimic/preserved_methods.rb
+- lib/mimic/proofs.rb
+- lib/mimic/proofs/method/parameters.rb
+- lib/mimic/recorder.rb
+- lib/mimic/remove_methods.rb
+- lib/mimic/subject_methods.rb
+- lib/mimic/void.rb
+homepage: https://github.com/eventide-project/mimic
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Copy a class's instance interface to an anonymous, new object that acts as
+  a substitutable mimic for the class
+test_files: []