pry 0.9.10pre1-i386-mswin32 → 0.9.11-i386-mswin32

data/lib/pry/commands/exit_program.rb

@@ -0,0 +1,24 @@
+class Pry
+  class Command::ExitProgram < Pry::ClassCommand
+    match 'exit-program'
+    group 'Navigating Pry'
+    description 'End the current program.'
+
+    banner <<-'BANNER'
+      Usage:   exit-program [--help]
+      Aliases: quit-program
+               !!!
+
+      End the current program.
+    BANNER
+
+    def process
+      Pry.save_history if Pry.config.history.should_save
+      Kernel.exit target.eval(arg_string).to_i
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::ExitProgram)
+  Pry::Commands.alias_command 'quit-program', 'exit-program'
+  Pry::Commands.alias_command '!!!', 'exit-program'
+end

data/lib/pry/commands/find_method.rb

@@ -0,0 +1,199 @@
+class Pry
+  class Command::FindMethod < Pry::ClassCommand
+    extend Pry::Helpers::BaseHelpers
+
+    match 'find-method'
+    group 'Context'
+    description 'Recursively search for a method within a Class/Module or the current namespace.'
+    command_options :shellwords => false
+    command_options :requires_gem => 'ruby18_source_location' if mri_18?
+
+
+    banner <<-'BANNER'
+      Usage: find-method  [-n|-c] METHOD [NAMESPACE]
+
+      Recursively search for a method within a Class/Module or the current namespace.
+      Use the `-n` switch (the default) to search for methods whose name matches the
+      given regex. Use the `-c` switch to search for methods that contain the given
+      code.
+
+      # Find all methods whose name match /re/ inside
+      # the Pry namespace. Matches Pry#repl, etc.
+      find-method re Pry
+
+      # Find all methods that contain the code:
+      # output.puts inside the Pry namepsace.
+      find-method -c 'output.puts' Pry
+    BANNER
+
+    def setup
+      require 'ruby18_source_location' if mri_18?
+    end
+
+    def options(opti)
+      opti.on :n, :name,    "Search for a method by name"
+      opti.on :c, :content, "Search for a method based on content in Regex form"
+    end
+
+    def process
+      return if args.size < 1
+      klass = search_class
+
+      matches = if opts.content?
+        content_search(klass)
+      else
+        name_search(klass)
+      end
+
+      show_search_results(matches)
+    end
+
+    private
+
+    # @return [Regexp] The pattern to search for.
+    def pattern
+      @pattern ||= ::Regexp.new args[0]
+    end
+
+    # Output the result of the search.
+    #
+    # @param [Array] matches
+    def show_search_results(matches)
+      if matches.empty?
+        output.puts text.bold("No Methods Matched")
+      else
+        print_matches(matches)
+      end
+    end
+
+    # The class to search for methods.
+    # We only search classes, so if the search object is an
+    # instance, return its class. If no search object is given
+    # search `target_self`.
+    def search_class
+      klass = if args[1]
+                target.eval(args[1])
+              else
+                target_self
+              end
+
+      klass.is_a?(Module) ? klass : klass.class
+    end
+
+    # pretty-print a list of matching methods.
+    #
+    # @param Array[Method]
+    def print_matches(matches)
+      grouped = matches.group_by(&:owner)
+      order = grouped.keys.sort_by{ |x| x.name || x.to_s }
+
+      order.each do |klass|
+        print_matches_for_class(klass, grouped)
+      end
+    end
+
+    # Print matched methods for a class
+    def print_matches_for_class(klass, grouped)
+      output.puts text.bold(klass.name)
+      grouped[klass].each do |method|
+        header = method.name_with_owner
+        output.puts header + additional_info(header, method)
+      end
+    end
+
+    # Return the matched lines of method source if `-c` is given or ""
+    # if `-c` was not given
+    def additional_info(header, method)
+      if opts.content?
+        ": " + colorize_code(matched_method_lines(header, method))
+      else
+        ""
+      end
+    end
+
+    def matched_method_lines(header, method)
+      method.source.split(/\n/).select {|x| x =~ pattern }.join("\n#{' ' * header.length}")
+    end
+
+    # Run the given block against every constant in the provided namespace.
+    #
+    # @param Module  The namespace in which to start the search.
+    # @param Hash[Module,Boolean]  The namespaces we've already visited (private)
+    # @yieldparam klazz  Each class/module in the namespace.
+    #
+    def recurse_namespace(klass, done={}, &block)
+      return if !(Module === klass) || done[klass]
+
+      done[klass] = true
+
+      yield klass
+
+      klass.constants.each do |name|
+        next if klass.autoload?(name)
+        begin
+          const = klass.const_get(name)
+        rescue RescuableException
+          # constant loading is an inexact science at the best of times,
+          # this often happens when a constant was .autoload? but someone
+          # tried to load it. It's now not .autoload? but will still raise
+          # a NameError when you access it.
+        else
+          recurse_namespace(const, done, &block)
+        end
+      end
+    end
+
+    # Gather all the methods in a namespace that pass the given block.
+    #
+    # @param Module  The namespace in which to search.
+    # @yieldparam Method  The method to test
+    # @yieldreturn Boolean
+    # @return Array[Method]
+    #
+    def search_all_methods(namespace)
+      done = Hash.new{ |h,k| h[k] = {} }
+      matches = []
+
+      recurse_namespace(namespace) do |klass|
+        (Pry::Method.all_from_class(klass) + Pry::Method.all_from_obj(klass)).each do |method|
+          next if done[method.owner][method.name]
+          done[method.owner][method.name] = true
+
+          matches << method if yield method
+        end
+      end
+
+      matches
+    end
+
+    # Search for all methods with a name that matches the given regex
+    # within a namespace.
+    #
+    # @param Module  The namespace to search
+    # @return Array[Method]
+    #
+    def name_search(namespace)
+      search_all_methods(namespace) do |meth|
+        meth.name =~ pattern
+      end
+    end
+
+    # Search for all methods who's implementation matches the given regex
+    # within a namespace.
+    #
+    # @param Module  The namespace to search
+    # @return Array[Method]
+    #
+    def content_search(namespace)
+      search_all_methods(namespace) do |meth|
+        begin
+          meth.source =~ pattern
+        rescue RescuableException
+          false
+        end
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::FindMethod)
+end

data/lib/pry/commands/fix_indent.rb

@@ -0,0 +1,19 @@
+class Pry
+  class Command::FixIndent < Pry::ClassCommand
+    match 'fix-indent'
+    group 'Input and Output'
+
+    description "Correct the indentation for contents of the input buffer"
+
+    banner <<-USAGE
+      Usage: fix-indent
+    USAGE
+
+    def process
+      indented_str = Pry::Indent.indent(eval_string)
+      eval_string.replace indented_str
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::FixIndent)
+end

data/lib/pry/commands/gem_cd.rb

@@ -0,0 +1,26 @@
+class Pry
+  class Command::GemCd < Pry::ClassCommand
+    match 'gem-cd'
+    group 'Gems'
+    description "Change working directory to specified gem's directory."
+    command_options :argument_required => true
+
+    banner <<-'BANNER'
+      Usage: gem-cd GEM_NAME
+
+      Change the current working directory to that in which the given gem is
+      installed.
+    BANNER
+
+    def process(gem)
+      Dir.chdir(Rubygem.spec(gem).full_gem_path)
+      output.puts(Dir.pwd)
+    end
+
+    def complete(str)
+      Rubygem.complete(str)
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::GemCd)
+end

data/lib/pry/commands/gem_install.rb

@@ -0,0 +1,29 @@
+class Pry
+  class Command::GemInstall < Pry::ClassCommand
+    match 'gem-install'
+    group 'Gems'
+    description 'Install a gem and refresh the gem cache.'
+    command_options :argument_required => true
+
+    banner <<-'BANNER'
+      Usage: gem-install GEM_NAME
+
+      Installs the given gem and refreshes the gem cache so that you can immediately
+      'require GEM_FILE'.
+
+      gem-install pry-stack_explorer
+    BANNER
+
+    def setup
+      require 'rubygems/dependency_installer' unless defined? Gem::DependencyInstaller
+    end
+
+    def process(gem)
+      Rubygem.install(gem)
+      output.puts "Gem `#{ text.green(gem) }` installed."
+      require gem
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::GemInstall)
+end

data/lib/pry/commands/gem_list.rb

@@ -0,0 +1,33 @@
+class Pry
+  class Command::GemList < Pry::ClassCommand
+    match 'gem-list'
+    group 'Gems'
+    description 'List and search installed gems.'
+
+    banner <<-'BANNER'
+      Usage: gem-list [REGEX]
+
+      List all installed gems, when a regex is provided, limit the output to those
+      that match the regex.
+    BANNER
+
+    def process(pattern = nil)
+      pattern = Regexp.compile(pattern || '')
+      gems    = Rubygem.list(pattern).group_by(&:name)
+
+      gems.each do |gem, specs|
+        specs.sort! do |a,b|
+          Gem::Version.new(b.version) <=> Gem::Version.new(a.version)
+        end
+
+        versions = specs.each_with_index.map do |spec, index|
+          index == 0 ? text.bright_green(spec.version.to_s) : text.green(spec.version.to_s)
+        end
+
+        output.puts "#{text.default gem} (#{versions.join ', '})"
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::GemList)
+end

data/lib/pry/commands/gem_open.rb

@@ -0,0 +1,29 @@
+class Pry
+  class Command::GemOpen < Pry::ClassCommand
+    match 'gem-open'
+    group 'Gems'
+    description 'Opens the working directory of the gem in your editor'
+    command_options :argument_required => true
+
+    banner <<-'BANNER'
+      Usage: gem-open GEM_NAME
+
+      Change the current working directory to that in which the given gem is
+      installed, and then opens your text editor.
+
+      gem-open pry-exception_explorer
+    BANNER
+
+    def process(gem)
+      Dir.chdir(Rubygem.spec(gem).full_gem_path) do
+        Pry::Editor.invoke_editor(".", 0, false)
+      end
+    end
+
+    def complete(str)
+      Rubygem.complete(str)
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::GemOpen)
+end

data/lib/pry/commands/gist.rb

@@ -0,0 +1,95 @@
+class Pry
+  class Command::Gist < Pry::ClassCommand
+    match 'gist'
+    group 'Misc'
+    description 'Playback a string variable or a method or a file as input.'
+
+    banner <<-'BANNER'
+      Usage: gist [OPTIONS] [--help]
+
+      The gist command enables you to gist code from files and methods to github.
+
+      gist -i 20 --lines 1..3
+      gist Pry#repl --lines 1..-1
+      gist Rakefile --lines 5
+    BANNER
+
+    def setup
+      require 'jist'
+    end
+
+    def options(opt)
+      CodeCollector.inject_options(opt)
+      opt.on :login, "Authenticate the jist gem with GitHub"
+      opt.on :p, :public, "Create a public gist (default: false)", :default => false
+      opt.on :clip, "Copy the selected content to clipboard instead, do NOT gist it", :default => false
+    end
+
+    def process
+      return Jist.login! if opts.present?(:login)
+      cc = CodeCollector.new(args, opts, _pry_)
+
+      if cc.content =~ /\A\s*\z/
+        raise CommandError, "Found no code to gist."
+      end
+
+      if opts.present?(:clip)
+        clipboard_content(cc.content)
+      else
+        # we're overriding the default behavior of the 'in' option (as
+        # defined on CodeCollector) with our local behaviour.
+        content = opts.present?(:in) ? input_content : cc.content
+        gist_content content, cc.file
+      end
+    end
+
+    def clipboard_content(content)
+      Jist.copy(content)
+      output.puts "Copied content to clipboard!"
+    end
+
+    def input_content
+      content = ""
+      CodeCollector.input_expression_ranges.each do |range|
+        input_expressions = _pry_.input_array[range] || []
+        Array(input_expressions).each_with_index do |code, index|
+          corrected_index = index + range.first
+          if code && code != ""
+            content << code
+            if code !~ /;\Z/
+              content << "#{comment_expression_result_for_gist(Pry.config.gist.inspecter.call(_pry_.output_array[corrected_index]))}"
+            end
+          end
+        end
+      end
+
+      content
+    end
+
+    def comment_expression_result_for_gist(result)
+      content = ""
+      result.lines.each_with_index do |line, index|
+        if index == 0
+          content << "# => #{line}"
+        else
+          content << "#    #{line}"
+        end
+      end
+
+      content
+    end
+
+    def gist_content(content, filename)
+      response = Jist.gist(content, :filename => filename || "pry_gist.rb", :public => !!opts[:p])
+      if response
+        url = response['html_url']
+        Jist.copy(url)
+        output.puts 'Gist created at URL, which is now in the clipboard: ', url
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Gist)
+  Pry::Commands.alias_command 'clipit', 'gist --clip'
+  Pry::Commands.alias_command 'jist', 'gist'
+end