hammertime19 0.0.4 → 0.0.5

data/README.rdoc

@@ -7,6 +7,8 @@ hammertime19 is a fork of Avid Grimm's hammertime gem: https://github.com/avdi/h
 hammertime19 is a Ruby 1.9.2+ (MRI and RBX) only version that adds support for starting a pry (https://github.com/pry/pry)
 session at the exception raise site.
 
+hammertime19 also adds basic support for intercepting C-level based exceptions.
+
 == Install
 
 gem install hammertime19
@@ -81,7 +83,7 @@ This enables a fix-and-continue style of development:
     4. Permit by line (don't ask about future errors raised from this point)
     5. Backtrace (show the call stack leading up to the error)
     6. Debug (start a debugger)
-    7. Console (start an IRB session)
+    7. Console (start a pry session)
     What now?
     2
     No error raised
@@ -90,13 +92,47 @@ This enables a fix-and-continue style of development:
     Attempt (3/3)
     No error raised
 
+About non-explicitly raised errors:
+    
+    An example of a non-explicitly raised error is if you divide by 0 which creates a
+    ZeroDivisionError.
+    Hammertime19 cannot process these errors in the same way as user raised errors can be processed.
+    However, they can be intercepted, and a pry session can be started at the exception site.
+
+    For example running this code:
+
+    require 'hammertime19'
+    1 / 0
+
+    Gives you a pry console like this:
+
+    === Stop! Hammertime. ===
+    A C-level error has occurred at h.rb:2:in `/'
+    The error is: <ZeroDivisionError> divided by 0
+
+    From: h.rb @ line 2 :
+
+        1: require 'hammertime19.'
+     => 2: 1 / 0
+
+    [1] pry(main)>
+
+    These types of errors cannot be recovered from, so when the pry session ends the program exits.
+
+    Hammertime19 doesn't know if the exception will be rescued, so therefore all exceptions that
+    are not explicitly raised will be intercepted in this way.
+
+    If you find that annoying, you can turn of this feature by calling:
+
+    Hammertime.intercept_native = false
+
 == Known Bugs
 
-* Hammertime cannot intercept exceptions which are raised from native code.
+* Hammertime19 cannot recover from errors that are raised from native code.
+* Hammertime19 cannot distinguish between native code exceptions that will be rescued and those that won't.
 
 == TODO
 
-* Better integration with IRB to enable a "Retry" option.
 * Tests
 
 == Dependencies

data/hammertime19.gemspec

@@ -2,10 +2,10 @@
 
 Gem::Specification.new do |s|
   s.name = "hammertime19"
-  s.version = "0.0.4"
+  s.version = "0.0.5"
 
   s.authors = ["Kalle Lindstrom"]
-  s.date = "2012-08-20"
+  s.date = "2012-08-22"
   s.description = "When this library is required, it replaces the default Ruby exception-raising\nbehavior.  When an error is raised, the developer is presented with a menu\nenabling them to ignore the error, view a stack trace, debug the error using IRB\nor ruby-debug, and more.\n"
   s.email = "lindstrom.kalle@gmail.com"
   s.extra_rdoc_files = [

data/lib/hammertime19.rb

@@ -1,9 +1,10 @@
 #encoding: utf-8
 
-# https://github.com/kl/hammertime
+# https://github.com/kl/hammertime19
 # Forked from https://github.com/avdi/hammertime
 # This fork works only with MRI 1.9.2+ and RBX
-# Adds support for starting a Pry session at the call site of the exception.
+# Adds support for starting a Pry session at the call site of the exception
+# and interception (not recovering from) non-raised exceptions.
 
 require 'thread'
 require 'highline'
@@ -11,6 +12,12 @@ require 'pry'
 require 'binding_of_caller'
 
 module Hammertime
+
+  class << self
+    attr_accessor :intercept_native
+  end
+  @intercept_native = true
+
   def self.ignored_errors
     @ignored_errors ||= [LoadError]
   end
@@ -163,6 +170,43 @@ module Hammertime
 
 end
 
+#
+# Modifies the Exception class so that all low level errors
+# (errors that are not explicitly raised) are intercepted
+# and a pry session is started at the error source location.
+# Note it is not (yet?) possible to recover from these
+# errors. After the pry session is over the program exits.
+#
+unless ::Object < Hammertime
+  class Exception
+
+    alias_method :exception_hammertime19_orig, :exception
+    def exception(*args, &block)
+      if ::Hammertime.intercept_native
+
+        # When binding.of_caller(1).pry is called several exceptions
+        # are raised but we only want to start a pry session on the
+        # first (original) exception.
+        # We also don't want to start a pry session if the exception
+        # originates from the hammertime library itself (for example
+        # when hammertime tries to require ruby-debug)  
+        unless caller.any? { |t| t.include?("pry/core_extensions.rb") || t.include?("hammertime_raise") }
+
+          puts "\n"
+          puts "=== Stop! Hammertime. ==="
+          puts "A C-level error has occurred at #{caller(2).first}"
+          puts "The error is: <#{self.class}> #{self.message}"
+
+          binding.of_caller(1).pry
+        end
+      end
+
+      # Call the original method
+      exception_hammertime19_orig(*args, &block)
+    end
+  end
+end
+
 unless ::Object < Hammertime
   class ::Object
     include ::Hammertime

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hammertime19
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-20 00:00:00.000000000 Z
+date: 2012-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: highline