pry-rescue 0.3

data/LICENSE.MIT

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Conrad Irwin <conrad.irwin@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,133 @@
+
+**pry-rescue** helps you quickly figure out why your code broke; when an exception is raised that would normally kill your program, Pry comes to the rescue, opening a Pry session in the context of code that raised the exception.
+
+Installation
+============
+
+Either `gem install pry-rescue`, or add it to the development section of your Gemfile:
+
+```ruby
+source :rubygems
+group :development do
+  gem 'pry-rescue'
+  gem 'pry-stack_explorer' # if you're using MRI 1.9 and you want it to be awesome.
+end
+```
+
+Usage
+=====
+
+There are *two ways* to use pry-rescue:
+
+Wrap an entire script
+---------------------
+
+Use the launcher script:
+
+```
+rescue <script.rb> [arguments..]
+```
+
+Wrap a block in your code
+-------------------------
+In development, wrap your code in `Pry::rescue{ }`; then any exceptions that are raised
+but not rescued will open a pry session. This is particularly useful for debugging
+servers and other long-running processes.
+
+```ruby
+require 'pry-rescue'
+
+def test
+  raise "foo"
+rescue => e
+  raise "bar"
+end
+
+Pry.rescue do
+  test
+end
+```
+
+This will land you in a pry-session:
+
+```
+From: examples/example.rb @ line 4 Object#test:
+
+    4: def test
+    5:   raise "foo"
+    6: rescue => e
+ => 7:   raise "bar"
+    8: end
+
+RuntimeError: bar
+from examples/example.rb:7:in `rescue in test'
+[1] pry(main)>
+```
+
+cd-cause
+========
+
+If you need to find the reason that the exception happened, you can use the `cd-cause`
+command:
+
+```
+[1] pry(main)> cd-cause
+From: examples/example.rb @ line 4 Object#test:
+
+    4: def test
+ => 5:   raise "foo"
+    6: rescue => e
+    7:   raise "bar"
+    8: end
+
+RuntimeError: foo
+from examples/example.rb:5:in `test'
+[1] pry(main)>
+```
+
+To get back from `cd-cause` you can either type `<ctrl+d>` or `cd ..`.
+
+try-again
+=========
+
+Once you've used Pry's `edit` or `edit-method` commands to fix your code, you can issue a
+`try-again` command to re-run your code. (Either from the start in the case of using the
+`rescue` script, or from the block if you're using that API).
+
+```
+[1] pry(main)> edit-method
+[2] pry(main)> whereami
+From: examples/example.rb @ line 4 Object#test:
+
+    4: def test
+ => 5:   puts "foo"
+    6: rescue => e
+    7:   raise "bar"
+    8: end
+[3] pry(main)> try-again
+foo
+```
+
+pry-stack explorer
+==================
+
+If you're running rubinius, or ruby-1.9, then you can use `pry-rescue` alongside
+`pry-stack_explorer`. This gives you the ability to move `up` or `down` the stack so that
+you can get a better idea of why your function ended up in a bad state. Run
+[example2.rb](https://github.com/ConradIrwin/pry-rescue/blob/master/examples/example2.rb) to get a feel for what this is like.
+
+Known bugs
+==========
+
+Occasionally, when using ruby-1.8 or jruby, the value for `self` will be incorrect. You
+will still be able to access local variables, but calling methods will not work as you
+expect.
+
+On rbx we are unable to intercept some exceptions thrown from inside the C++ VM, for
+example the ZeroDivisionError in `1 / 0`.
+
+Meta-fu
+=======
+
+Released under the MIT license, see LICENSE.MIT for details. Contributions and bug-reports
+are welcome.

data/Rakefile

@@ -0,0 +1,22 @@
+desc "Run example"
+task :example do
+  sh "ruby -I./lib/ ./examples/example.rb "
+end
+
+desc "Run example 2"
+task :example2 do
+  sh "ruby -I./lib/ ./examples/example2.rb "
+end
+
+desc "Run tests"
+task :test do
+  sh 'rspec spec -r ./spec/spec_helpers.rb'
+end
+
+task :build do
+  sh 'gem build *.gemspec'
+end
+
+task :install => :build do
+  sh 'gem install *.gem'
+end

data/bin/rescue

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+USAGE = %{
+rescue (pry-rescue wrapper)
+
+Usage:
+  rescue <script.rb> [arguments...]
+
+What it does:
+  Runs <script.rb>, and if an uncaught exception is raised,
+  pry will come to the rescue, giving you a pry prompt in the
+  context where the exception was raised.
+
+  You can then poke around to figure out why your code broke!
+
+  (Not yet available: fixing the problem and continuing your program.)
+
+}
+
+if script = ARGV.shift
+  if File.exists? script
+    require 'pry-rescue'
+    begin; require 'pry-stack_explorer'; rescue LoadError; end
+
+    $0 = File.expand_path script
+    Pry.rescue { load script }
+  else
+    $stderr.puts "Error: #{script.inspect} not found."
+  end
+else
+  puts USAGE
+end

data/examples/example.rb

@@ -0,0 +1,21 @@
+$:.unshift File.expand_path '../../lib', __FILE__
+require 'pry-rescue'
+
+Pry.rescue do
+
+  def a
+    begin
+      begin
+        raise "foo"
+
+      rescue => e
+        raise "bar"
+      end
+
+    rescue => e
+      1 / 0
+
+    end
+  end
+  a
+end

data/examples/example2.rb

@@ -0,0 +1,20 @@
+$:.unshift File.expand_path '../../lib', __FILE__
+require 'pry-rescue'
+
+def alpha
+  x = 1
+  beta
+end
+
+def beta
+  y = 30
+  gamma(1, 2)
+end
+
+def gamma(x)
+  greeting = x
+end
+
+Pry.rescue do
+  alpha
+end

data/lib/pry-rescue.rb

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'interception'
+require 'pry'
+
+require File.expand_path('../pry-rescue/core_ext', __FILE__)
+require File.expand_path('../pry-rescue/commands', __FILE__)
+
+begin
+  require 'pry-stack_explorer'
+rescue LoadError
+end
+
+class PryRescue
+  class << self
+
+    # Start a Pry session in the context of the exception.
+    # @param [Exception] exception The exception.
+    # @param [Array<Binding>] bindings The call stack.
+    def enter_exception_context(raised)
+      exception, bindings = raised.last
+
+      prune_call_stack!(bindings)
+
+      if defined?(PryStackExplorer)
+        pry :call_stack => bindings, :hooks => pry_hooks(exception, raised)
+      else
+        bindings.first.pry :hooks => pry_hooks(exception, raised)
+      end
+    end
+
+    private
+
+    # Define the :before_session hook for the Pry instance.
+    # This ensures that the `_ex_` and `_raised_` sticky locals are
+    # properly set.
+    def pry_hooks(ex, raised)
+      hooks = Pry.config.hooks.dup
+      hooks.add_hook(:before_session, :save_captured_exception) do |_, _, _pry_|
+        _pry_.last_exception = ex
+        _pry_.backtrace = ex.backtrace
+        _pry_.sticky_locals.merge!({ :_raised_ => raised })
+        _pry_.exception_handler.call(_pry_.output, ex, _pry_)
+      end
+
+      hooks
+    end
+
+    # Sanitize the call stack.
+    # @param [Array<Binding>] bindings The call stack.
+    def prune_call_stack!(bindings)
+      bindings.delete_if { |b| [Pry, Interception].include?(b.eval("self")) }
+    end
+  end
+end

data/lib/pry-rescue/cli.rb

@@ -0,0 +1 @@
+require 'pry-rescue'

data/lib/pry-rescue/commands.rb

@@ -0,0 +1,65 @@
+Pry::Commands.create_command "cd-cause", "Move to the previously raised exception"  do
+
+  banner <<-BANNER
+    Usage: cd-cause
+
+    Starts a new pry session at the previously raised exception.
+
+    This is useful if you've caught one exception, and raised another,
+    if you need to find out why the original was raised.
+
+    @example
+      5.    def foo
+      6.      raise "one"
+      7.    rescue
+      8. =>    raise "two"
+      9.    end
+
+      pry> cd-cause
+
+      5.    def foo
+      6. =>    raise "one"
+      7.    rescue
+      8.       raise "two"
+      9.    end
+
+    Once you have finished with the internal exception type <ctrl+d> or cd .. to
+    return to where you were.
+
+    If you have many layers of exceptions that are rescued and then re-raised, you
+    can repeat cd-cause as many times as you need.
+  BANNER
+
+  def process
+    raised = target.eval("_raised_ rescue nil")
+    raise Pry::CommandError, "cd-cause only works in a pry session created by Pry::rescue{}" unless raised
+    raised.pop
+
+    if raised.any?
+      PryRescue.enter_exception_context(raised)
+    else
+      raise Pry::CommandError, "No previous exception detected"
+    end
+  end
+end
+
+Pry::Commands.create_command "try-again", "Re-try the code that caused this exception" do
+
+  banner <<-BANNER
+    Usage: try-again
+
+    Runs the code wrapped by Pry::rescue{ } again.
+
+    This is useful if you've used `edit` or `edit-method` to fix the problem
+    that caused this exception to be raised and you want a quick way to test
+    your changes.
+
+    NOTE: try-again may cause confusing results if the code that's run have
+    side-effects (like deleting rows from a database) as it will try to do that
+    again, which may not work.
+  BANNER
+
+  def process
+    run "exit", ":try_again"
+  end
+end

data/lib/pry-rescue/core_ext.rb

@@ -0,0 +1,30 @@
+class Pry
+
+  # Start a pry session on any unhandled exceptions within this block.
+  #
+  # @example
+  #   Pry::rescue do
+  #     raise "foo"
+  #   end
+  #
+  # @return [Object] The return value of the block
+  def self.rescue(&block)
+    raised = []
+
+    Interception.listen(block) do |exception, binding|
+      if defined?(PryStackExplorer)
+        raised << [exception, binding.callers]
+      else
+        raised << [exception, Array(binding)]
+      end
+    end
+
+  rescue Exception => e
+    case PryRescue.enter_exception_context(raised)
+    when :try_again
+      retry
+    else
+      raise
+    end
+  end
+end

data/pry-rescue.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name          = 'pry-rescue'
+  s.version       = '0.3'
+  s.summary       = 'Open a pry session on any unhandled exceptions'
+  s.description   = 'Allows you to wrap code in Pry::rescue{ } to open a pry session at any unhandled exceptions'
+  s.homepage      = 'https://github.com/ConradIrwin/pry-rescue'
+  s.email         = ['conrad.irwin@gmail.com', 'jrmair@gmail.com', 'chris@ill-logic.com']
+  s.authors       = ['Conrad Irwin', 'banisterfiend', 'epitron']
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ['lib']
+  s.executables   = ['rescue']
+
+  s.add_dependency 'interception'
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: pry-rescue
+version: !ruby/object:Gem::Version
+  version: '0.3'
+  prerelease: 
+platform: ruby
+authors:
+- Conrad Irwin
+- banisterfiend
+- epitron
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: interception
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Allows you to wrap code in Pry::rescue{ } to open a pry session at any
+  unhandled exceptions
+email:
+- conrad.irwin@gmail.com
+- jrmair@gmail.com
+- chris@ill-logic.com
+executables:
+- rescue
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.MIT
+- README.md
+- Rakefile
+- bin/rescue
+- examples/example.rb
+- examples/example2.rb
+- lib/pry-rescue.rb
+- lib/pry-rescue/cli.rb
+- lib/pry-rescue/commands.rb
+- lib/pry-rescue/core_ext.rb
+- pry-rescue.gemspec
+homepage: https://github.com/ConradIrwin/pry-rescue
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Open a pry session on any unhandled exceptions
+test_files: []
+has_rdoc: