pry 0.10.pre.1-i386-mingw32 → 0.10.0.pre3-i386-mingw32

data/lib/pry/commands/pry_backtrace.rb

@@ -0,0 +1,25 @@
+class Pry
+  class Command::PryBacktrace < Pry::ClassCommand
+    match 'pry-backtrace'
+    group 'Context'
+    description 'Show the backtrace for the Pry session.'
+
+    banner <<-BANNER
+      Usage: pry-backtrace [OPTIONS] [--help]
+
+      Show the backtrace for the position in the code where Pry was started. This can
+      be used to infer the behavior of the program immediately before it entered Pry,
+      just like the backtrace property of an exception.
+
+      NOTE: if you are looking for the backtrace of the most recent exception raised,
+      just type: `_ex_.backtrace` instead.
+      See: https://github.com/pry/pry/wiki/Special-Locals
+    BANNER
+
+    def process
+      _pry_.pager.page text.bold('Backtrace:') << "\n--\n" << _pry_.backtrace.join("\n")
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::PryBacktrace)
+end

data/lib/pry/commands/pry_version.rb

@@ -0,0 +1,17 @@
+class Pry
+  class Command::Version < Pry::ClassCommand
+    match 'pry-version'
+    group 'Misc'
+    description 'Show Pry version.'
+
+    banner <<-'BANNER'
+      Show Pry version.
+    BANNER
+
+    def process
+      output.puts "Pry version: #{Pry::VERSION} on Ruby #{RUBY_VERSION}."
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Version)
+end

data/lib/pry/commands/raise_up.rb

@@ -0,0 +1,32 @@
+class Pry
+  # N.B. using a regular expresion here so that "raise-up 'foo'" does the right thing.
+  class Command::RaiseUp < Pry::ClassCommand
+    match(/raise-up(!?\b.*)/)
+    group 'Context'
+    description 'Raise an exception out of the current pry instance.'
+    command_options :listing => 'raise-up'
+
+    banner <<-BANNER
+      Raise up, like exit, allows you to quit pry. Instead of returning a value
+      however, it raises an exception. If you don't provide the exception to be
+      raised, it will use the most recent exception (in pry `_ex_`).
+
+      When called as raise-up! (with an exclamation mark), this command raises the
+      exception through any nested prys you have created by "cd"ing into objects.
+
+      raise-up "get-me-out-of-here"
+
+      # This is equivalent to the command above.
+      raise "get-me-out-of-here"
+      raise-up
+    BANNER
+
+    def process
+      return _pry.pager.page help if captures[0] =~ /(-h|--help)\b/
+      # Handle 'raise-up', 'raise-up "foo"', 'raise-up RuntimeError, 'farble' in a rubyesque manner
+      target.eval("_pry_.raise_up#{captures[0]}")
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::RaiseUp)
+end

data/lib/pry/commands/reload_code.rb

@@ -0,0 +1,62 @@
+class Pry
+  class Command::ReloadCode < Pry::ClassCommand
+    match 'reload-code'
+    group 'Misc'
+    description 'Reload the source file that contains the specified code object.'
+
+    banner <<-'BANNER'
+      Reload the source file that contains the specified code object.
+
+      e.g reload-code MyClass#my_method    #=> reload a method
+          reload-code MyClass              #=> reload a class
+          reload-code my-command           #=> reload a pry command
+          reload-code self                 #=> reload the current object
+          reload-code                      #=> reload the current file or object
+    BANNER
+
+    def process
+      if !args.empty?
+        reload_object(args.join(" "))
+      elsif internal_binding?(target)
+        reload_object("self")
+      else
+        reload_current_file
+      end
+    end
+
+    private
+
+    def current_file
+      File.expand_path target.eval("__FILE__")
+    end
+
+    def reload_current_file
+      if !File.exists?(current_file)
+        raise CommandError, "Current file: #{current_file} cannot be found on disk!"
+      end
+
+      load current_file
+      output.puts "The current file: #{current_file} was reloaded!"
+    end
+
+    def reload_object(identifier)
+      code_object = Pry::CodeObject.lookup(identifier, _pry_)
+      check_for_reloadability(code_object, identifier)
+      load code_object.source_file
+      output.puts "#{identifier} was reloaded!"
+    end
+
+    def check_for_reloadability(code_object, identifier)
+      if !code_object || !code_object.source_file
+        raise CommandError, "Cannot locate #{identifier}!"
+      elsif !File.exists?(code_object.source_file)
+        raise CommandError,
+          "Cannot reload #{identifier} as it has no associated file on disk. " \
+          "File found was: #{code_object.source_file}"
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::ReloadCode)
+  Pry::Commands.alias_command 'reload-method', 'reload-code'
+end

data/lib/pry/commands/reset.rb

@@ -0,0 +1,18 @@
+class Pry
+  class Command::Reset < Pry::ClassCommand
+    match 'reset'
+    group 'Context'
+    description 'Reset the REPL to a clean state.'
+
+    banner <<-'BANNER'
+      Reset the REPL to a clean state.
+    BANNER
+
+    def process
+      output.puts 'Pry reset.'
+      exec 'pry'
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Reset)
+end

data/lib/pry/commands/ri.rb

@@ -0,0 +1,60 @@
+class Pry
+  class Command::Ri < Pry::ClassCommand
+    match 'ri'
+    group 'Introspection'
+    description 'View ri documentation.'
+
+    banner <<-'BANNER'
+      Usage: ri [spec]
+
+      View ri documentation. Relies on the "rdoc" gem being installed.
+      See also "show-doc" command.
+
+      ri Array#each
+    BANNER
+
+    def process(spec)
+      # Lazily load RI
+      require 'rdoc/ri/driver'
+
+      unless defined? RDoc::RI::PryDriver
+
+        # Subclass RI so that it formats its output nicely, and uses `lesspipe`.
+        subclass = Class.new(RDoc::RI::Driver) # the hard way.
+
+        subclass.class_eval do
+          def initialize(pager, opts)
+            @pager = pager
+            super opts
+          end
+          def page
+            paging_text = StringIO.new
+            yield paging_text
+            @pager.page(paging_text.string)
+          end
+
+          def formatter(io)
+            if @formatter_klass
+              @formatter_klass.new
+            else
+              RDoc::Markup::ToAnsi.new
+            end
+          end
+        end
+
+        RDoc::RI.const_set :PryDriver, subclass   # hook it up!
+      end
+
+      # Spin-up an RI insance.
+      ri = RDoc::RI::PryDriver.new _pry_.pager, :use_stdout => true, :interactive => false
+
+      begin
+        ri.display_names [spec]  # Get the documentation (finally!)
+      rescue RDoc::RI::Driver::NotFoundError => e
+        output.puts "error: '#{e.name}' not found"
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Ri)
+end

data/lib/pry/commands/save_file.rb

@@ -0,0 +1,61 @@
+require 'pry/commands/code_collector'
+
+class Pry
+  class Command::SaveFile < Pry::ClassCommand
+    match 'save-file'
+    group 'Input and Output'
+    description 'Export to a file using content from the REPL.'
+
+    banner <<-'BANNER'
+      Usage: save-file [OPTIONS] --to [FILE]
+
+      Export to a file using content from the REPL.
+
+      save-file my_method --to hello.rb
+      save-file -i 1..10 --to hello.rb --append
+      save-file show-method --to my_command.rb
+      save-file sample_file.rb --lines 2..10 --to output_file.rb
+    BANNER
+
+    def options(opt)
+      CodeCollector.inject_options(opt)
+
+      opt.on :to=,        "Specify the output file path"
+      opt.on :a, :append, "Append output to file"
+    end
+
+    def process
+      @cc = CodeCollector.new(args, opts, _pry_)
+      raise CommandError, "Found no code to save." if @cc.content.empty?
+
+      if !file_name
+        display_content
+      else
+        save_file
+      end
+    end
+
+    def file_name
+      opts[:to] || nil
+    end
+
+    def save_file
+      File.open(file_name, mode) do |f|
+        f.puts @cc.content
+      end
+      output.puts "#{file_name} successfully saved"
+    end
+
+    def display_content
+      output.puts @cc.content
+      output.puts "\n\n--\nPlease use `--to FILE` to export to a file."
+      output.puts "No file saved!\n--"
+    end
+
+    def mode
+      opts.present?(:append) ? "a" : "w"
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::SaveFile)
+end

data/lib/pry/commands/shell_command.rb

@@ -0,0 +1,48 @@
+class Pry
+  class Command::ShellCommand < Pry::ClassCommand
+    match(/\.(.*)/)
+    group 'Input and Output'
+    description "All text following a '.' is forwarded to the shell."
+    command_options :listing => '.<shell command>', :use_prefix => false,
+      :takes_block => true
+
+    banner <<-'BANNER'
+      Usage: .COMMAND_NAME
+
+      All text following a "." is forwarded to the shell.
+
+      .ls -aF
+      .uname
+    BANNER
+
+    def process(cmd)
+      if cmd =~ /^cd\s*(.*)/i
+        process_cd parse_destination($1)
+      else
+        pass_block(cmd)
+        if command_block
+          command_block.call `#{cmd}`
+        else
+          _pry_.config.system.call(output, cmd, _pry_)
+        end
+      end
+    end
+
+    private
+
+      def parse_destination(dest)
+        return "~" if dest.empty?
+        return dest unless dest == "-"
+        state.old_pwd || raise(CommandError, "No prior directory available")
+      end
+
+      def process_cd(dest)
+        state.old_pwd = Dir.pwd
+        Dir.chdir File.expand_path(dest)
+      rescue Errno::ENOENT
+        raise CommandError, "No such directory: #{dest}"
+      end
+  end
+
+  Pry::Commands.add_command(Pry::Command::ShellCommand)
+end

data/lib/pry/commands/shell_mode.rb

@@ -0,0 +1,25 @@
+class Pry
+  class Command::ShellMode < Pry::ClassCommand
+    match 'shell-mode'
+    group 'Input and Output'
+    description 'Toggle shell mode. Bring in pwd prompt and file completion.'
+
+    banner <<-'BANNER'
+      Toggle shell mode. Bring in pwd prompt and file completion.
+    BANNER
+
+    def process
+      case _pry_.prompt
+      when Pry::SHELL_PROMPT
+        _pry_.pop_prompt
+        _pry_.custom_completions = _pry_.config.file_completions
+      else
+        _pry_.push_prompt Pry::SHELL_PROMPT
+        _pry_.custom_completions = _pry_.config.command_completions
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::ShellMode)
+  Pry::Commands.alias_command 'file-mode', 'shell-mode'
+end

data/lib/pry/commands/show_doc.rb

@@ -0,0 +1,83 @@
+require 'pry/commands/show_info'
+
+class Pry
+  class Command::ShowDoc < Command::ShowInfo
+    include Pry::Helpers::DocumentationHelpers
+
+    match 'show-doc'
+    group 'Introspection'
+    description 'Show the documentation for a method or class.'
+
+    banner <<-BANNER
+      Usage:   show-doc [OPTIONS] [METH]
+      Aliases: ?
+
+      Show the documentation for a method or class. Tries instance methods first and
+      then methods by default.
+
+      show-doc hi_method # docs for hi_method
+      show-doc Pry       # for Pry class
+      show-doc Pry -a    # for all definitions of Pry class (all monkey patches)
+    BANNER
+
+    # The docs for code_object prepared for display.
+    def content_for(code_object)
+      Code.new(render_doc_markup_for(code_object),
+               start_line_for(code_object), :text).
+        with_line_numbers(use_line_numbers?).to_s
+    end
+
+    # process the markup (if necessary) and apply colors
+    def render_doc_markup_for(code_object)
+      docs = docs_for(code_object)
+
+      if code_object.command?
+        # command '--help' shouldn't use markup highlighting
+        docs
+      else
+        if docs.empty?
+          raise CommandError, "No docs found for: #{
+            obj_name ? obj_name : 'current context'
+          }"
+        end
+        process_comment_markup(docs)
+      end
+    end
+
+    # Return docs for the code_object, adjusting for whether the code_object
+    # has yard docs available, in which case it returns those.
+    # (note we only have to check yard docs for modules since they can
+    # have multiple docs, but methods can only be doc'd once so we
+    # dont need to check them)
+    def docs_for(code_object)
+      if code_object.module_with_yard_docs?
+        # yard docs
+        code_object.yard_doc
+      else
+        # normal docs (i.e comments above method/module/command)
+        code_object.doc
+      end
+    end
+
+    # Which sections to include in the 'header', can toggle: :owner,
+    # :signature and visibility.
+    def header_options
+      super.merge :signature => true
+    end
+
+    # figure out start line of docs by back-calculating based on
+    # number of lines in the comment and the start line of the code_object
+    # @return [Fixnum] start line of docs
+    def start_line_for(code_object)
+      if code_object.command? || opts.present?(:'base-one')
+         1
+      else
+        code_object.source_line.nil? ? 1 :
+          (code_object.source_line - code_object.doc.lines.count)
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::ShowDoc)
+  Pry::Commands.alias_command '?', 'show-doc'
+end