rescuer 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cb1cf739c264df062124c8278d07ae5c5045b82c
+  data.tar.gz: 9202313bc83a069afc537d62a6c64074d969b8f0
+SHA512:
+  metadata.gz: e2092f82656031cce05dd6eee1a75d0b8c6a49fee76a649c2456528ab054ec910b8467bd3e42d3846a01d695358de487cfcbe44e370ff5347a60516bb0bcb235
+  data.tar.gz: 7d61b9f169eb50a91a2cdaf87a03d40b3ad3166ad2ff4a603e7d705eb3726410a590d10a62a5dbcc1ec60281479d928b7cf705233d0f03cb0103da59a7eb7673

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/.idea
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

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

data/.ruby-gemset

@@ -0,0 +1,2 @@
+rescuer
+

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.1.0

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+cache: bundler
+rvm:
+  - 2.1.0
+  - 2.0.0
+  - 1.9.3
+  - 1.9.2
+  - jruby-19mode
+  - rbx-2

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Marc Siegel
+
+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,8 @@
+# Rescuer
+[![Gem Version](https://badge.fury.io/rb/rescuer.png)](http://badge.fury.io/rb/rescuer)
+[![Build Status](https://travis-ci.org/ms-ati/rescuer.png)](https://travis-ci.org/ms-ati/rescuer)
+[![Dependency Status](https://gemnasium.com/ms-ati/rescuer.png)](https://gemnasium.com/ms-ati/rescuer)
+[![Code Climate](https://codeclimate.com/github/ms-ati/rescuer.png)](https://codeclimate.com/github/ms-ati/rescuer)
+[![Coverage Status](https://coveralls.io/repos/ms-ati/rescuer/badge.png)](https://coveralls.io/r/ms-ati/rescuer)
+
+A functional abstraction of rescuing exceptions inspired by Scala's Try class

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rake/clean'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+# Default task for `rake` is to run rspec
+task :default => [:spec]
+
+# Use default rspec rake task
+RSpec::Core::RakeTask.new
+
+# Configure `rake clobber` to delete all generated files
+CLOBBER.include('pkg', 'doc', 'coverage')
+
+# Only configure yard doc generation when *not* on Travis or JRuby
+if ENV['CI'] != 'true' && !(defined?(RUBY_ENGINE) && 'jruby' == RUBY_ENGINE)
+  require 'github/markup'
+  require 'redcarpet'
+  require 'yard'
+  require 'yard/rake/yardoc_task'
+
+  YARD::Rake::YardocTask.new do |t|
+    OTHER_PATHS = %w()
+    t.files   = ['lib/**/*.rb', OTHER_PATHS]
+    t.options = %w(--markup-provider=redcarpet --markup=markdown --main=README.md)
+  end
+end

data/lib/rescuer.rb

@@ -0,0 +1,16 @@
+require 'rescuer/version'
+
+module Rescuer
+	DEFAULT_EXCEPTIONS = [StandardError]
+
+  def new(*exceptions)
+    exceptions = DEFAULT_EXCEPTIONS if exceptions.nil? || exceptions.empty?
+    Success.new(yield)
+	rescue *exceptions => ex
+    Failure.new(ex)
+  end
+  module_function :new
+
+  Success = Struct.new(:value)
+  Failure = Struct.new(:cause)
+end

data/lib/rescuer/version.rb

@@ -0,0 +1,4 @@
+module Rescuer
+  # The current version of this gem
+  VERSION = '0.0.1'
+end

data/rescuer.gemspec

@@ -0,0 +1,35 @@
+$LOAD_PATH << File.expand_path('../lib', __FILE__)
+require 'rescuer/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'rescuer'
+  s.version     = Rescuer::VERSION
+  s.author      = 'Marc Siegel'
+  s.email       = 'msiegel@usainnov.com'
+  s.homepage    = 'http://ms-ati.github.com/rescuer/'
+  s.summary     = 'Rescuer rescues the composability of exception-raising code blocks'
+  s.description = 'Rescuer is a functional abstraction of exception handling inspired by Scala\'s Try class'
+  s.license     = 'MIT'
+
+  s.rubyforge_project = 'rescuer'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = %w(lib)
+
+  # Running rspec tests from rake
+  s.add_development_dependency 'rake',  '~> 10.3.0'
+  s.add_development_dependency 'rspec', '3.0.0.beta2'
+
+  if !(defined?(RUBY_ENGINE) && 'jruby' == RUBY_ENGINE)
+    # Github flavored markdown in YARD documentation
+    # http://blog.nikosd.com/2011/11/github-flavored-markdown-in-yard.html
+    s.add_development_dependency 'yard'
+    s.add_development_dependency 'redcarpet'
+    s.add_development_dependency 'github-markup'
+  end
+
+  # Coveralls test coverage tool
+  s.add_development_dependency 'coveralls'
+end

data/spec/rescuer_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+require 'rescuer'
+
+describe Rescuer do
+
+  describe '.new' do
+
+    context 'when block does *not* raise' do
+      subject { Rescuer.new { 1 + 1 } }
+      it { is_expected.to eq(Rescuer::Success.new(2)) }
+    end
+
+    context 'when block raises and no arguments' do
+      context 'when raise StandardError' do
+        let(:e) { StandardError.new('a standard error') }
+        subject { Rescuer.new { raise e } }
+        it { is_expected.to eq(Rescuer::Failure.new(e)) }
+      end
+
+      context 'when raise NoMemoryError' do
+        subject { lambda { Rescuer.new { raise NoMemoryError } } }
+        it { is_expected.to raise_error(NoMemoryError) }
+      end
+    end
+
+    context 'when block raises and Exception is an argument' do
+      context 'when raise NoMemoryError' do
+        let(:e) { NoMemoryError.new }
+        subject { Rescuer.new(Exception) { raise e } }
+        it { is_expected.to eq(Rescuer::Failure.new(e)) }
+      end
+    end
+
+    context 'when block raises and two subclasses of Exception are arguments' do
+      exceptions = [NoMemoryError, SyntaxError]
+
+      context 'when raise StandardError' do
+        subject { lambda { Rescuer.new(exceptions) { raise StandardError } } }
+        it { is_expected.to raise_error(StandardError) }
+      end
+
+      context 'when raise NoMemoryError' do
+        let(:e) { NoMemoryError.new }
+        subject { Rescuer.new(Exception) { raise e } }
+        it { is_expected.to eq(Rescuer::Failure.new(e)) }
+      end
+
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+require 'simplecov'
+require 'coveralls'
+
+# On Ruby 1.9+ use SimpleCov and publish to Coveralls.io
+if !RUBY_VERSION.start_with? '1.8'
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+  ]
+  SimpleCov.start do
+    add_filter '/spec/'    # exclude test code
+    add_filter '/vendor/'  # exclude gems which are vendored on Travis CI
+  end
+end
+
+lib_dir = File.join(File.dirname(File.dirname(__FILE__)), 'lib')
+$LOAD_PATH.unshift lib_dir unless $LOAD_PATH.include? lib_dir
+
+require 'rspec'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: rescuer
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Marc Siegel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.3.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: github-markup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Rescuer is a functional abstraction of exception handling inspired by
+  Scala's Try class
+email: msiegel@usainnov.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/rescuer.rb
+- lib/rescuer/version.rb
+- rescuer.gemspec
+- spec/rescuer_spec.rb
+- spec/spec_helper.rb
+homepage: http://ms-ati.github.com/rescuer/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: rescuer
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Rescuer rescues the composability of exception-raising code blocks
+test_files: []
+has_rdoc: