normatron 0.3.1 → 0.3.2

data/lib/normatron/filters/titleize_filter.rb

@@ -2,25 +2,31 @@ require 'normatron/filters/helpers'
 
 module Normatron
   module Filters
+    
+    ##
+    # Capitalizes the first character of each word.
+    # 
+    # @example Out of box
+    #   TitleizeFilter.evaluate("at your will!") #=> "At Your Will!"
+    #
+    # @example Using as ActiveRecord::Base normalizer
+    #   normalize :attribute_a, :with => :titleize
+    #   normalize :attribute_b, :with => [:custom_filter, :titleize]
+    #
+    # @see http://api.rubyonrails.org/classes/ActiveSupport/Multibyte/Chars.html#method-i-titleize ActiveSupport::Multibyte::Chars#titleize
+    # @see DownFilter     Normatron::Filters::DownFilter
+    # @see SwapcaseFilter Normatron::Filters::SwapcaseFilter
+    # @see UpcaseFilter   Normatron::Filters::UpcaseFilter
     module TitleizeFilter
       extend Helpers
 
       ##
-      # Capitalizes the first character of each word.
-      # 
-      # @example
-      #   TitleizeFilter.evaluate("at your will!") #=> "At Your Will!"
+      # Performs input conversion according to filter requirements.
       #
-      # @example Using as ActiveRecord::Base normalizer
-      #   normalize :attribute_a, :with => :titleize
-      #   normalize :attribute_b, :with => [:custom_filter, :titleize]
+      # This method returns the object itself when the first argument is not a String.
       #
-      # @param [String] input A character sequence
-      # @return [String] The titleized character sequence or the object itself
-      # @see http://api.rubyonrails.org/classes/ActiveSupport/Multibyte/Chars.html#method-i-titleize ActiveSupport::Multibyte::Chars#titleize
-      # @see DownFilter Normatron::Filters::DownFilter
-      # @see SwapcaseFilter Normatron::Filters::SwapcaseFilter
-      # @see UpcaseFilter Normatron::Filters::UpcaseFilter
+      # @param input [String] The String to be filtered
+      # @return [String] A new titleized String
       def self.evaluate(input)
         input.kind_of?(String) ? mb_send(:titleize, input) : input
       end

data/lib/normatron/filters/underscore_filter.rb

@@ -2,34 +2,40 @@ require 'normatron/filters/helpers'
 
 module Normatron
   module Filters
+    
+    ##
+    # Makes an underscored lowercase form from the expression in the string.
+    #
+    # Changes ‘::’ to ‘/’ to convert namespaces to paths.
+    #
+    # As a rule of thumb you can think of underscore as the inverse of camelize, though there are cases where that does
+    # not hold:
+    #
+    #   "SSLError".underscore.camelize # => "SslError"
+    # 
+    # @example Out of box
+    #   UnderscoreFilter.evaluate("ActiveRecord::Errors") #=> "active_record/errors"
+    #
+    # @example Using as ActiveRecord::Base normalizer
+    #   normalize :attribute_a, :with => :underscore
+    #   normalize :attribute_b, :with => [:custom_filter, :underscore]
+    #   normalize :attribute_c, :with => [[:underscore, :lower]]
+    #   normalize :attribute_d, :with => [{:underscore => :lower}]
+    #   normalize :attribute_e, :with => [:custom_filter, [:underscore, :lower]]
+    #   normalize :attribute_f, :with => [:custom_filter, {:underscore => :lower}]
+    #
+    # @see http://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-underscore ActiveSupport::Inflector#underscore
+    # @see CamelizeFilter Normatron::Filters::CamelizeFilter
     module UnderscoreFilter
       extend Helpers
 
       ##
-      # Makes an underscored, lowercase form from the expression in the string.
+      # Performs input conversion according to filter requirements.
       #
-      # Changes ‘::’ to ‘/’ to convert namespaces to paths.
+      # This method returns the object itself when the first argument is not a String.
       #
-      # As a rule of thumb you can think of underscore as the inverse of camelize, though there are cases where that does not hold:
-      #   "SSLError".underscore.camelize # => "SslError"
-      # 
-      # @example
-      #   UnderscoreFilter.evaluate("ActiveRecord::Errors") #=> "active_record/errors"
-      #
-      # @example Using as ActiveRecord::Base normalizer
-      #   normalize :attribute_a, :with => :underscore
-      #   normalize :attribute_b, :with => [:custom_filter, :underscore]
-      #   normalize :attribute_c, :with => [[:underscore, :lower]]
-      #   normalize :attribute_d, :with => [{:underscore => :lower}]
-      #   normalize :attribute_e, :with => [:custom_filter, [:underscore, :lower]]
-      #   normalize :attribute_f, :with => [:custom_filter, {:underscore => :lower}]
-      #
-      # @param [String] input A character sequence
-      # @return [String] The underscored character sequence or the object itself
-      # @see http://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-underscore ActiveSupport::Inflector#underscore
-      # @see CamelizeFilter Normatron::Filters::CamelizeFilter
-      # @todo Performance tests
-      # @todo Exception class
+      # @param input [String] The String to be filtered
+      # @return [String] A new underscored String
       def self.evaluate(input)
         return input unless input.kind_of?(String)
 

data/lib/normatron/filters/upcase_filter.rb

@@ -2,25 +2,31 @@ require 'normatron/filters/helpers'
 
 module Normatron
   module Filters
+    
+    ##
+    # Uppercase all characters.
+    # 
+    # @example Out of box
+    #   UpcaseFilter.evaluate("borderlands") #=> "BORDERLANDS"
+    #
+    # @example Using as ActiveRecord::Base normalizer
+    #   normalize :attribute_a, :with => :upcase
+    #   normalize :attribute_b, :with => [:custom_filter, :upcase]
+    #
+    # @see http://api.rubyonrails.org/classes/ActiveSupport/Multibyte/Chars.html#method-i-upcase ActiveSupport::Multibyte::Chars#upcase
+    # @see DownFilter     Normatron::Filters::DownFilter
+    # @see TitleizeFilter Normatron::Filters::TitleizeFilter
+    # @see SwapcaseFilter Normatron::Filters::SwapcaseFilter
     module UpcaseFilter
       extend Helpers
 
       ##
-      # Uppercase all characters.
-      # 
-      # @example
-      #   UpcaseFilter.evaluate("borderlands") #=> "BORDERLANDS"
+      # Performs input conversion according to filter requirements.
       #
-      # @example Using as ActiveRecord::Base normalizer
-      #   normalize :attribute_a, :with => :upcase
-      #   normalize :attribute_b, :with => [:custom_filter, :upcase]
+      # This method returns the object itself when the first argument is not a String.
       #
-      # @param [String] input A character sequence
-      # @return [String] The uppercased character sequence or the object itself
-      # @see http://api.rubyonrails.org/classes/ActiveSupport/Multibyte/Chars.html#method-i-upcase ActiveSupport::Multibyte::Chars#upcase
-      # @see DownFilter Normatron::Filters::DownFilter
-      # @see TitleizeFilter Normatron::Filters::TitleizeFilter
-      # @see SwapcaseFilter Normatron::Filters::SwapcaseFilter
+      # @param input [String] The String to be filtered
+      # @return [String] A new uppercased String
       def self.evaluate(input)
         input.kind_of?(String) ? mb_send(:upcase, input) : input
       end

data/lib/normatron/version.rb

@@ -1,3 +1,3 @@
 module Normatron
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

data/spec/normatron/configuration_spec.rb

@@ -1,5 +1,4 @@
 require 'spec_helper'
-require 'normatron/configuration'
 
 describe Normatron::Configuration do
 

data/spec/normatron/extensions/active_record_spec.rb

@@ -15,6 +15,7 @@ describe Normatron::Extensions::ActiveRecord do
     ActiveRecord.send(:remove_const, :Base)
     load 'active_record/base.rb'
   end
+  pending "'after' is causing a problem to test configuration file --seed 52000"
 
   describe :normalize do
     subject { model }

data/spec/normatron/filters/ascii_filter_spec.rb

@@ -1,14 +1,20 @@
 # encoding: UTF-8
 
 require 'spec_helper'
-require 'normatron/filters/ascii_filter'
 
-describe Normatron::Filters::AsciiFilter do
-  it_should_behave_like "string processor"
-  it_should_behave_like "evaluable filter", ["ÉBRIO"              ], "EBRIO"
-  it_should_behave_like "evaluable filter", ["até"                ], "ate"
-  it_should_behave_like "evaluable filter", ["cirurgião"          ], "cirurgiao"
-  it_should_behave_like "evaluable filter", ["email@domain.com"   ], "email@domain.com"
-  it_should_behave_like "evaluable filter", ["éçü&! *¬¬"          ], "ecu&! *!!"
-  it_should_behave_like "evaluable filter", ["⠋⠗⠁⠝⠉⠑"          ], "france"
+module Normatron
+  module Filters
+    describe AsciiFilter do
+      it { should evaluate("ÉBRIO"           ).to("EBRIO"           ) }
+      it { should evaluate("até"             ).to("ate"             ) }
+      it { should evaluate("cirurgião"       ).to("cirurgiao"       ) }
+      it { should evaluate("email@domain.com").to("email@domain.com") }
+      it { should evaluate("éçü&! *¬¬"       ).to("ecu&! *!!"       ) }
+      it { should evaluate("⠋⠗⠁⠝⠉⠑"       ).to("france"          ) }
+      it { should evaluate(100               ).to(100               ) }
+      it { should evaluate(nil               ).to(nil               ) }
+
+      pending "Open a pull request to Stringex.\n'¬' (not sign) character is not evaluating as expected (minus sign or tilde)."
+    end
+  end
 end

data/spec/normatron/filters/blank_filter_spec.rb

@@ -1,15 +1,14 @@
 require 'spec_helper'
-require 'normatron/filters/blank_filter'
 
-describe Normatron::Filters::BlankFilter do
-  it_should_behave_like "string processor"
-  it_should_behave_like "evaluable filter", ["18pm"], "18pm"
-
-  describe :blank do
-    let(:word) { "phase" }
-    it { subject.send(:evaluate, "           ").should be_nil }
-    it { subject.send(:evaluate, "\n \t \r \f").should be_nil }
-    it { subject.send(:evaluate, "\n\t\r\f"   ).should be_nil }
-    it { subject.send(:evaluate, word         ).should equal word }
+module Normatron
+  module Filters
+    describe BlankFilter do
+      it { subject.send(:evaluate, "           ").should be_nil      }
+      it { subject.send(:evaluate, "\n \t \r \f").should be_nil      }
+      it { subject.send(:evaluate, "\n\t\r\f"   ).should be_nil      }
+      it { subject.send(:evaluate, "phase"      ).should eq("phase") }
+      it { subject.send(:evaluate, 100          ).should eq(100)     }
+      it { subject.send(:evaluate, nil          ).should be_nil      }
+    end
   end
 end

data/spec/normatron/filters/camelize_filter_spec.rb

@@ -3,40 +3,101 @@
 require 'spec_helper'
 require 'normatron/filters/camelize_filter'
 
-describe Normatron::Filters::CamelizeFilter do
-  it_should_behave_like "string processor"
-  it_should_behave_like "evaluable filter", ["active_record/errors"                    ], "ActiveRecord::Errors"
-  it_should_behave_like "evaluable filter", ["active_record/errors", :upper            ], "ActiveRecord::Errors"
-  it_should_behave_like "evaluable filter", ["active_record/errors", :lower            ], "activeRecord::Errors"
-  it_should_behave_like "evaluable filter", ["dados_históricos/período/empresa"        ], "DadosHistóricos::Período::Empresa"
-  it_should_behave_like "evaluable filter", ["dados_históricos/período/empresa", :upper], "DadosHistóricos::Período::Empresa"
-  it_should_behave_like "evaluable filter", ["dados_históricos/período/empresa", :lower], "dadosHistóricos::Período::Empresa"
-  it_should_behave_like "evaluable filter", ["ímpar_par/norte_sul"                     ], "ÍmparPar::NorteSul"
-  it_should_behave_like "evaluable filter", ["ímpar_par/norte_sul", :upper             ], "ÍmparPar::NorteSul"
-  it_should_behave_like "evaluable filter", ["ímpar_par/norte_sul", :lower             ], "ímparPar::NorteSul"
-  
-  context "should affect acronyms" do
-    let(:inflections) { ActiveSupport::Inflector::Inflections.instance }
-
-    before(:all) do
-      inflections.acronym 'HTTP'
-      inflections.acronym 'SSL'
-      inflections.acronym 'Xml'
-      inflections.acronym 'docType'
-    end
+module Normatron
+  module Filters
+    describe CamelizeFilter do
+      it { should evaluate("aint_no/rest_for/the_wicked").to("AintNo::RestFor::TheWicked"  ) }
+      it { should evaluate("AINT_NO/REST_FOR/THE_WICKED").to("AintNo::RestFor::TheWicked"  ) }
+      it { should evaluate("Aint_no/Rest_for/The_wicked").to("AintNo::RestFor::TheWicked"  ) }
+      it { should evaluate("Aint_No/Rest_For/The_Wicked").to("AintNo::RestFor::TheWicked"  ) }
+      it { should evaluate("aInT_No/rEsT_FoR/ThE_WiCkEd").to("AintNo::RestFor::TheWicked"  ) }
+      it { should evaluate("AiNt_nO/ReSt_fOr/tHe_wIcKeD").to("AintNo::RestFor::TheWicked"  ) }
 
-    after(:all) do
-      inflections.acronyms.delete("http")
-      inflections.acronyms.delete("ssl")
-      inflections.acronyms.delete("xml")
-      inflections.acronyms.delete("doctype")
-    end
+      it { should evaluate("assets/stocks/companies"    ).to("Assets::Stocks::Companies"   ) }
+      it { should evaluate("ASSETS/STOCKS/COMPANIES"    ).to("Assets::Stocks::Companies"   ) }
+      it { should evaluate("Assets/Stocks/Companies"    ).to("Assets::Stocks::Companies"   ) }
+      it { should evaluate("aSsEtS/StOcKs/cOmPaNiEs"    ).to("Assets::Stocks::Companies"   ) }
+      it { should evaluate("AsSeTs/sToCkS/CoMpAnIeS"    ).to("Assets::Stocks::Companies"   ) }
+
+      it { should evaluate("bank/account"               ).to("Bank::Account"               ) }
+      it { should evaluate("BANK/ACCOUNT"               ).to("Bank::Account"               ) }
+      it { should evaluate("Bank/Account"               ).to("Bank::Account"               ) }
+      it { should evaluate("bAnK/AcCoUnT"               ).to("Bank::Account"               ) }
+      it { should evaluate("BaNk/aCcOuNt"               ).to("Bank::Account"               ) }
+
+      it { should evaluate("for_sale"                   ).to("ForSale"                     ) }
+      it { should evaluate("FOR_SALE"                   ).to("ForSale"                     ) }
+      it { should evaluate("For_sale"                   ).to("ForSale"                     ) }
+      it { should evaluate("For_Sale"                   ).to("ForSale"                     ) }
+      it { should evaluate("fOr_sAlE"                   ).to("ForSale"                     ) }
+      it { should evaluate("FoR_SaLe"                   ).to("ForSale"                     ) }
+
+      it { should evaluate("high_voltage/musics"        ).to("HighVoltage::Musics"         ) }
+      it { should evaluate("HIGH_VOLTAGE/MUSICS"        ).to("HighVoltage::Musics"         ) }
+      it { should evaluate("High_voltage/Musics"        ).to("HighVoltage::Musics"         ) }
+      it { should evaluate("High_Voltage/Musics"        ).to("HighVoltage::Musics"         ) }
+      it { should evaluate("hIgH_VoLtAgE/MuSiCs"        ).to("HighVoltage::Musics"         ) }
+      it { should evaluate("HiGh_vOlTaGe/mUsIcS"        ).to("HighVoltage::Musics"         ) }
+
+      it { should evaluate("note_book/black_piano"      ).to("NoteBook::BlackPiano"        ) }
+      it { should evaluate("NOTE_BOOK/BLACK_PIANO"      ).to("NoteBook::BlackPiano"        ) }
+      it { should evaluate("Note_book/Black_piano"      ).to("NoteBook::BlackPiano"        ) }
+      it { should evaluate("Note_Book/Black_Piano"      ).to("NoteBook::BlackPiano"        ) }
+      it { should evaluate("nOtE_BoOk/bLaCk_pIaNo"      ).to("NoteBook::BlackPiano"        ) }
+      it { should evaluate("NoTe_bOoK/BlAcK_PiAnO"      ).to("NoteBook::BlackPiano"        ) }
+
+      it { should evaluate("product"                    ).to("Product"                     ) }
+      it { should evaluate("PRODUCT"                    ).to("Product"                     ) }
+      it { should evaluate("Product"                    ).to("Product"                     ) }
+      it { should evaluate("pRoDuCt"                    ).to("Product"                     ) }
+      it { should evaluate("PrOdUcT"                    ).to("Product"                     ) }
 
-    it_should_behave_like "evaluable filter", ["http_address/ssl/xml_file/doctype"        ], "HTTPAddress::SSL::XmlFile::docType"
-    it_should_behave_like "evaluable filter", ["http_address/ssl/xml_file/doctype", :upper], "HTTPAddress::SSL::XmlFile::docType"
-    it_should_behave_like "evaluable filter", ["http_address/ssl/xml_file/doctype", :lower], "httpAddress::SSL::XmlFile::docType"
-    it_should_behave_like "evaluable filter", ["doctype_stop/run_ssl/xml/mix_http"        ], "docTypeStop::RunSSL::Xml::MixHTTP"
-    it_should_behave_like "evaluable filter", ["doctype_stop/run_ssl/xml/mix_http", :upper], "docTypeStop::RunSSL::Xml::MixHTTP"
-    it_should_behave_like "evaluable filter", ["doctype_stop/run_ssl/xml/mix_http", :lower], "doctypeStop::RunSSL::Xml::MixHTTP"
+      it { should evaluate("south_america/brazil/paraná").to("SouthAmerica::Brazil::Paraná") }
+      it { should evaluate("SOUTH_AMERICA/BRAZIL/PARANÁ").to("SouthAmerica::Brazil::Paraná") }
+      it { should evaluate("South_america/Brazil/Paraná").to("SouthAmerica::Brazil::Paraná") }
+      it { should evaluate("South_America/Brazil/Paraná").to("SouthAmerica::Brazil::Paraná") }
+      it { should evaluate("sOuTh_aMeRiCa/bRaZiL/PaRaNá").to("SouthAmerica::Brazil::Paraná") }
+      it { should evaluate("SoUtH_AmErIcA/BrAzIl/pArAnÁ").to("SouthAmerica::Brazil::Paraná") }
+
+      it { should evaluate("you_cannot/steal_my/wallet" ).to("YouCannot::StealMy::Wallet"  ) }
+      it { should evaluate("YOU_CANNOT/STEAL_MY/WALLET" ).to("YouCannot::StealMy::Wallet"  ) }
+      it { should evaluate("You_cannot/Steal_my/Wallet" ).to("YouCannot::StealMy::Wallet"  ) }
+      it { should evaluate("You_Cannot/Steal_My/Wallet" ).to("YouCannot::StealMy::Wallet"  ) }
+      it { should evaluate("yOu_cAnNoT/StEaL_My/wAlLeT" ).to("YouCannot::StealMy::Wallet"  ) }
+      it { should evaluate("YoU_CaNnOt/sTeAl_mY/WaLlEt" ).to("YouCannot::StealMy::Wallet"  ) }
+
+      it { should evaluate("aint_no/rest_for/the_wicked").to("aintNo::RestFor::TheWicked"  ).with(:lower) }
+      it { should evaluate("AINT_NO/REST_FOR/THE_WICKED").to("aintNo::RestFor::TheWicked"  ).with(:lower) }
+      it { should evaluate("Aint_no/Rest_for/The_wicked").to("aintNo::RestFor::TheWicked"  ).with(:lower) }
+      it { should evaluate("Aint_No/Rest_For/The_Wicked").to("aintNo::RestFor::TheWicked"  ).with(:lower) }
+      it { should evaluate("aInT_No/rEsT_FoR/ThE_WiCkEd").to("aintNo::RestFor::TheWicked"  ).with(:lower) }
+      it { should evaluate("AiNt_nO/ReSt_fOr/tHe_wIcKeD").to("aintNo::RestFor::TheWicked"  ).with(:lower) }
+
+      it { should evaluate(100).to(100) }
+      it { should evaluate(nil).to(nil) }
+      
+      context "with acronyms setted" do
+        let(:inflections) { ActiveSupport::Inflector::Inflections.instance }
+
+        before(:all) do
+          inflections.acronym 'HTTP'
+          inflections.acronym 'SSL'
+          inflections.acronym 'Xml'
+          inflections.acronym 'docType'
+        end
+
+        after(:all) do
+          inflections.acronyms.delete("http")
+          inflections.acronyms.delete("ssl")
+          inflections.acronyms.delete("xml")
+          inflections.acronyms.delete("doctype")
+        end
+
+        it { should evaluate("http_address/ssl/xml_file/doctype").to("HTTPAddress::SSL::XmlFile::docType") }
+        it { should evaluate("http_address/ssl/xml_file/doctype").to("httpAddress::SSL::XmlFile::docType").with(:lower) }
+        it { should evaluate("doctype_stop/run_ssl/xml/mix_http").to("docTypeStop::RunSSL::Xml::MixHTTP" ) }
+        it { should evaluate("doctype_stop/run_ssl/xml/mix_http").to("doctypeStop::RunSSL::Xml::MixHTTP" ).with(:lower) }
+      end
+    end
   end
 end

data/spec/normatron/filters/capitalize_filter_spec.rb

@@ -4,11 +4,12 @@ require 'spec_helper'
 require 'normatron/filters/capitalize_filter'
 
 describe Normatron::Filters::CapitalizeFilter do
-  it_should_behave_like "string processor"
-  it_should_behave_like "evaluable filter", ["i love winter" ], "I love winter"
-  it_should_behave_like "evaluable filter", ["I LOVE WINTER" ], "I love winter"
-  it_should_behave_like "evaluable filter", ["ó, vida cruel!"], "Ó, vida cruel!"
-  it_should_behave_like "evaluable filter", ["Ó, VIDA CRUEL!"], "Ó, vida cruel!"
-  it_should_behave_like "evaluable filter", ["1 minute"      ], "1 minute"
-  it_should_behave_like "evaluable filter", ["1 MINUTE"      ], "1 minute"
+  it { should evaluate("i love winter" ).to("I love winter" ) }
+  it { should evaluate("I LOVE WINTER" ).to("I love winter" ) }
+  it { should evaluate("ó, vida cruel!").to("Ó, vida cruel!") }
+  it { should evaluate("Ó, VIDA CRUEL!").to("Ó, vida cruel!") }
+  it { should evaluate("1 minute"      ).to("1 minute"      ) }
+  it { should evaluate("1 MINUTE"      ).to("1 minute"      ) }
+  it { should evaluate(100             ).to(100             ) }
+  it { should evaluate(nil             ).to(nil             ) }
 end

data/spec/normatron/filters/squeeze_filter_spec.rb

@@ -5,6 +5,6 @@ require 'normatron/filters/squeeze_filter'
 
 describe Normatron::Filters::SqueezeFilter do
   it_should_behave_like "string processor"
-  it_should_behave_like "evaluable filter", ["1 22  333   4444    "        ], "1 2 3 4 "
-  it_should_behave_like "evaluable filter", ["1 22  333   4444    ", "2-3 "], "1 2 3 4444 "
+  it { should evaluate("squeezing: hells bells").to("squezing: hels bels" ) }
+  it { should evaluate("squeezing: hells bells").to("squeezing: hels bels").with("l") }
 end

data/spec/spec_helper.rb

@@ -1,8 +1,13 @@
 # encoding: UTF-8
 
-require "active_record"
+require "normatron"
 Dir[File.dirname(__FILE__) + "/support/**/*.rb"].each { |f| require f }
 
+RSpec.configure do |config|
+  config.include(FilterMatchers)
+  config.order = "random"
+end
+
 shared_examples "evaluable filter" do |args, expected|
   if args.size == 1
     it { subject.send(:evaluate, args[0]).should_not equal expected }

data/spec/support/matchers/evaluate_matcher.rb

@@ -0,0 +1,75 @@
+module FilterMatchers
+  def evaluate(input)
+    EvaluateMatcher.new(input)
+  end
+
+  class EvaluateMatcher
+    def initialize(input)
+      @input = input
+      self
+    end
+
+    def to(output)
+      @expected = output
+      self
+    end
+
+    def with(*args)
+      @args = args
+      self
+    end
+
+    def matches?(filter_module)
+      @filter = filter_module
+      @got    = get_evaluation
+      @reason = get_failure_reason
+      @reason.nil?
+    end
+
+    def description
+      case @reason
+      when :value
+        "eq #{@expected.inspect}"
+      when :identity
+        "not equal #{@expected.inspect}"
+      when :type
+        "be a kind of #{@input.class}"
+      else
+        "evaluate #{@input.inspect} to #{@expected.inspect}"
+      end
+    end
+
+    def failure_message
+      case @reason
+      when :value
+        ["input:    #{@input.inspect}",
+         "expected: #{@expected.inspect}",
+         "got:      #{@got.inspect}"] * "\n"
+      when :identity
+        "expected #{@filter.name} evaluate and returns a different object_id from input object."
+      when :type
+        "expected #{@filter.name} evaluate and returns the same object type of his input."
+      end
+    end
+
+    private
+
+    def get_evaluation
+      if @args.nil?
+        @filter.evaluate(@input)
+      else
+        @filter.evaluate(@input, *@args)
+      end
+    end
+
+    def get_failure_reason
+      if @got != @expected
+        :value
+      elsif !@got.kind_of?(@input.class)
+        :type
+      elsif @got.equal?(@input) && @got.kind_of?(String)
+        :identity
+      end
+    end
+  end
+end