try 0.3.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 709e480aa70f8f56410a63ec46009b96803e116b
-  data.tar.gz: b16217ce61a1bdc4eb589e632297ac4a29d414ba
+  metadata.gz: 59d052acdfe93469250ccd32f028f0909d22ebc3
+  data.tar.gz: 8af0c816b218d044e8f50fff90195b1c77e0189d
 SHA512:
-  metadata.gz: c4225e05e4cbf52002cfc805cf6ad792366a748d0ca627f72b6cd49a41324ab371146d553f783d4cc80a23bc45de60487f7cc2e3336b1aee4861e3dc62def597
-  data.tar.gz: c3d7923acfc692c72dde29c0e250d1b9f5eb838530c2a23783ebc10e9286a66c5e42d72614f30d3b95a0e6c813853b145b04eb13cf81b3e233290b843c37da43
+  metadata.gz: b87930d9e447137c7f0b324f063369ba6e2b5d06b499e31dac4a1550945e5edbc2617b8c920b1f6890adbc3530ca54e4df7c5b025efdfaba19cef6847351b605
+  data.tar.gz: a6058c19afd7279d899d7274fff0574da95c301488fd0b629a66d246058ca84f84c718f750f399a4534b56e930e22eeb52524363c7572ce111b6b2d48b18dc03

data/lib/try.rb

@@ -1,4 +1,20 @@
+=begin
+A module that attempts to provide some of the expressive power offered
+by MOO Code through the following  language constructs:
 
+  `unsafe_expression ! ANY'
+  `unsafe_expression ! ANY => fallback_expression'
+  `unsafe_expression ! E_FOO, E_BAR'
+  `unsafe_expression ! E_FOO, E_BAR => fallback_expression'
+
+In Ruby these become:
+
+  Try.try { unsafe_expression }
+  Try.trap(Exception=>fallback) { unsafe_expression }  # OR: unsafe_expression rescue fallback
+  Try.trap(FooError, BarError) { unsafe_expression}
+  Try.trap(FooError=>fallback, BarError=>fallback) { unsafe_expression }
+
+=end
 module Try
   #
   # Evaluates the given block and returns its value.
@@ -17,7 +33,9 @@ module Try
   # parameters.
   #
   # Additionally, specific exception types can default to a fallback
-  # value if passed as (({Type => value})) pairs.
+  # value if passed as (({Type => value})) pairs.  If the +value+ is
+  # a Proc, it is called and the exception object is passed as a
+  # parameter.
   #
   # Any un-trapped exception is raised normally.
   #
@@ -33,7 +51,7 @@ module Try
       return ex if klass.instance_of?(Module) ? ex.kind_of?(klass) : ex.is_a?(klass)
     end
     hash.each_pair do |klass,value|
-      return value if klass.instance_of?(Module) ? ex.kind_of?(klass) : ex.is_a?(klass)
+      return value.is_a?(Proc) ? value.call(ex) : value if klass.instance_of?(Module) ? ex.kind_of?(klass) : ex.is_a?(klass)
     end
     raise
   end
@@ -60,3 +78,27 @@ module Try
   extend self
 end
 
+=begin
+Copyright (c) 2013, Matthew Kerwin
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met: 
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer. 
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution. 
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+=end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: try
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Matthew Kerwin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-11 00:00:00.000000000 Z
+date: 2013-03-21 00:00:00.000000000 Z
 dependencies: []
 description: Lazy mechanisms to capture exceptions on-the-fly.
 email: matthew@kerwin.net.au