interception 0.1.pre.2 → 0.1

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,85 @@
+
+Interception (intercept + exception) allows you to intercept all exceptions as they are
+raised.
+
+Installation
+============
+
+As with all rubygems, use gem to install:
+
+```shell
+gem install interception
+```
+
+Or, if you're using bundler:
+
+```ruby
+source :rubygems
+gem 'interception'
+```
+
+Usage
+=====
+
+Add and remove listeners. They'll be called whenever an exception is raised (whether or
+not it would later be rescued) with both the exception object, and the binding from which
+it was raised. The binding can be used to discover further information about the context.
+
+```ruby
+require 'interception'
+listener = lambda{ |exception, binding|
+  puts "raised: #{exception.inspect}"
+}
+
+Interception.listen(listener)
+
+begin
+  raise "oopsy"
+rescue => exception
+  puts "rescued: #{exception.inspect}"
+end
+
+raise "daisy"
+
+Interception.unlisten(listener)
+```
+
+In the common case that you want to listen to events for the duration of a block, you can
+also pass that block to listen:
+
+```ruby
+require 'interception'
+def log_exceptions(&block)
+  Interception.listen(block) do |exception, binding|
+    puts "raised: #{exception.inspect} from #{binding.eval("__method__")}"
+  end
+end
+
+def hello
+  raise "oopsy"
+rescue => exception
+  puts "rescued: #{exception.inspect} in #{__method__}"
+  raise "daisy"
+end
+
+log_exceptions do
+  hello
+end
+```
+
+Your listen block is run as through it were called by `Kernel#raise`, so try not to raise
+an exception from within it, or you will loose the original exception.
+
+Known bugs
+==========
+
+* On rubinius we don't catch some low-level exceptions (like `ZeroDivisionError`).
+* On jruby, the binding sometimes has the wrong value for `self` (in `NoMethodError`s).
+* On MRI-1.8.7, the binding sometimes has the wrong value for `self`.
+* No known bugs on MRI-1.9.3
+
+Meta-fu
+=======
+
+Interception is released under the MIT license (see `LICENSE.MIT` for details).
+Contributions and bug reports are welcome.

data/examples/example.rb

@@ -1,21 +1,16 @@
-$:.unshift File.expand_path '../../lib', __FILE__
-require 'pryception'
+require 'interception'
+listener = lambda{ |exception, binding|
+  puts "raised: #{exception.inspect}"
+}
 
-Interception.prycept do
+Interception.listen(listener)
 
-  def a
-    begin
-      begin
-        raise "foo"
-
-      rescue => e
-        raise "bar"
-      end
+begin
+  raise "oopsy"
+rescue => exception
+  puts "rescued: #{exception.inspect}"
+end
 
-    rescue => e
-      1 / 0
+raise "daisy"
 
-    end
-  end
-  a
-end
+Interception.unlisten(listener)

data/examples/example2.rb

@@ -1,20 +1,17 @@
-$:.unshift File.expand_path '../../lib', __FILE__
-require 'pryception'
-
-def alpha
-  x = 1
-  beta
-end
-
-def beta
-  y = 30
-  gamma(1, 2)
+require 'interception'
+def log_exceptions(&block)
+  Interception.listen(block) do |exception, binding|
+    puts "raised: #{exception.inspect} from #{binding.eval("__method__")}"
+  end
 end
 
-def gamma(x)
-  greeting = x
+def hello
+  raise "oopsy"
+rescue => exception
+  puts "rescued: #{exception.inspect} in #{__method__}"
+  raise "daisy"
 end
 
-Interception.prycept do
-  alpha
+log_exceptions do
+  hello
 end

data/ext/org/pryrepl/InterceptionEventHook.java

@@ -13,12 +13,11 @@ public class InterceptionEventHook extends EventHook {
     private RubyProc proc;
 
     public InterceptionEventHook(RubyProc proc) {
-        super();
         this.proc = proc;
     }
 
     public boolean isInterestedInEvent(RubyEvent event) {
-        return event.getName().equals(RubyEvent.RAISE.getName());
+        return event == RubyEvent.RAISE;
     }
 
     public void eventHandler(ThreadContext context, String eventName, String file, int line, String name, IRubyObject type) {

data/interception.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name = "interception"
-  s.version = "0.1.pre.2"
+  s.version = "0.1"
   s.author = "Conrad Irwin"
   s.email = "conrad.irwin@gmail.com"
   s.homepage = "http://github.com/ConradIrwin/interception"

metadata

@@ -1,48 +1,63 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: interception
-version: !ruby/object:Gem::Version
-  prerelease: 4
-  version: 0.1.pre.2
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
 platform: ruby
-authors:
+authors: 
 - Conrad Irwin
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-11 00:00:00.000000000Z
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2012-08-12 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: rake
-  version_requirements: &2056 !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  requirement: *2056
   prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
   type: :development
-- !ruby/object:Gem::Dependency
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
   name: rspec
-  version_requirements: &2074 !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  requirement: *2074
   prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
   type: :development
+  version_requirements: *id002
 description: Provides a cross-platform ability to intercept all exceptions as they are raised.
 email: conrad.irwin@gmail.com
 executables: []
-extensions:
+
+extensions: 
 - ext/extconf.rb
 extra_rdoc_files: []
-files:
+
+files: 
 - .gitignore
 - .travis.yml
 - Gemfile
+- LICENSE.MIT
+- README.md
 - Rakefile
 - examples/example.rb
 - examples/example2.rb
@@ -52,33 +67,41 @@ files:
 - interception.gemspec
 - lib/cross_platform.rb
 - lib/interception.rb
-- lib/pryception.rb
-- pryly.rb
 - spec/interception_spec.rb
 - spec/spec_helpers.rb
 homepage: http://github.com/ConradIrwin/interception
 licenses: []
-post_install_message:
+
+post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-required_rubygems_version: !ruby/object:Gem::Requirement
-  requirements:
-  - - ! '>'
-    - !ruby/object:Gem::Version
-      version: 1.3.1
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
-rubyforge_project:
-rubygems_version: 1.8.15
-signing_key:
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
 specification_version: 3
 summary: Intercept exceptions as they are being raised
 test_files: []
-...
+
+has_rdoc: 

data/lib/pryception.rb

@@ -1,66 +0,0 @@
-require 'rubygems'
-require 'interception'
-require 'pry'
-
-begin
-  require 'pry-stack_explorer'
-rescue LoadError
-end
-
-module Interception
-
-  class << self
-
-    # Intercept all exceptions that arise in the block and start a Pry session
-    # at the fail site.
-    def prycept(&block)
-      raised = []
-
-      Interception.listen(block) do |exception, binding|
-        if defined?(PryStackExplorer)
-          raised << [exception, binding.callers]
-        else
-          raised << [exception, Array(binding)]
-        end
-      end
-
-    ensure
-      if raised.any?
-        exception, bindings = raised.last
-        enter_exception_context(exception, bindings)
-      end
-    end
-
-    private
-
-    # Sanitize the call stack.
-    # @param [Array<Binding>] bindings The call stack.
-    def prune_call_stack!(bindings)
-      bindings.delete_if { |b| b.eval("self") == self || b.eval("__method__") == :prycept }
-    end
-
-    # 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(exception, bindings)
-      inject_local("_ex_", exception, bindings.first)
-      inject_local("_raised_", [exception, bindings.first], bindings.first)
-
-      prune_call_stack!(bindings)
-      if defined?(PryStackExplorer)
-        pry :call_stack => bindings
-      else
-        bindings.first.pry
-      end
-    end
-
-    # Inject a local variable into a binding.
-    def inject_local(var, object, binding)
-      Thread.current[:__intercept_var__] = object
-      binding.eval("#{var} = Thread.current[:__intercept_var__]")
-    ensure
-      Thread.current[:__intercept_var__] = nil
-    end
-  end
-end
-

data/pryly.rb

@@ -1,41 +0,0 @@
-require 'rubygems'
-require 'interception'
-require 'pry'
-require 'pry-stack_explorer'
-def pryly(&block)
-  raised = []
-
-  Interception.listen(block) do |exception, binding|
-    raised << [exception, binding.callers]
-  end
-
-ensure
-  if raised.last
-    e, bindings = raised.last
-    $foo = e
-    $bar = raised
-    bindings.first.eval("_ex_ = $foo")
-    bindings.first.eval("_raised_ = $bar")
-    bindings = bindings.drop_while { |b| b.eval("self") == Interception || b.eval("__method__") == :pryly }
-    pry :call_stack => bindings
-  end
-end
-
-pryly do
-
-  def a
-    begin
-      begin
-        raise "foo"
-
-      rescue => e
-        raise "bar"
-      end
-
-    rescue => e
-      1 / 0
-
-    end
-  end
-  a
-end