try_to 1.2 → 1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a53f923148d5b7feaca7c296d23166c2a3a2ba747345844f84f420c540c40431
-  data.tar.gz: 163a6c9c3b7e5432749715da57053952ca6ac79fe60b2fe40186597d566dfd3d
+  metadata.gz: 9ec1f34ec687f3663ab5210dac26e30f237399f274e1e449c4da8241bbafcf36
+  data.tar.gz: 9ac967b5be81ccaacf7736539d409c93b506157dc957016c4cd1426d4d445ee6
 SHA512:
-  metadata.gz: 41b63c7643991af44bfe7c44dc716d0b2d35954b827d38fca900243a9258fe93ffee331660ec53bfc69eda4bd266b7b614de7f80573cf25b6feb043384810d69
-  data.tar.gz: 332ecb1c745af1ff3b26eabf391d3546fae89e9997f0e820cb8a43b4b0c77135afb3e5c770283e9850334b8d1f745288a187b0babdb18aadf13c3f1f45df4440
+  metadata.gz: 8293b132f2a40f59c3d636a33c84025f7f177a25227c68602bfb300b69a2c66f3728aa9d7ac628d3e415edbf838e62048635e5d8dd72f83c44a8e3ba02005eba
+  data.tar.gz: 6d3516a4dbeb51cf8261bc611a8f347985bdcae00ae912c39a29b71c24de8a3eef519a411ab7af41fc2a386e35252da579a9c4545bf36d423334bd3d9827cf40

data/README.md

@@ -12,33 +12,49 @@ but allows for much more sophisticated error handling.
 
 Instead of using Rails' `Object#try` like this,
 
-    obj1.try(:met1).try(:met2).try(:met3).to_s
+```ruby
+obj.try(:met1).try(:met2).try(:met3).to_s
+```
 
 you can do this:
 
-    try_to { obj.met1.met2.met3.to_s }
+```ruby
+try_to { obj.met1.met2.met3.to_s }
+```
 
 ### Exceptions
 
+#### Adding exceptions
+
 It's possible to customize which exceptions to handle with `add_exception`:
 
-    TryTo.add_exception(ZeroDivisionError)
-    #=> [NoMethodError, ZeroDivisionError]
-    try_to { 1/0 } # will not raise an exception
+```ruby
+TryTo.add_exception(ZeroDivisionError)
+#=> [NoMethodError, ZeroDivisionError]
+try_to { 1/0 } # will not raise an exception
+```
+
+#### Removing exceptions
 
 To remove an exception, use `remove_exception!`:
 
-    TryTo.exceptions
-    #=> [NoMethodError, ZeroDivisionError]
-    TryTo.remove_exception!(ZeroDivisionError)
-    #=> [NoMethodError]
+```ruby
+TryTo.exceptions
+#=> [NoMethodError, ZeroDivisionError]
+TryTo.remove_exception!(ZeroDivisionError)
+#=> [NoMethodError]
+```
+
+#### Resetting exceptions
 
 You can also use `reset_exceptions!` to go back to only handle `NoMethodError`s.
 
-    TryTo.exceptions
-    #=> [NoMethodError, RuntimeError, ZeroDivisionError]
-    TryTo.reset_exceptions!
-    #=> [NoMethodError]
+```ruby
+TryTo.exceptions
+#=> [NoMethodError, RuntimeError, ZeroDivisionError]
+TryTo.reset_exceptions!
+#=> [NoMethodError]
+```
 
 ### Handlers
 
@@ -47,87 +63,103 @@ ways in which you can customize this behavior. All handlers can either be simple
 values or an object responding to `#call`, which should take one argument, the
 exception object.
 
-Specifying a handler with the call for one time use:
-
-    # use a handler function
-    try_to(-> e { puts e.class }) { 1.foo }
-    # prints "NoMethodError"
-    # or provide a simple value:
-    try_to(42) { 1.foo }
-    #=> 42
-
-Registering handlers so they always are used:
-
-    TryTo.handlers
-    #=> {}
-    TryTo.add_handler(ZeroDivisionError, -> _ { puts "Ouch" })
-    try_to { 1/0 }
-    # prints "Ouch"
-    TryTo.add_handler(NoMethodError, -> _ { 23 })
-    try_to { 1.foo }
-    #=> 23
-    # or simply
-    TryTo.add_handler(NoMethodError, 42)
-    try_to { 1.foo } #=> 42
-
-Removing handler:
+#### Specifying a handler inline:
+
+```ruby
+try_to(-> e { puts e.class }) { 1.foo }
+# prints "NoMethodError"
+# or provide a simple value:
+try_to(42) { 1.foo }
+#=> 42
+```
+
+#### Registering handlers for exception classes:
+
+```ruby
+TryTo.handlers
+#=> {}
+TryTo.add_handler(ZeroDivisionError, -> _ { puts "Ouch" })
+try_to { 1/0 }
+# prints "Ouch"
+TryTo.add_handler(NoMethodError, -> _ { 23 })
+try_to { 1.foo }
+#=> 23
+# or simply
+TryTo.add_handler(NoMethodError, 42)
+try_to { 1.foo } #=> 42
+```
+
+#### Removing handlers:
 
     TryTo.handlers
     #=> {ZeroDivisionError=>#<Proc:0x0000000108921d60@(irb):1 (lambda)>}
     TryTo.remove_handler!(ZeroDivisionError)
     #=> {}
 
-Last but not least you can define a default handler for all the exceptions
-listed in `TryTo.exceptions`.
-
-    TryTo.default_handler = 42
-    try_to { 1.foo } #=> 42
-    # or
-    TryTo.default_handler = lambda { |_| puts "Something went wrong!" }
-    try_to { 1.foo }
-    # Outputs: Something went wrong!
+#### Default handler
 
-Here's a complete example in the form of an IRB transcript:
-
-    # default behavior
-    try_to #=> nil
-    try_to {} #=> nil
-    class Foo ; end
-    try_to { Foo.new.foo } #=> nil
+This will be called for all the exceptions listed in `TryTo.exceptions`.
 
-    # this will raise an exception
-    try_to { 1 / 0 }
-    ZeroDivisionError: divided by 0
-    # let's fix that
-    TryTo.exceptions << ZeroDivisionError #=> [NoMethodError, ZeroDivisionError]
-    try_to { 1 / 0 } #=> nil
+```ruby
+TryTo.default_handler = 42
+try_to { 1.foo } #=> 42
+# or
+TryTo.default_handler = -> _e { puts "Something went wrong!" }
+try_to { 1.foo }
+# Outputs: Something went wrong!
+```
 
-    # change the default handler
-    TryTo.default_handler = -> e { puts e.class }
-    try_to { 1 / 0 } # prints "ZeroDivisionError"
-    try_to { Foo.new.foo } # prints "ZeroDivisionError"
+#### Example
 
-    # new behavior for ZeroDivisionError
-    TryTo.add_handler(ZeroDivisionError, -> _ { puts "You shouldn't divide by 0!"})
-    try_to { 1 / 0 } # prints: "You shouldn't divide by 0!"
-    try_to { Foo.new.foo} # still prints "NoMethodError"
+Here's a complete example in the form of an IRB transcript:
 
-    # change handler at call site
-    try_to(-> _ {puts "Ouch!"}) { Foo.new.foo } # prints "Ouch!"
+```ruby
+# default behavior
+try_to #=> nil
+try_to {} #=> nil
+Foo = Class.new
+try_to { Foo.new.foo } #=> nil (instead of NoMethodError)
+
+# this will raise an exception
+try_to { 1 / 0 }
+ZeroDivisionError: divided by 0
+# let's fix that
+TryTo.exceptions << ZeroDivisionError #=> [NoMethodError, ZeroDivisionError]
+try_to { 1 / 0 } #=> nil
+
+# change the default handler
+TryTo.default_handler = -> e { puts e.class }
+try_to { 1 / 0 } # prints "ZeroDivisionError"
+try_to { Foo.new.foo } # prints "ZeroDivisionError"
+
+# new behavior for ZeroDivisionError
+TryTo.add_handler(ZeroDivisionError, -> _ { puts "You shouldn't divide by 0!"})
+try_to { 1 / 0 } # prints: "You shouldn't divide by 0!"
+try_to { Foo.new.foo} # still prints "NoMethodError"
+
+# change handler at call site
+try_to(-> _ {puts "Ouch!"}) { Foo.new.foo } # prints "Ouch!"
+```
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'try_to'
+```ruby
+gem 'try_to'
+```
 
 And then execute:
 
-    $ bundle
+```shell
+$ bundle
+```
 
 Or install it yourself:
 
-    $ gem install try_to
+```shell
+$ gem install try_to
+```
 
 ## Authors
 

data/lib/try_to.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module TryTo
   @handlers = {}
   @exceptions = [NoMethodError]
@@ -34,9 +36,7 @@ module Kernel
   private def try_to(handler = nil)
     yield if block_given?
   rescue *(TryTo.exceptions | TryTo.handlers.keys) => e
-    handler = [handler,
-               TryTo.handlers[e.class],
-               TryTo.default_handler].compact.first
+    handler = handler || TryTo.handlers[e.class] || TryTo.default_handler
     handler.respond_to?(:call) ? handler.call(e) : handler
   end
 end

data/lib/try_to/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TryTo
-  VERSION = '1.2'.freeze
+  VERSION = '1.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: try_to
 version: !ruby/object:Gem::Version
-  version: '1.2'
+  version: '1.3'
 platform: ruby
 authors:
 - Michael Kohl
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-08 00:00:00.000000000 Z
+date: 2019-12-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -84,8 +84,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: An alternative approach to Rails' Object#try