squash_ruby 1.1.1 → 1.2.0

data/lib/squash/ruby.rb

@@ -152,6 +152,7 @@ module Squash
     #   ignore. If not provided, ignores all exceptions raised in the block.
     # @yield The code to ignore exceptions in.
     # @return The result of the block.
+    # @raise [ArgumentError] If no block is provided.
 
     def self.ignore_exceptions(exception_classes=nil)
       raise ArgumentError, "Squash::Ruby.ignore_exceptions must be called with a block" unless block_given?
@@ -185,6 +186,48 @@ module Squash
       end
     end
 
+    # @overload fail_silently(exception_classes=nil, options={})
+    #   Executes the block, suppressing and silently reporting any exceptions to
+    #   Squash. This allows you to ensure that a non-critical block of code
+    #   does not halt your application while still receiving exception
+    #   notifications in Squash.
+    #   @param [Array<Class>] exception_classes A list of exception classes to
+    #     report silently. Exceptions _not_ of these classes (or their
+    #     subclasses) will raise (and presumably be handled by Squash elsewhere
+    #     in your code).
+    #   @param [Hash] options Additional options to pass to {.notify}.
+    #   @yield The code to suppress exceptions in.
+    #   @return The result of the block.
+    # @raise [ArgumentError] If no block is provided.
+
+    def self.fail_silently(exception_classes_or_options=nil, options=nil)
+      raise ArgumentError, "Squash::Ruby.exception_classes must be called with a block" unless block_given?
+
+      exception_classes = if options
+                            exception_classes_or_options
+                          else
+                            if exception_classes_or_options.kind_of?(Hash) then
+                              options = exception_classes_or_options
+                              nil
+                            else
+                              exception_classes_or_options
+                            end
+                          end
+      options           ||= {}
+
+      exception_classes = [exception_classes] if exception_classes.kind_of?(Class)
+
+      begin
+        yield
+      rescue Object => err
+        if exception_classes.nil? || exception_classes.detect { |e| err.kind_of?(e) }
+          Squash::Ruby.notify err, options
+        else
+          raise
+        end
+      end
+    end
+
     # Sets configuration options for the client from a hash. See the README for
     # a list of configuration options. Subsequent calls will merge in new
     # configuration options.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: squash_ruby
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 31
   prerelease: 
   segments: 
   - 1
-  - 1
-  - 1
-  version: 1.1.1
+  - 2
+  - 0
+  version: 1.2.0
 platform: ruby
 authors: 
 - Tim Morgan
@@ -15,10 +15,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-03-19 00:00:00 Z
+date: 2013-04-23 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  type: :runtime
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -27,12 +28,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  version_requirements: *id001
-  name: json
+  requirement: *id001
   prerelease: false
-  type: :runtime
+  name: json
 - !ruby/object:Gem::Dependency 
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  type: :development
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -41,12 +42,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  version_requirements: *id002
-  name: rspec
+  requirement: *id002
   prerelease: false
-  type: :development
+  name: rspec
 - !ruby/object:Gem::Dependency 
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  type: :development
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -55,12 +56,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  version_requirements: *id003
-  name: fakefs
+  requirement: *id003
   prerelease: false
-  type: :development
+  name: fakefs
 - !ruby/object:Gem::Dependency 
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  type: :development
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -69,12 +70,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  version_requirements: *id004
-  name: yard
+  requirement: *id004
   prerelease: false
-  type: :development
+  name: yard
 - !ruby/object:Gem::Dependency 
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  type: :development
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -83,12 +84,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  version_requirements: *id005
-  name: redcarpet
+  requirement: *id005
   prerelease: false
-  type: :development
+  name: redcarpet
 - !ruby/object:Gem::Dependency 
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  type: :development
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -97,10 +98,9 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  version_requirements: *id006
-  name: jeweler
+  requirement: *id006
   prerelease: false
-  type: :development
+  name: jeweler
 description: This client library records Ruby exceptions to Squash.
 email: tim@squareup.com
 executables: []