method_introspection 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a281ed170dd1e993975cc0cdd4ea889caa72a286
+  data.tar.gz: e3916ce0e0c21b1f2ef4fe2006e5bf5f5676b41c
+SHA512:
+  metadata.gz: a38dca730b231aa479f30b2ffb65ed0ef62236cef7786ed95d5f0f616da9360a765f86509cd2a59e952d5b11387baf037059805a90584a653909b348767241d6
+  data.tar.gz: 13857fafe0c960a482abb0612406fb0782df8572a9c3c7f34c9a1fc665e77a7e95b841f3f7f8d8214c6714997815d94f9156255a14ee04b522c17b04ec5f8abc

data/README.md

@@ -0,0 +1,48 @@
+method_introspection
+====================
+
+This is a simplified variant of showing comments and source code.
+
+It is based on John Mair's (banisterfiend) gem called _method_source_.
+
+The gem is fine - however had I found that I only required MRI support
+for my own gems since that is what I am using.
+
+Thus, a lot of the code was not useful for me since it would be based
+on jruby or rubinius or also ruby 1.8. Hence why I stripped down and
+put it into a separate gem.
+
+Credit where credit is due and in this case it was banisterfiend's
+initial work.
+
+The license is thus the MIT license. Please refer to his gem called
+method_source for a description of that gem.
+
+_Introspect ruby methods at runtime_
+
+Method comments can be obtained via the `comment` method.
+
+This library is written in pure Ruby.
+
+Examples: display method source
+------------------------------
+
+    Set.instance_method(:merge).source.display
+    # =>
+    def merge(enum)
+      if enum.instance_of?(self.class)
+        @hash.update(enum.instance_variable_get(:@hash))
+      else
+        do_with_enum(enum) { |o| add(o) }
+      end
+
+      self
+    end
+
+Example: display method comments
+--------------------------------
+
+    Set.instance_method(:merge).comment.display
+    # =>
+    # Merges the elements of the given enumerable object to the set and
+    # returns self.

data/lib/method_introspection/code_helpers.rb

@@ -0,0 +1,177 @@
+module MethodIntrospection
+
+module CodeHelpers
+
+  # ========================================================================= #
+  # === expression_at
+  #
+  # Retrieve the first expression starting on the given line of the
+  # given file.
+  #
+  # This is useful to get module or method source code.
+  #
+  # @param [Array<String>, File, String] file  The file to parse, either as a File or as
+  # @param [Fixnum]  line_number  The line number at which to look.
+  #                             NOTE: The first line in a file is
+  #                           line 1!
+  #
+  # @param [Hash] options The optional configuration parameters.
+  # @option options [Boolean] :strict  If set to true, then only completely
+  #   valid expressions are returned. Otherwise heuristics are used to extract
+  #   expressions that may have been valid inside an eval.
+  # @option options [Fixnum] :consume  A number of lines to automatically
+  #   consume (add to the expression buffer) without checking for validity.
+  # @return [String]  The first complete expression
+  # @raise [SyntaxError]  If the first complete expression can't be identified
+  # ========================================================================= #
+  def expression_at(
+      file,
+      line_number,
+      options = {}
+    )
+    options = {
+      :strict  => false,
+      :consume => 0
+    }.merge!(options)
+
+    if file.is_a? Array
+      lines = file
+    else
+      lines = file.each_line.to_a
+    end
+
+    relevant_lines = lines[(line_number - 1)..-1] || []
+
+    extract_first_expression(relevant_lines, options[:consume])
+    rescue SyntaxError => e
+    raise if options[:strict]
+
+    begin
+      extract_first_expression(relevant_lines) { |code|
+        code.gsub(/\#\{.*?\}/, "temp")
+      }
+    rescue SyntaxError
+      raise e
+    end
+  end
+
+  # ========================================================================= #
+  # === comment_describing
+  #
+  # Retrieve the comment describing the expression on the given line of
+  # the given file.
+  #
+  # This is useful to get module or method documentation.
+  #
+  # @param [Array<String>, File, String] file  The file to parse, either as a File or as
+  #                                            a String or an Array of lines.
+  # @param [Fixnum]  line_number  The line number at which to look.
+  #                             NOTE: The first line in a file is line 1!
+  # @return [String]  The comment
+  # ========================================================================= #
+  def comment_describing(file, line_number)
+    lines = file.is_a?(Array) ? file : file.each_line.to_a
+    extract_last_comment(lines[0..(line_number - 2)])
+  end
+
+  # ========================================================================= #
+  # === complete_expression?
+  #
+  # Determine if a string of code is a complete Ruby expression.
+  #
+  # @param [String] code The code to validate.
+  # @return [Boolean] Whether or not the code is a complete Ruby expression.
+  # @raise [SyntaxError] Any SyntaxError that does not represent incompleteness.
+  # @example
+  #   complete_expression?("class Hello") #=> false
+  #   complete_expression?("class Hello; end") #=> true
+  #   complete_expression?("class 123") #=> SyntaxError: unexpected tINTEGER
+  # ========================================================================= #
+  def complete_expression?(i)
+    old_verbose = $VERBOSE
+    $VERBOSE = nil
+    catch(:valid) {
+      eval("BEGIN{throw :valid}\n#{i}")
+    }
+    # Assert that a line which ends with a , or \ is incomplete.
+    i !~ /[,\\]\s*\z/
+  rescue IncompleteExpression
+    false
+  ensure
+    $VERBOSE = old_verbose
+  end
+
+  private
+
+  # ========================================================================= #
+  # === extract_first_expression
+  #
+  # Get the first expression from the input.
+  #
+  # @param [Array<String>]  lines
+  # @param [Fixnum] consume A number of lines to automatically
+  #   consume (add to the expression buffer) without checking for validity.
+  # @yield a clean-up function to run before checking for complete_expression
+  # @return [String]  a valid ruby expression
+  # @raise [SyntaxError]
+  # ========================================================================= #
+  def extract_first_expression(lines, consume = 0, &block)
+    code = consume.zero? ? '' : lines.slice!(0..(consume - 1)).join
+    lines.each { |entry|
+      code << entry
+      return code if complete_expression?(block ? block.call(code) : code)
+    }
+    raise SyntaxError, "unexpected $end"
+  end
+
+  # ========================================================================= #
+  # === extract_last_comment
+  #
+  # Get the last comment from the input.
+  #
+  # @param [Array<String>]  lines
+  # @return [String]
+  # ========================================================================= #
+  def extract_last_comment(lines)
+    result = ''
+    lines.each { |line|
+      # ===================================================================== #
+      # Add any line that is a valid ruby comment but stop the moment
+      # we hit a non-comment line.
+      # ===================================================================== #
+      if (line =~ /^\s*#/) || (line =~ /^\s*$/)
+        result << line.lstrip
+      else
+        result.replace("")
+      end
+    }
+    return result
+  end
+
+  # ========================================================================= #
+  # === IncompleteExpression
+  #
+  # An exception matcher that matches only subsets of SyntaxErrors that can be
+  # fixed by adding more input to the buffer.
+  # ========================================================================= #
+  module IncompleteExpression
+    GENERIC_REGEXPS = [
+      /unexpected (\$end|end-of-file|end-of-input|END_OF_FILE)/, # mri, jruby, ruby-2.0, ironruby
+      /embedded document meets end of file/, # =begin
+      /unterminated (quoted string|string|regexp) meets end of file/, # "quoted string" is ironruby
+      /can not find the string ".*" anywhere before EOF/, # rbx and jruby
+      /missing 'end' for/, /expecting kWHEN/ # rbx
+    ]
+
+    def self.===(ex)
+      return false unless SyntaxError === ex
+      case ex.message
+      when *GENERIC_REGEXPS
+        true
+      else
+        false
+      end
+    end
+  end
+
+end; end

data/lib/method_introspection/load_project.rb

@@ -0,0 +1,23 @@
+module MethodIntrospection # require 'method_source/project_base_directory.rb'
+
+  # ========================================================================= #
+  # === PROJECT_BASE_DIRECTORY
+  # ========================================================================= #
+  PROJECT_BASE_DIRECTORY = RbConfig::CONFIG['sitelibdir']+'/method_introspection/'
+
+  # ========================================================================= #
+  # === MethodIntrospection.project_base_dir?
+  # ========================================================================= #
+  def self.project_base_dir?
+    PROJECT_BASE_DIRECTORY
+  end
+
+  # ========================================================================= #
+  # Next we load up the various .rb files of that project.
+  # ========================================================================= #
+  require MethodIntrospection.project_base_dir?+'version/version.rb'
+  require MethodIntrospection.project_base_dir?+'source_location'
+  require MethodIntrospection.project_base_dir?+'code_helpers'
+  require MethodIntrospection.project_base_dir?+'module_methods'
+
+end

data/lib/method_introspection/module_methods.rb

@@ -0,0 +1,78 @@
+module MethodIntrospection
+
+  # ========================================================================= #
+  # === SourceNotFoundError
+  #
+  # An Exception to mark errors that were raised trying to find the
+  # source from a given source_location.
+  # ========================================================================= #
+  class SourceNotFoundError < StandardError; end
+
+  # ========================================================================= #
+  # === MethodIntrospection.raise_this
+  #
+  # Second argument is optional, and allows for a longer description.
+  # ========================================================================= #
+  def self.raise_this(name, optional_extra = nil)
+    result = "We could not locate the source for #{name}"
+    if optional_extra
+      result << ": #{optional_extra}"
+    else
+      result << '.'
+    end
+    raise SourceNotFoundError, result
+  end
+      
+  # ========================================================================= #
+  # === MethodIntrospection.source_helper
+  #
+  # Helper method responsible for extracting the body of a method.
+  #
+  # Defined here to avoid polluting `Method` class.
+  # @param [Array] source_location The array returned by Method#source_location
+  # @param [String]  method_name
+  # @return [String] The method body
+  # ========================================================================= #
+  def self.source_helper(source_location, name = nil)
+    raise_this(name) unless source_location
+    file, line = *source_location
+    expression_at(lines_for(file), line)
+  rescue SyntaxError => error
+    raise SourceNotFoundError,
+      "Could not parse source for #{name}: #{error.message}"
+  end
+
+  # ========================================================================= #
+  # === MethodIntrospection.comment_helper
+  #
+  # Helper method responsible for opening source file and buffering up
+  # the comments for a specified method. Defined here to avoid polluting
+  # `Method` class.
+  # @param [Array] source_location The array returned by Method#source_location
+  # @param [String]  method_name
+  # @return [String] The comments up to the point of the method.
+  # ========================================================================= #
+  def self.comment_helper(source_location, name = nil)
+    raise_this(name) unless source_location
+    file, line = *source_location
+    comment_describing(lines_for(file), line)
+  end
+
+  # ========================================================================= #
+  # === MethodIntrospection.lines_for
+  #
+  # Load a memoized copy of the lines in a file.
+  #
+  # @param [String]  file_name
+  # @param [String]  method_name
+  # @return [Array<String>]  the contents of the file
+  # @raise [SourceNotFoundError]
+  # ========================================================================= #
+  def self.lines_for(file_name, name = nil)
+    @lines_for_file ||= {}
+    @lines_for_file[file_name] ||= File.readlines(file_name)
+  rescue Errno::ENOENT => e
+    raise_this(name, e.message)
+  end
+
+end

data/lib/method_introspection/source_location.rb

@@ -0,0 +1,68 @@
+module MethodIntrospection
+  module SourceLocation
+    module MethodExtensions
+      # ===================================================================== #
+      # === trace_func
+      # ===================================================================== #
+      def trace_func(event, file, line, id, binding, classname)
+        return unless event == 'call'
+        set_trace_func(nil)
+        @file, @line = file, line
+        raise :found
+      end; private :trace_func
+    end
+
+    module ProcExtensions
+      # Return the source location for a Proc (in implementations
+      # without Proc#source_location)
+      #
+      # @return [Array] A two element array. First element is the
+      #   file, second element is the line in the file where the
+      #   proc definition is found.
+      def source_location
+        self.to_s =~ /@(.*):(\d+)/
+        [$1, $2.to_i]
+      end
+    end
+
+    module UnboundMethodExtensions
+      # Return the source location of an instance method for Ruby 1.8.
+      #
+      # @return [Array] A two element array. First element is the
+      #   file, second element is the line in the file where the
+      #   method definition is found.
+      def source_location
+        klass = case owner
+                when Class
+                  owner
+                when Module
+                  method_owner = owner
+                  Class.new { include(method_owner) }
+                end
+
+        # deal with immediate values
+        case
+        when klass == Symbol
+          return :a.method(name).source_location
+        when klass == Fixnum
+          return 0.method(name).source_location
+        when klass == TrueClass
+          return true.method(name).source_location
+        when klass == FalseClass
+          return false.method(name).source_location
+        when klass == NilClass
+          return nil.method(name).source_location
+        end
+        begin
+          Object.instance_method(:method).bind(klass.allocate).call(name).source_location
+        rescue TypeError
+          # Assume we are dealing with a Singleton Class:
+          # 1. Get the instance object
+          # 2. Forward the source_location lookup to the instance
+          instance ||= ObjectSpace.each_object(owner).first
+          Object.instance_method(:method).bind(instance).call(name).source_location
+        end
+      end
+    end
+  end
+end

data/lib/method_introspection/version/version.rb

@@ -0,0 +1,5 @@
+module MethodIntrospection
+
+  VERSION = '0.0.1'
+
+end

data/lib/method_introspection.rb

@@ -0,0 +1,58 @@
+require 'method_introspection/load_project.rb'
+
+module MethodIntrospection
+
+  extend MethodIntrospection::CodeHelpers
+
+  # This module is to be included by `Method` and `UnboundMethod` and
+  # provides the `#source` functionality
+  module MethodExtensions
+    # === source
+    #
+    # The method source() will return the sourcecode for the method as
+    # a String.
+    #
+    # @return [String] The method sourcecode as a string
+    # @raise SourceNotFoundException
+    #
+    # @example
+    #  Set.instance_method(:clear).source.display
+    #  =>
+    #     def clear
+    #       @hash.clear
+    #       self
+    #     end
+    def source
+      MethodIntrospection.source_helper(source_location, defined?(name) ? name : inspect)
+    end
+
+    # === comment
+    #
+    # Return the comments associated with the method as a string.
+    # @return [String] The method's comments as a string
+    # @raise SourceNotFoundException
+    #
+    # @example
+    #  Set.instance_method(:clear).comment.display
+    #  =>
+    #     # Removes all elements and returns self.
+    def comment
+      MethodIntrospection.comment_helper(source_location, defined?(name) ? name : inspect)
+    end
+  end
+end
+
+class Method
+  include MethodIntrospection::SourceLocation::MethodExtensions
+  include MethodIntrospection::MethodExtensions
+end
+
+class UnboundMethod
+  include MethodIntrospection::SourceLocation::UnboundMethodExtensions
+  include MethodIntrospection::MethodExtensions
+end
+
+class Proc
+  include MethodIntrospection::SourceLocation::ProcExtensions
+  include MethodIntrospection::MethodExtensions
+end

data/method_introspection.gemspec

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+require 'method_introspection/version/version.rb'
+
+DESCRIPTION = 'Allows us to inspect the source code for a method and the documentation.'
+
+Gem::Specification.new { |s|
+  s.name    = 'method_introspection'
+  s.version = MethodIntrospection::VERSION
+
+  s.authors = ['Robert A. Heiler']
+  s.date    = Time.now.strftime('%Y-%m-%d')
+  s.email   = 'shevegen@gmail.com'
+  s.files   = %w(
+    README.md
+    lib/method_introspection.rb
+    lib/method_introspection/code_helpers.rb
+    lib/method_introspection/source_location.rb
+    lib/method_introspection/load_project.rb
+    lib/method_introspection/module_methods.rb
+    lib/method_introspection/version/version.rb
+    test/test.rb
+    test/test_code_helpers.rb
+    test/test_helper.rb
+    method_introspection.gemspec
+  )
+  s.homepage = 'http://shevegen.square7.ch/'
+  s.require_paths = ['lib']
+  s.summary     = DESCRIPTION
+  s.description = DESCRIPTION
+  s.license     = 'MIT'
+  s.test_files  = [
+    'test/test.rb',
+    'test/test_code_helpers.rb',
+    'test/test_helper.rb'
+  ]
+
+  s.required_ruby_version = '>= 2.2.2'
+  s.rubygems_version = '2.4.8'
+
+}

data/test/test.rb

@@ -0,0 +1,138 @@
+direc = File.expand_path(File.dirname(__FILE__))
+
+require 'rubygems'
+require 'bacon'
+require 'method_introspection/method_source.rb'
+require "#{direc}/test_helper"
+
+describe MethodIntrospection do
+
+  describe "source_location (testing 1.8 implementation)" do
+    it 'should return correct source_location for a method' do
+      method(:hello).source_location.first.should =~ /test_helper/
+    end
+
+    it 'should not raise for immediate instance methods' do
+      [Symbol, Fixnum, TrueClass, FalseClass, NilClass].each do |immediate_class|
+        lambda { immediate_class.instance_method(:to_s).source_location }.should.not.raise
+      end
+    end
+
+    it 'should not raise for immediate methods' do
+      [:a, 1, true, false, nil].each do |immediate|
+        lambda { immediate.method(:to_s).source_location }.should.not.raise
+      end
+    end
+  end
+
+  before do
+    @hello_module_source = "  def hello; :hello_module; end\n"
+    @hello_singleton_source = "def $o.hello; :hello_singleton; end\n"
+    @hello_source = "def hello; :hello; end\n"
+    @hello_comment = "# A comment for hello\n# It spans two lines and is indented by 2 spaces\n"
+    @lambda_comment = "# This is a comment for MyLambda\n"
+    @lambda_source = "MyLambda = lambda { :lambda }\n"
+    @proc_source = "MyProc = Proc.new { :proc }\n"
+    @hello_instance_evaled_source = "  def hello_\#{name}(*args)\n    send_mesg(:\#{name}, *args)\n  end\n"
+    @hello_instance_evaled_source_2 = "  def \#{name}_two()\n    if 44\n      45\n    end\n  end\n"
+    @hello_class_evaled_source = "  def hello_\#{name}(*args)\n    send_mesg(:\#{name}, *args)\n  end\n"
+    @hi_module_evaled_source = "  def hi_\#{name}\n    @var = \#{name}\n  end\n"
+  end
+
+  it 'should define methods on Method and UnboundMethod and Proc' do
+    Method.method_defined?(:source).should == true
+    UnboundMethod.method_defined?(:source).should == true
+    Proc.method_defined?(:source).should == true
+  end
+
+  describe "Methods" do
+    it 'should return source for method' do
+      method(:hello).source.should == @hello_source
+    end
+
+    it 'should return source for a method defined in a module' do
+      M.instance_method(:hello).source.should == @hello_module_source
+    end
+
+    it 'should return source for a singleton method as an instance method' do
+      class << $o; self; end.instance_method(:hello).source.should == @hello_singleton_source
+    end
+
+    it 'should return source for a singleton method' do
+      $o.method(:hello).source.should == @hello_singleton_source
+    end
+
+    it 'should return a comment for method' do
+      method(:hello).comment.should == @hello_comment
+    end
+
+    # These tests fail because of http://jira.codehaus.org/browse/JRUBY-4576
+    unless defined?(RUBY_ENGINE) && RUBY_ENGINE == "jruby"
+      it 'should return source for an *_evaled method' do
+        M.method(:hello_name).source.should == @hello_instance_evaled_source
+        M.method(:name_two).source.should == @hello_instance_evaled_source_2
+        M.instance_method(:hello_name).source.should == @hello_class_evaled_source
+        M.instance_method(:hi_name).source.should == @hi_module_evaled_source
+      end
+    end
+
+    it "should raise error for evaled methods that do not pass __FILE__ and __LINE__ + 1 as its arguments" do
+      lambda { M.instance_method(:name_three).source }.should.raise MethodSource::SourceNotFoundError
+    end
+
+    if !is_rbx?
+      it 'should raise for C methods' do
+        lambda { method(:puts).source }.should.raise MethodSource::SourceNotFoundError
+      end
+    end
+  end
+
+  # if RUBY_VERSION =~ /1.9/ || is_rbx?
+  describe "Lambdas and Procs" do
+    it 'should return source for proc' do
+      MyProc.source.should == @proc_source
+    end
+
+    it 'should return an empty string if there is no comment' do
+      MyProc.comment.should == ''
+    end
+
+    it 'should return source for lambda' do
+      MyLambda.source.should == @lambda_source
+    end
+
+    it 'should return comment for lambda' do
+      MyLambda.comment.should == @lambda_comment
+    end
+  end
+  # end
+  describe "Comment tests" do
+    before do
+      @comment1 = "# a\n# b\n"
+      @comment2 = "# a\n# b\n"
+      @comment3 = "# a\n#\n# b\n"
+      @comment4 = "# a\n# b\n"
+      @comment5 = "# a\n# b\n# c\n# d\n"
+    end
+
+    it "should correctly extract multi-line comments" do
+      method(:comment_test1).comment.should == @comment1
+    end
+
+    it "should correctly strip leading whitespace before comments" do
+      method(:comment_test2).comment.should == @comment2
+    end
+
+    it "should keep empty comment lines" do
+      method(:comment_test3).comment.should == @comment3
+    end
+
+    it "should ignore blank lines between comments" do
+      method(:comment_test4).comment.should == @comment4
+    end
+
+    it "should align all comments to same indent level" do
+      method(:comment_test5).comment.should == @comment5
+    end
+  end
+end

data/test/test_code_helpers.rb

@@ -0,0 +1,42 @@
+require 'method_introspection'
+
+describe MethodSource::CodeHelpers do
+  before {
+    @tester = Object.new.extend(MethodSource::CodeHelpers)
+  }
+  [
+    ["p = '", "'"],
+    ["def", 'a', "(); end"],
+    ["p = <<FOO", "lots", "and", "lots of", "foo", "FOO"],
+    ["[", ":lets,", "'list',", "[/nested/", "], things ]"],
+    ["abc =~ /hello", "/"],
+    ["issue = %W/", "343/"],
+    ["pouts(<<HI, 'foo", "bar", "HI", "baz')"],
+    ["=begin", "no-one uses this syntax anymore...", "=end"],
+    ["puts 1, 2,", "3"],
+    ["puts 'hello'\\", "'world'"]
+  ].each do |lines|
+    it "should not raise an error on broken lines: #{lines.join("\\n")}" do
+      1.upto(lines.size - 1) do |i|
+        @tester.complete_expression?(lines[0...i].join("\n") + "\n").should == false
+      end
+      @tester.complete_expression?(lines.join("\n")).should == true
+    end
+  end
+
+  [
+    ["end"],
+    ["puts )("],
+    ["1 1"],
+    ["puts :"]
+  ] + (RbConfig::CONFIG['ruby_install_name'] == 'rbx' ? [] : [
+    ["def", "method(1"], # in this case the syntax error is "expecting ')'".
+    ["o = Object.new.tap{ def o.render;","'MEH'", "}"] # in this case the syntax error is "expecting keyword_end".
+  ]).compact.each do |foo|
+    it "should raise an error on invalid syntax like #{foo.inspect}" do
+      lambda{
+        @tester.complete_expression?(foo.join("\n"))
+      }.should.raise(SyntaxError)
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,98 @@
+def is_rbx?
+  defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /rbx/
+end
+
+def jruby?
+  defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /jruby/
+end
+
+
+module M
+  def hello; :hello_module; end
+end
+
+$o = Object.new
+def $o.hello; :hello_singleton; end
+
+# A comment for hello
+
+  # It spans two lines and is indented by 2 spaces
+def hello; :hello; end
+
+# a
+# b
+def comment_test1; end
+
+ # a
+ # b
+def comment_test2; end
+
+# a
+#
+# b
+def comment_test3; end
+
+# a
+
+# b
+def comment_test4; end
+
+
+# a
+  # b
+    # c
+# d
+def comment_test5; end
+
+# This is a comment for MyLambda
+MyLambda = lambda { :lambda }
+MyProc = Proc.new { :proc }
+
+
+name = "name"
+
+M.instance_eval <<-METHOD, __FILE__, __LINE__ + 1
+  def hello_#{name}(*args)
+    send_mesg(:#{name}, *args)
+  end
+METHOD
+
+M.class_eval <<-METHOD, __FILE__, __LINE__ + 1
+  def hello_#{name}(*args)
+    send_mesg(:#{name}, *args)
+  end
+METHOD
+
+# module_eval to DRY code up
+#
+M.module_eval <<-METHOD, __FILE__, __LINE__ + 1
+
+  # module_eval is used here
+  #
+  def hi_#{name}
+    @var = #{name}
+  end
+METHOD
+
+# case where 2 methods are defined inside an _eval block
+#
+M.instance_eval <<EOF, __FILE__, __LINE__ + 1
+
+  def #{name}_one()
+    if 43
+      44
+    end
+  end
+
+
+  def #{name}_two()
+    if 44
+      45
+    end
+  end
+EOF
+
+# class_eval without filename and lineno + 1 parameter
+
+M.class_eval "def #{name}_three; @tempfile.#{name}; end"
+

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: method_introspection
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-20 00:00:00.000000000 Z
+dependencies: []
+description: Allows us to inspect the source code for a method and the documentation.
+email: shevegen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/method_introspection.rb
+- lib/method_introspection/code_helpers.rb
+- lib/method_introspection/load_project.rb
+- lib/method_introspection/module_methods.rb
+- lib/method_introspection/source_location.rb
+- lib/method_introspection/version/version.rb
+- method_introspection.gemspec
+- test/test.rb
+- test/test_code_helpers.rb
+- test/test_helper.rb
+homepage: http://shevegen.square7.ch/
+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.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Allows us to inspect the source code for a method and the documentation.
+test_files:
+- test/test.rb
+- test/test_code_helpers.rb
+- test/test_helper.rb