geminfo 0.1.0 → 0.1.1

data/path/gems/method_source-0.8.2/lib/method_source/code_helpers.rb

@@ -1,154 +0,0 @@
-module MethodSource
-
-  module CodeHelpers
-    # 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)
-
-      lines = file.is_a?(Array) ? file : file.each_line.to_a
-
-      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) do |code|
-          code.gsub(/\#\{.*?\}/, "temp")
-        end
-      rescue SyntaxError
-        raise e
-      end
-    end
-
-    # 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
-
-    # 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?(str)
-      old_verbose = $VERBOSE
-      $VERBOSE = nil
-
-      catch(:valid) do
-        eval("BEGIN{throw :valid}\n#{str}")
-      end
-
-      # Assert that a line which ends with a , or \ is incomplete.
-      str !~ /[,\\]\s*\z/
-    rescue IncompleteExpression
-      false
-    ensure
-      $VERBOSE = old_verbose
-    end
-
-    private
-
-    # 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 do |v|
-        code << v
-        return code if complete_expression?(block ? block.call(code) : code)
-      end
-      raise SyntaxError, "unexpected $end"
-    end
-
-    # Get the last comment from the input.
-    #
-    # @param [Array<String>]  lines
-    # @return [String]
-    def extract_last_comment(lines)
-      buffer = ""
-
-      lines.each do |line|
-        # Add any line that is a valid ruby comment,
-        # but clear as soon as we hit a non comment line.
-        if (line =~ /^\s*#/) || (line =~ /^\s*$/)
-          buffer << line.lstrip
-        else
-          buffer.replace("")
-        end
-      end
-
-      buffer
-    end
-
-    # 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't find string ".*" anywhere before EOF/, # rbx and jruby
-        /missing 'end' for/, /expecting kWHEN/ # rbx
-      ]
-
-      RBX_ONLY_REGEXPS = [
-        /expecting '[})\]]'(?:$|:)/, /expecting keyword_end/
-      ]
-
-      def self.===(ex)
-        return false unless SyntaxError === ex
-        case ex.message
-        when *GENERIC_REGEXPS
-          true
-        when *RBX_ONLY_REGEXPS
-          rbx?
-        else
-          false
-        end
-      end
-
-      def self.rbx?
-        RbConfig::CONFIG['ruby_install_name'] == 'rbx'
-      end
-    end
-  end
-end

data/path/gems/method_source-0.8.2/lib/method_source/source_location.rb

@@ -1,138 +0,0 @@
-module MethodSource
-  module ReeSourceLocation
-    # Ruby enterprise edition provides all the information that's
-    # needed, in a slightly different way.
-    def source_location
-      [__file__, __line__] rescue nil
-    end
-  end
-
-  module SourceLocation
-    module MethodExtensions
-      if Proc.method_defined? :__file__
-        include ReeSourceLocation
-
-      elsif defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /jruby/
-        require 'java'
-
-        # JRuby version source_location hack
-        # @return [Array] A two element array containing the source location of the method
-        def source_location
-          to_java.source_location(Thread.current.to_java.getContext())
-        end
-      else
-
-
-        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
-
-        # Return the source location of a 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
-          if @file.nil?
-            args =[*(1..(arity<-1 ? -arity-1 : arity ))]
-
-            set_trace_func method(:trace_func).to_proc
-            call(*args) rescue nil
-            set_trace_func nil
-            @file = File.expand_path(@file) if @file && File.exist?(File.expand_path(@file))
-          end
-          [@file, @line] if @file
-        end
-      end
-    end
-
-    module ProcExtensions
-      if Proc.method_defined? :__file__
-        include ReeSourceLocation
-
-      elsif defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /rbx/
-
-        # Return the source location for a Proc (Rubinius only)
-        # @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
-          [block.file.to_s, block.line]
-        end
-      else
-
-        # 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
-    end
-
-    module UnboundMethodExtensions
-      if Proc.method_defined? :__file__
-        include ReeSourceLocation
-
-      elsif defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /jruby/
-        require 'java'
-
-        # JRuby version source_location hack
-        # @return [Array] A two element array containing the source location of the method
-        def source_location
-          to_java.source_location(Thread.current.to_java.getContext())
-        end
-
-      else
-
-
-        # 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
-end

data/path/gems/method_source-0.8.2/lib/method_source/version.rb

@@ -1,3 +0,0 @@
-module MethodSource
-  VERSION = "0.8.2"
-end

data/path/gems/method_source-0.8.2/method_source.gemspec

@@ -1,33 +0,0 @@
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = "method_source"
-  s.version = "0.8.1"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["John Mair (banisterfiend)"]
-  s.date = "2012-10-17"
-  s.description = "retrieve the sourcecode for a method"
-  s.email = "jrmair@gmail.com"
-  s.files = [".gemtest", ".travis.yml", ".yardopts", "Gemfile", "LICENSE", "README.markdown", "Rakefile", "lib/method_source.rb", "lib/method_source/code_helpers.rb", "lib/method_source/source_location.rb", "lib/method_source/version.rb", "method_source.gemspec", "test/test.rb", "test/test_code_helpers.rb", "test/test_helper.rb"]
-  s.homepage = "http://banisterfiend.wordpress.com"
-  s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.23"
-  s.summary = "retrieve the sourcecode for a method"
-  s.test_files = ["test/test.rb", "test/test_code_helpers.rb", "test/test_helper.rb"]
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<bacon>, ["~> 1.1.0"])
-      s.add_development_dependency(%q<rake>, ["~> 0.9"])
-    else
-      s.add_dependency(%q<bacon>, ["~> 1.1.0"])
-      s.add_dependency(%q<rake>, ["~> 0.9"])
-    end
-  else
-    s.add_dependency(%q<bacon>, ["~> 1.1.0"])
-    s.add_dependency(%q<rake>, ["~> 0.9"])
-  end
-end

data/path/gems/method_source-0.8.2/test/test.rb

@@ -1,138 +0,0 @@
-direc = File.expand_path(File.dirname(__FILE__))
-
-require 'rubygems'
-require 'bacon'
-require "#{direc}/../lib/method_source"
-require "#{direc}/test_helper"
-
-describe MethodSource 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