try_to 1.1 → 1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: b265e05b456bcddae7647ac5108450bd176c8973
-  data.tar.gz: 1ffc1e94a179cb3aa60f91bdc91beaa5a5e43cc3
+SHA256:
+  metadata.gz: a53f923148d5b7feaca7c296d23166c2a3a2ba747345844f84f420c540c40431
+  data.tar.gz: 163a6c9c3b7e5432749715da57053952ca6ac79fe60b2fe40186597d566dfd3d
 SHA512:
-  metadata.gz: 02b58ac470c79cc489476f677362f2809679e723f434485a27bdc5936109502a0be7173789916241e6b3b5ddb8b0c25b51b3e0e47488430017c99c3f444a79bc
-  data.tar.gz: 8d796018c77b4c7147ecae7d08be9dc4473b77cb7ef7849c004dbdbca5cc4a5f16067d970048b63178b09b4d6dbd302b822eb6f3370eecbeb8ad0d8c48563b66
+  metadata.gz: 41b63c7643991af44bfe7c44dc716d0b2d35954b827d38fca900243a9258fe93ffee331660ec53bfc69eda4bd266b7b614de7f80573cf25b6feb043384810d69
+  data.tar.gz: 332ecb1c745af1ff3b26eabf391d3546fae89e9997f0e820cb8a43b4b0c77135afb3e5c770283e9850334b8d1f745288a187b0babdb18aadf13c3f1f45df4440

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2012 Michael Kohl & Sergey Gopkalo
+
+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

@@ -1,6 +1,14 @@
 # try_to
 
-This project started with a StackOverflow discussion between [Sergey Gopkalo](https://github.com/sevenmaxis/) and [Michael Kohl](https://github.com/citizen428), which eventually lead to a prototype at [sevenmaxis/tryit](https://github.com/sevenmaxis/tryit). `try_to` is an improved version based on the experience gained from that project, but allows for much more sophisticated error handling (in less than 30 lines of Ruby).
+[![Build Status](https://travis-ci.org/citizen428/try_to.svg)](https://travis-ci.org/citizen428/methodfinder)
+[![Gem Version](https://img.shields.io/gem/v/try_to.svg)](https://rubygems.org/gems/methodfinder)
+
+This project started with a StackOverflow discussion between [Sergey Gopkalo](https://github.com/sevenmaxis/) and [Michael Kohl](https://github.com/citizen428),
+which eventually lead to a prototype at [sevenmaxis/tryit](https://github.com/sevenmaxis/tryit).
+`try_to` is an improved version based on the experience gained from that project,
+but allows for much more sophisticated error handling.
+
+## Usage
 
 Instead of using Rails' `Object#try` like this,
 
@@ -10,38 +18,74 @@ you can do this:
 
     try_to { obj.met1.met2.met3.to_s }
 
-It's possible to customize which exceptions to handle:
+### Exceptions
+
+It's possible to customize which exceptions to handle with `add_exception`:
 
-    TryTo.exceptions << ZeroDivisionError
+    TryTo.add_exception(ZeroDivisionError)
+    #=> [NoMethodError, ZeroDivisionError]
     try_to { 1/0 } # will not raise an exception
 
-The default error handling strategy is to just return `nil`, but there are various ways 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:
+To remove an exception, use `remove_exception!`:
+
+    TryTo.exceptions
+    #=> [NoMethodError, ZeroDivisionError]
+    TryTo.remove_exception!(ZeroDivisionError)
+    #=> [NoMethodError]
+
+You can also use `reset_exceptions!` to go back to only handle `NoMethodError`s.
 
-First off you can specify a handler with the call:
+    TryTo.exceptions
+    #=> [NoMethodError, RuntimeError, ZeroDivisionError]
+    TryTo.reset_exceptions!
+    #=> [NoMethodError]
+
+### Handlers
+
+The default error handling strategy is to just return `nil`, but there are various
+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"
+    try_to(-> e { puts e.class }) { 1.foo }
+    # prints "NoMethodError"
     # or provide a simple value:
-    try_to(42) { 1.foo } #=> 42
+    try_to(42) { 1.foo }
+    #=> 42
 
-Alternatively you can define specific handlers for different exception classes:
+Registering handlers so they always are used:
 
-    TryTo.handlers #=> {}
+    TryTo.handlers
+    #=> {}
     TryTo.add_handler(ZeroDivisionError, -> _ { puts "Ouch" })
-    try_to { 1/0 } # prints "Ouch"
+    try_to { 1/0 }
+    # prints "Ouch"
     TryTo.add_handler(NoMethodError, -> _ { 23 })
-    try_to { 1.foo } #=> 23
+    try_to { 1.foo }
+    #=> 23
     # or simply
     TryTo.add_handler(NoMethodError, 42)
     try_to { 1.foo } #=> 42
 
- Last but not least you can define a default handler for all the exceptions listed in `TryTo.exceptions`.
+Removing handler:
+
+    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!
+    try_to { 1.foo }
+    # Outputs: Something went wrong!
 
 Here's a complete example in the form of an IRB transcript:
 
@@ -91,12 +135,12 @@ Or install it yourself:
 
 ## License
 
-Lincesend under the MIT license. See the provided LICENSE file for details.
+Licensed under the MIT license. See the provided LICENSE file for details.
 
 ## Contributing
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Added some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+1.  Fork it
+2.  Create your feature branch (`git checkout -b my-new-feature`)
+3.  Commit your changes (`git commit -am 'Added some feature'`)
+4.  Push to the branch (`git push origin my-new-feature`)
+5.  Create new Pull Request

data/lib/try_to.rb

@@ -1,19 +1,37 @@
 module TryTo
+  @handlers = {}
+  @exceptions = [NoMethodError]
+
   class << self
     attr_accessor :default_handler
     attr_reader :exceptions, :handlers
-  end
 
-  def self.add_handler(exception, handler)
-    @handlers.merge!(exception => handler)
-  end
+    def add_handler(exception, handler)
+      @handlers[exception] = handler
+      @handlers
+    end
 
-  @handlers = {}
-  @exceptions = [NoMethodError]
+    def remove_handler!(exception)
+      @handlers.delete(exception)
+      @handlers
+    end
+
+    def add_exception(exception)
+      @exceptions << exception
+    end
+
+    def remove_exception!(exception)
+      @exceptions -= [exception]
+    end
+
+    def reset_exceptions!
+      @exceptions = [NoMethodError]
+    end
+  end
 end
 
 module Kernel
-  def try_to(handler = nil)
+  private def try_to(handler = nil)
     yield if block_given?
   rescue *(TryTo.exceptions | TryTo.handlers.keys) => e
     handler = [handler,
@@ -21,6 +39,4 @@ module Kernel
                TryTo.default_handler].compact.first
     handler.respond_to?(:call) ? handler.call(e) : handler
   end
-
-  private :try_to
 end

data/lib/try_to/version.rb

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

metadata

@@ -1,43 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: try_to
 version: !ruby/object:Gem::Version
-  version: '1.1'
+  version: '1.2'
 platform: ruby
 authors:
 - Michael Kohl
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-17 00:00:00.000000000 Z
+date: 2018-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.16'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.9.0
+        version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.9.0
+        version: '10.0'
 description: Try methods without exceptions
 email:
 - citizen428@gmail.com
@@ -45,19 +59,16 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- Gemfile
-- LICENSE
+- LICENSE.txt
 - README.md
-- Rakefile
 - lib/try_to.rb
-- spec/spec_helper.rb
-- spec/try_to_spec.rb
-- try_to.gemspec
+- lib/try_to/version.rb
 homepage: https://github.com/citizen428/try_to
-licenses: []
-metadata: {}
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/citizen428/try_to/issues
+  source_code_uri: https://github.com/citizen428/try_to
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -74,11 +85,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: An alternative approach to Rails' Object#try
-test_files:
-- spec/spec_helper.rb
-- spec/try_to_spec.rb
-has_rdoc: 
+test_files: []

data/.gitignore

@@ -1,18 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-/*.gemspec~

data/.rspec

@@ -1,2 +0,0 @@
---color
---format progress

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in try_to.gemspec
-gemspec

data/LICENSE

@@ -1,22 +0,0 @@
-Copyright (c) 2012 Michael Kohl & Sergey Gopkalo
-
-MIT License
-
-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/Rakefile

@@ -1,37 +0,0 @@
-require 'rspec/core/rake_task'
-require 'fileutils'
-GEMSPEC = 'try_to.gemspec'
-
-task :default => :spec
-
-RSpec::Core::RakeTask.new do |t|
-  t.rspec_opts = '--format documentation'
-end
-
-def gemspec
-  @gemspec ||= eval(File.read(GEMSPEC), binding, GEMSPEC)
-end
-
-namespace :gem do
-  desc "Build the gem"
-  task :build => :generate_gemspec do
-    sh "gem build #{GEMSPEC}"
-    FileUtils.mkdir_p 'pkg'
-    FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", 'pkg'
-  end
-
-  desc "Install the gem locally (without docs)"
-  task :install => :build do
-    sh %{gem install pkg/#{gemspec.name}-#{gemspec.version} --no-rdoc --no-ri}
-  end
-
-  desc "Generate the gemspec"
-  task :generate_gemspec do
-    puts gemspec.to_ruby
-  end
-
-  desc "Validate the gemspec"
-  task :validate_gemspec do
-    gemspec.validate
-  end
-end

data/spec/spec_helper.rb

@@ -1,14 +0,0 @@
-# This file was generated by the `rspec --init` command. Conventionally, all
-# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
-# Require this file using `require "spec_helper.rb"` to ensure that it is only
-# loaded once.
-#
-# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
-
-require_relative "../lib/try_to"
-
-RSpec.configure do |config|
-  config.treat_symbols_as_metadata_keys_with_true_values = true
-  config.run_all_when_everything_filtered = true
-  config.filter_run :focus
-end

data/spec/try_to_spec.rb

@@ -1,76 +0,0 @@
-require 'spec_helper'
-
-describe Kernel do
-  describe "#try_to" do
-    let(:obj) { Object.new }
-
-    context "default behavior" do
-      it "returns nil when no block is provided" do
-        try_to.should be_nil
-      end
-
-      it "returns nil when an empty block is provided" do
-        try_to{}.should be_nil
-      end
-
-      it "doesn't catch unspecified exceptions" do
-        class A; def foo; raise "test exception" end end
-        expect do
-          try_to { A.new.foo }
-        end.to raise_error(RuntimeError, "test exception")
-      end
-
-      it "handles specified exceptions by returning nil" do
-        result = nil
-        expect{ result = try_to{ obj.foo } }.to_not raise_error(NoMethodError)
-        result.should be_nil
-      end
-
-      it "handles chained calls" do
-        def obj.foo; self end
-        def obj.boo; "boo" end
-        try_to{ obj.foo.boo }.should == 'boo'
-      end
-
-      it "doesn't raise exceptions in chain calls" do
-        def obj.foo; self end
-        def obj.koo; self end
-        expect{ try_to{ obj.foo.koo.too }}.to_not raise_error(NoMethodError)
-        expect{ try_to{ obj.foo.too.koo }}.to_not raise_error(NoMethodError)
-      end
-
-      it "can add exceptions at runtime" do
-        expect do
-          try_to { 1/0 }
-        end.to raise_error(ZeroDivisionError)
-
-        TryTo.exceptions << ZeroDivisionError
-
-        expect do
-          try_to { 1/0 }
-        end.to_not raise_error(ZeroDivisionError)
-      end
-
-    end
-
-    context "handlers" do
-      it "uses a default handler" do
-        TryTo.default_handler = -> e { e.class }
-        try_to{obj.foo}.should == NoMethodError
-      end
-
-      it "uses exception class specific handlers" do
-        TryTo.handlers[TypeError] = lambda { |e| puts e }
-        $stdout.should_receive(:puts)
-        try_to { raise TypeError }
-      end
-
-      it "can specify a handler on the fly" do
-        try_to(42) do
-          obj.foo
-        end.should == 42
-      end
-    end
-  end
-
-end

data/try_to.gemspec

@@ -1,18 +0,0 @@
-# -*- encoding: utf-8 -*-
-Gem::Specification.new do |gem|
-  gem.authors       = ['Michael Kohl']
-  gem.email         = ['citizen428@gmail.com']
-  gem.description   = %q{Try methods without exceptions}
-  gem.summary       = %q{An alternative approach to Rails' Object#try}
-  gem.homepage      = 'https://github.com/citizen428/try_to'
-
-  gem.files         = `git ls-files`.split($\)
-  gem.executables   = gem.files.grep(%r{^bin/}).map { |f| File.basename(f) }
-  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
-  gem.name          = 'try_to'
-  gem.require_paths = ['lib']
-  gem.version       = '1.1'
-
-  gem.add_development_dependency 'rake'
-  gem.add_development_dependency 'rspec', '~>2.9.0'
-end