Tagful

Tagging your exception.

based on: Exceptional Ruby: Master the art of handling failure in Ruby

Installation

Add this line to your application's Gemfile:

gem 'tagful'

And then execute:

$ bundle

Or install it yourself as:

$ gem install tagful

Usage

Tagging your exception with tagful

class Person
  include Tagful

  # Ruby 2.1 or later
  tagful\
  def hello
    raise 'hello'
  end

  # Ruby 2.0
  def hello
    raise 'hello'
  end
  tagful :hello
end

begin
  Person.new.hello
rescue Person::Error => e
  puts e.message
end
# hello

You can specify your error module by tagful_with:

class Robot
  include Tagful

  module Broken; end

  tagful_with Broken

  tagful\
  def initialize
    raise ':('
  end
end

begin
  Robot.new
rescue Robot::Broken => e
  puts e.message
end
# :(

or pass your error module to tagful:

class Person
  include Tagful

  module NoManner; end

  def eat
    raise 'burps'
  end
  tagful :eat, NoManner
end

begin
  Person.new.eat
rescue Person::NoManner => e
  puts e.message
end
# burps

You can use Class instead of Module:

class Pizza
  include Tagful

  class NotFound < ArgumentError
    def self.exception(message = nil)
      super("not found: #{message}")
    end
  end

  def take_cheese!
    raise 'cheese'
  end
  tagful :take_cheese!, NotFound
end

begin
  Pizza.new.take_cheese!
rescue Pizza::NotFound => e
  puts e.message
end
# not found: cheese

Contributing

Fork it ( https://github.com/hanachin/tagful/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

tagful

Development

Tagful

Installation

Usage

Contributing