philter 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 752a73c7c043fd49ebb875fca66209e6865b1f17
-  data.tar.gz: 2c010a42446deff32ac4edc8bb2a0934333f8910
+  metadata.gz: 872214969624e598ec099b000b4ada64ac9837f3
+  data.tar.gz: ba1d3f800772f91b3a8d8b08b06d87a68229d517
 SHA512:
-  metadata.gz: db08c41adc22da507100dba892ed3329a0d2e6e7a352cd459408ad30cb078fafd06988d228c646a111d2cdd4e606e9e80591b8445611d53f9b1026b88b96e506
-  data.tar.gz: 4449e25ad6b6a348d15edb3ae3292b16bb95eef9f52749598a1cfc486f613a6186decc62a481c8bd9d28da1a55e321bad169cde3ff15bed5492844ce9334d24f
+  metadata.gz: dc93c8a4a407b0227b0e6795dcd060d01855b83a6f4b8896a1ca2957ae480288eeabecd0d71f8f3f5e254b9cc4cb86fb2a287417856784a899ab6c24ed168a6a
+  data.tar.gz: 64bc6efbc153e5e41ad99e0eb493046a1f9be0dcd859aa522f11ab423da36877058c2203de70034b42a291300cff791887a3dc5ccff4b1c0d54141c179cf8095

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+v1.1.0 [☰](https://github.com/marcomd/Philter/compare/v1.0.0...v1.1.0) May 26th, 2016
+------------------------------
+* Added debug mode to unit tests
+* Changed files organization
+* Improved code readibility
+* Improved documentation
+
 v1.0.0 [☰](https://github.com/marcomd/Philter/compare/v0.8.0...v1.0.0) May 25th, 2016
 ------------------------------
 * Code revolution: more simple, secure and readable

data/README.md

@@ -64,32 +64,32 @@ require 'philter'
 # Regular expression
 [
 {id: 1, name: 'Mark',   email: 'mark@gmail.com'  },
-{id: 2, name: 'Larry',  email: 'larry@gmail.com'   },
-{id: 3, name: 'Bill',   email: 'bill@live.com'    }
+{id: 2, name: 'Larry',  email: 'larry@gmail.com' },
+{id: 3, name: 'Bill',   email: 'bill@live.com'   }
 ].philter email: /@gmail/
 => [{:id=>1, :name=>"Mark", :email=>"mark@gmail.com"}, {:id=>2, :name=>"Larry",:email=>"larry@gmail.com"}]
 
 # Select attributes
 [
 {id: 1, name: 'Mark',   email: 'mark@gmail.com'  },
-{id: 2, name: 'Larry',  email: 'larry@gmail.com'   },
-{id: 3, name: 'Bill',   email: 'bill@live.com'    }
+{id: 2, name: 'Larry',  email: 'larry@gmail.com' },
+{id: 3, name: 'Bill',   email: 'bill@live.com'   }
 ].philter({email: /@gmail/}, get: :name)
 => ["Mark", "Larry"]
 
-# Philter with more attributes
+# Philter with more attributes -and-
 [
 {id: 1, name: 'Mark',   email: 'mark@gmail.com'  },
-{id: 2, name: 'Larry',  email: 'larry@gmail.com'   },
-{id: 3, name: 'Bill',   email: 'bill@live.com'    }
+{id: 2, name: 'Larry',  email: 'larry@gmail.com' },
+{id: 3, name: 'Bill',   email: 'bill@live.com'   }
 ].philter name: /M.+/, email: /@gmail/
 => [{:id=>1, :name=>"Mark", :email=>"mark@gmail.com"}]
 
-# Philter with an attribute or another
+# Philter with more attributes -or-
 [
 {id: 1, name: 'Mark',   email: 'mark@gmail.com'  },
-{id: 2, name: 'Larry',  email: 'larry@gmail.com'   },
-{id: 3, name: 'Bill',   email: 'bill@live.com'    }
+{id: 2, name: 'Larry',  email: 'larry@gmail.com' },
+{id: 3, name: 'Bill',   email: 'bill@live.com'   }
 ].philter({name: /M.+/, email: /@live/}, or: true)
 => [{:id=>1, :name=>"Mark", :email=>"mark@gmail.com"}, {:id=>3, :name=>"Bill", :email=>"bill@live.com"}]
 
@@ -97,16 +97,16 @@ require 'philter'
 # Select and update attributes
 [
 {id: 1, name: 'Mark',   email: 'mark@gmail.com'  },
-{id: 2, name: 'Larry',  email: 'larry@gmail.com'   },
-{id: 3, name: 'Bill',   email: 'bill@live.com'    }
+{id: 2, name: 'Larry',  email: 'larry@gmail.com' },
+{id: 3, name: 'Bill',   email: 'bill@live.com'   }
 ].philter({email: /@gmail/}){|e| e[:name] << ' use gmail!'}
 => ["Mark use gmail!", "Larry use gmail!"]
 
 # Add attributes
 [
 {id: 1, name: 'Mark',   email: 'mark@gmail.com'  },
-{id: 2, name: 'Larry',  email: 'larry@gmail.com'   },
-{id: 3, name: 'Bill',   email: 'bill@live.com'    }
+{id: 2, name: 'Larry',  email: 'larry@gmail.com' },
+{id: 3, name: 'Bill',   email: 'bill@live.com'   }
 ].philter({email: /@gmail/}){|e| e[:surname] = 'unknown';e }
 => :try_yourself
 ```
@@ -114,27 +114,40 @@ require 'philter'
 Get the trace with the option `debug: true`
 
 ```ruby
-[
-{id: 1, name: 'Mark'    },
-{id: 2, name: 'Larry'   },
-{id: 3, name: 'Bill'    }
-].philter({id: [1,3]}, debug: true)
-# You will get a trace
-item Hash {:id=>1, :name=>"Mark"}
- a. search: Array [:id, [1, 3]]
-  1.y label: Symbol .2 Hash[:id] == value | 1 == 1  => X
-  1.y label: Symbol .2 Hash[:id] == value | 1 == 3
-item Hash {:id=>2, :name=>"Larry"}
- a. search: Array [:id, [1, 3]]
-  1.y label: Symbol .2 Hash[:id] == value | 2 == 1
-  1.y label: Symbol .2 Hash[:id] == value | 2 == 3
-item Hash {:id=>3, :name=>"Bill"}
- a. search: Array [:id, [1, 3]]
-  1.y label: Symbol .2 Hash[:id] == value | 3 == 1
-  1.y label: Symbol .2 Hash[:id] == value | 3 == 3  => X
-------------------
- 2 items found
-=> [{:id=>1, :name=>"Mark"}, {:id=>3, :name=>"Bill"}]
+[{id: 1, name: 'Mark', email: 'mark@gmail.com'},
+ {id: 2, name: 'Bill', email: 'bill@live.com'},
+ {id: 3, name: 'Larry', email: 'larry@gmail.com'}
+].philter({name: 'Mark', email: /\A.+gmail/}, debug: true)
+
+--------------- Start debugging philter 1.1.0 ---------------
+ Search by Hash:
+
+ item {:id=>1, :name=>"Mark", :email=>"mark@gmail.com"} (Hash)
+  evaluating with hash
+   search: name: Mark (String)
+   .4  v1 item[name]  item == value | Mark == Mark  => x
+   search: email: (?-mix:\A.+gmail) (Regexp)
+   .1  v1 item[email]  item =~ value | mark@gmail.com =~ (?-mix:\A.+gmail)  => x
+
+ - SELECTED - (And)
+
+ item {:id=>2, :name=>"Bill", :email=>"bill@live.com"} (Hash)
+  evaluating with hash
+   search: name: Mark (String)
+   .4  v1 item[name]  item == value | Bill == Mark
+   search: email: (?-mix:\A.+gmail) (Regexp)
+   .1  v1 item[email]  item =~ value | bill@live.com =~ (?-mix:\A.+gmail)
+
+ item {:id=>3, :name=>"Larry", :email=>"larry@gmail.com"} (Hash)
+  evaluating with hash
+   search: name: Mark (String)
+   .4  v1 item[name]  item == value | Larry == Mark
+   search: email: (?-mix:\A.+gmail) (Regexp)
+   .1  v1 item[email]  item =~ value | larry@gmail.com =~ (?-mix:\A.+gmail)  => x
+
+--------------- End debugging philter 1.1.0 ---------------
+ 1 item(s) found
+=> [{:id=>1, :name=>"Mark", :email=>"mark@gmail.com"}]
 ```
 
 ### Rails
@@ -223,7 +236,7 @@ select:     0.078000   0.000000   0.078000 (  0.073341)
 
 ```ruby
 Benchmark.bmbm do |x|
-  x.report("philter: ") { 1_000.times { ar_test.philter '< 50' } }
+  x.report("philter: ") { 1_000.times { ar_test.philter '< 50'          } }
   x.report("select: ")  { 1_000.times { ar_test.select {|item| item < 50} } }
 end
 

data/lib/philter.rb

@@ -1,6 +1,20 @@
-require_relative 'version'
-require_relative 'base'
-require_relative 'array'
+# Philter
+# Copyright (C) 2016  Marco Mastrodonato, m.mastrodonato@gmail.com
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-module Philter
-end
+require_relative 'version'
+require_relative 'philter/base'
+require_relative 'philter/search'
+require_relative 'philter/evaluation'
+require_relative 'philter/array'

data/lib/philter/array.rb

@@ -0,0 +1,52 @@
+###################################
+# Philter with passion
+###################################
+class Array
+  include Philter::Base
+  include Philter::Search
+  include Philter::Evaluation
+
+  # Have yourself indulging in the pleasure of philtering
+  def philter(search = nil, options = {}, &block)
+    options = { get:   nil,
+                debug: false }.merge(options)
+    unless search
+      puts philter_help if options[:debug]
+      raise 'Specify search parameter!'
+    end
+    puts if options[:debug]
+    puts "#{'-' * 15} Start debugging philter #{Philter.version} #{'-' * 15}" if options[:debug]
+    items = self
+    apply_block = true
+    results =
+      case search.class.name
+      when 'Hash'
+        print ' Search by Hash:' if options[:debug]
+        phil_search_by_attributes(items, search, options)
+      when 'String'
+        print ' Search by String:' if options[:debug]
+        operator = phil_get_operator(search)
+        if operator
+          phil_search_with_operator(items, search, options)
+        else
+          puts " #{search} with grep" if options[:debug]
+          items.grep(search)
+        end
+      when 'Array'
+        print ' Search by Array:' if options[:debug]
+        phil_search_by_array(items, search, options)
+      else
+        puts " Search with grep: #{search}" if options[:debug]
+        apply_block = false
+        items.grep(search, &block)
+      end
+
+    puts "#{'-' * 15} End debugging philter #{Philter.version} #{'-' * 15}" if options[:debug]
+    puts " #{results.size} item(s) found" if options[:debug]
+    if block_given? && apply_block
+      results.map { |item| yield(item) }
+    else
+      results
+    end
+  end
+end

data/lib/philter/base.rb

@@ -0,0 +1,28 @@
+# Philter methods
+module Philter
+  # It contains generic methods
+  module Base
+    private
+
+    # Show tips on usage
+    def philter_help
+      <<-HELP.gsub(/^      /, '')
+      *************************************************************************
+      Philter version #{Philter.version}
+      [].philter 'search', {options}
+      Examples:
+      [1,2,3].philter 1 => [1]
+      [1,2,3].philter [2,3] => [2, 3]
+      [{id: 1, name: 'Mark'},{id: 2, name: 'Bill'}].philter id: 1
+      Articles.philter id: 1
+      People.philter   name: 'Mario'
+      People.philter   email: /\A.+@gmail/
+      Use option get: to select an attribute
+      People.philter   {id: 1}, get: :surname
+      Use option debug: to watch the selection
+      Articles.philter {id: 1}, debug: true
+      *************************************************************************
+      HELP
+    end
+  end
+end

data/lib/philter/evaluation.rb

@@ -0,0 +1,115 @@
+# Philter methods
+module Philter
+  # It contains all the methods for selecting the items
+  module Evaluation
+    private
+
+    # Evaluate search attributes to any item
+    # in:   item, search, options{debug:nil}
+    # out:  true/false (if the item has been selected)
+    def phil_eval_attributes(item, search, options = {})
+      selected_or  = nil
+      selected_and = true
+      search.each do |key, search_value|
+        # Every item must match with search options to be selected
+        puts "   search: #{key}: #{search_value} " \
+             "(#{search_value.class.name})" if options[:debug]
+        case search_value.class.name
+        when 'Regexp'
+          # search: {email: /@gmail/}
+          print '   .1 ' if options[:debug]
+          selected = phil_evaluate item_value(item, key, options),
+                                   search_value,
+                                   options.merge(operator: '=~')
+        when 'Class'
+          # search: {code: String} or {code: Fixnum}
+          print '   .2 item.class == value | ' \
+                "#{item.class} == #{search_value}" if options[:debug]
+          selected = item_value(item, key, options).class == search_value
+        when 'Array'
+          # search: {id: [1,2]}
+          print '   .3 ' if options[:debug]
+          selected = search_value.include? item_value(item, key, options)
+        else
+          # search: {id: 2} or {id: '<3'} or any other operator
+          print '   .4 ' if options[:debug]
+          selected = phil_evaluate item_value(item, key, options),
+                                   search_value,
+                                   options.merge(operator: '==')
+        end
+        puts "  #{selected && '=> x'}" if options[:debug]
+        selected_or   = true      if !selected_or && selected
+        selected_and  = selected  if selected_and
+      end
+
+      if options[:or]
+        puts " #{selected_or && '- SELECTED - (Or)'}" if options[:debug]
+        selected_or
+      else
+        puts " #{selected_and && '- SELECTED - (And)'}" if options[:debug]
+        selected_and
+      end
+    end
+
+    # Provide the item's value
+    # in:   item, attribute, options{debug:nil}
+    # out:  the item's value
+    def item_value(item, attribute, options = {})
+      case item.class.name
+      when 'Hash' then
+        print " item[#{attribute}] = #{item[attribute]} " if options[:debug]
+        item[attribute]
+      when 'Fixnum', 'Float', 'Bignum', 'Symbol', 'String'
+        print " #{item.class.name} " if options[:debug]
+        print "#{item} " if options[:debug]
+        item
+      else
+        print " item.#{attribute} " if options[:debug]
+        if item.respond_to?(attribute)
+          print "= #{item.send(attribute)} " if options[:debug]
+          item.send(attribute)
+        end
+      end
+    end
+
+    # Evaluate a condition: item -operator- value
+    # in:   item, value, options{operator:'==',debug:false}
+    # out:  true/false
+    def phil_evaluate(item, value, options = {})
+      options = { operator: '==',
+                  debug:    false }.merge(options)
+      value, operator = phil_get_operator_value_cleaned value
+      operator ||= options[:operator]
+      print " item #{operator} value" if options[:debug]
+      print " | #{item} #{operator} #{value}" if options[:debug]
+      case operator
+      when '=~' then item.to_s =~ value
+      when '===' then item === value
+      when '==' then item == value
+      when '>=' then item >= value
+      when '<=' then item <= value
+      when '!=' then item != value
+      when '>' then item > value
+      when '<' then item < value
+      end
+    end
+
+    # Search an operator in value
+    # in:   value
+    # out:  value without operator, operator
+    def phil_get_operator_value_cleaned(value)
+      operator  = phil_get_operator value
+      value     = value.gsub(operator, '').to_i if operator
+      [value, operator]
+    end
+
+    # Search an operator by regexp (?:<=?|>=?|!=|==|===|=~)
+    # in:   value
+    # out:  operator
+    def phil_get_operator(str)
+      return unless str.is_a?(String)
+      regexp = '(?:<=?|>=?|!=|==|===|=~)'
+      str.match(/#{regexp}/).to_s if str =~ /#{regexp}/
+    end
+  end
+end

data/lib/philter/search.rb

@@ -0,0 +1,106 @@
+# Philter methods
+module Philter
+  # It contains methods to select array's items
+  module Search
+    private
+
+    # Called when search is a string with an operator
+    # in:   search, options{debug:nil}
+    # out:  array of selected items
+    def phil_search_with_operator(items, search, options = {})
+      puts " #{search} with operator" if options[:debug]
+      results = []
+      items.each do |item|
+        puts " item #{item.class.name} #{item}" if options[:debug]
+        selected = phil_evaluate item, search, options
+        puts " #{selected && '=> x'}" if options[:debug]
+        results << item if selected
+      end
+      results
+    end
+
+    # Called when search is an array
+    # in:   search, options{debug:nil}
+    # out:  array of selected items
+    def phil_search_by_array(items, search, options = {})
+      puts " #{search}" if options[:debug]
+      search_same_class = false
+      # Check if search's objects are all the same class
+      search.inject do |prev, cur|
+        search_same_class = prev.class == cur.class
+        cur
+      end
+      if search_same_class
+        items.select do |item|
+          if search.first.class.name == 'Class'
+            selected = search.include?(item.class)
+            puts "  item: #{item} #{selected && '=> x'}" if options[:debug]
+            selected
+          else
+            selected = search.include?(item)
+            puts "  item: #{item} #{selected && '=> x'}" if options[:debug]
+            selected
+          end
+        end
+      else
+        # If there are many classes in search, check every search item
+        search.each do |search_value|
+          items.select do |item|
+            if search_value.class.name == 'Class'
+              selected = search_value == item.class
+              puts "  item: #{item} #{selected && '=> x'}" if options[:debug]
+              selected
+            else
+              selected = search_value == item
+              puts "  item: #{item} #{selected && '=> x'}" if options[:debug]
+              selected
+            end
+          end
+        end
+      end
+    end
+
+    # Search the search attribute in the item
+    # in:   search, options{debug:nil}
+    # out:  array of selected items
+    def phil_search_by_attributes(items, search, options = {})
+      puts " #{search}" if options[:debug]
+      results = []
+      items.each do |item|
+        selected = nil
+        # Evaluate each array's item
+        puts if options[:debug]
+        puts " item #{item} (#{item.class.name}) " if options[:debug]
+        case item.class.name
+        when 'Array'
+          puts '  item is an array => discarded' if options[:debug]
+        when 'Hash'
+          puts '  evaluating hash ' if options[:debug]
+          selected = phil_eval_attributes item, search, options
+        when 'Fixnum', 'Float', 'Bignum', 'Symbol', 'String'
+          print "  evaluating #{item.class.name} " if options[:debug]
+          if options[:everywhere]
+            print ' => everywhere' if options[:debug]
+            selected = phil_eval_attributes item, search, options
+          else
+            print ' => discarded' if options[:debug]
+          end
+        else
+          puts "  evaluating #{item.class.name}'s attributes" if options[:debug]
+          selected = phil_eval_attributes item, search, options
+        end
+
+        next unless selected
+        results <<
+          if options[:get] && item.respond_to?(options[:get])
+            item.send options[:get]
+          elsif options[:get] && item.respond_to?('[]')
+            item[options[:get]]
+          else
+            item
+          end
+      end
+      results
+    end
+  end
+end

data/lib/version.rb

@@ -1,5 +1,5 @@
 module Philter
   def self.version
-    "1.0.0"
+    "1.1.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philter
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Marco Mastrodonato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-25 00:00:00.000000000 Z
+date: 2016-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-unit
@@ -35,9 +35,11 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
-- lib/array.rb
-- lib/base.rb
 - lib/philter.rb
+- lib/philter/array.rb
+- lib/philter/base.rb
+- lib/philter/evaluation.rb
+- lib/philter/search.rb
 - lib/version.rb
 homepage: https://github.com/marcomd/philter
 licenses:

data/lib/array.rb

@@ -1,40 +0,0 @@
-class Array
-  include Philter::Base
-  def philter search=nil, options={}, &block
-    options = {
-        get:          nil,
-        debug:        false
-    }.merge(options)
-    unless search
-      puts philter_help if options[:debug]
-      raise "Specify search parameter!"
-    end
-
-    apply_block = true
-    results =
-    case search.class.name
-      when "Hash"
-        print " h. "                                                      if options[:debug]
-        phil_search_by_attributes search, options
-      when "String"
-        print " s. "                                                      if options[:debug]
-        operator = phil_get_operator search
-        operator ? phil_search_with_operator(search, operator: operator) : self.grep(search)
-      when "Array"
-        print " a. "                                                      if options[:debug]
-        phil_search_by_array search, options
-      else
-        puts " g. #{search}"                                              if options[:debug]
-        apply_block = false
-        self.grep(search, &block)
-    end
-
-    puts "------------------"                                                                     if options[:debug]
-    puts " #{results ? results.size : 'No'} item#{results && results.size == 1 ? '' : 's'} found" if options[:debug]
-    if block_given? && apply_block
-      results.map{|item| block.call(item)}
-    else
-      results
-    end
-  end
-end

data/lib/base.rb

@@ -1,191 +0,0 @@
-module Philter
-  module Base
-    private
-
-    def phil_search_with_operator search, options={}
-      results = []
-      self.each do |item|
-        puts "item #{item.class.name} #{item}"                               if options[:debug]
-        selected = phil_evaluate item, search, options
-        puts " #{'=> X' if selected}"                                        if options[:debug]
-        results << item if selected
-      end
-      results
-    end
-
-    def phil_search_by_array search, options={}
-      puts "search #{search} (#{search.class.name}) "                        if options[:debug]
-      search_same_class = false
-      search.inject{|prev, cur| search_same_class=prev.class == cur.class; cur }
-      if search_same_class
-        self.select do |item|
-          if search.first.class.name == 'Class'
-            search.include? item.class
-          else
-            search.include? item
-          end
-        end
-      else
-        # Check every search item
-        search.each do |search_value|
-          self.select do |item|
-            if search_value.class.name == 'Class'
-              search_value == item.class
-            else
-              search_value == item
-            end
-          end
-        end
-      end
-    end
-
-    def phil_search_by_attributes search, options={}
-      results = []
-      self.each do |item|
-        selected = nil
-        # Evaluate each array's item
-        puts "item #{item} (#{item.class.name}) "                             if options[:debug]
-        case item.class.name
-          when "Array"
-            print "  a. discarded"                                            if options[:debug]
-          when "Hash"
-            print "  h. "                                                     if options[:debug]
-            selected = phil_apply_attributes item, search, options
-          when phil_base_objects
-            print "  b. discarded"                                            if options[:debug]
-          else
-            print "  o. "                                                     if options[:debug]
-            selected = phil_apply_attributes item, search, options
-        end
-        # puts " #{'=> X' if selected}"                                         if options[:debug]
-        if selected
-          results <<
-              if options[:get]
-                if item.respond_to? options[:get]
-                  item.send options[:get]
-                elsif item.respond_to? '[]'
-                  item[options[:get]]
-                end
-              else
-                item
-              end
-        end
-      end
-      results
-    end
-
-    def phil_apply_attributes item, search, options={}
-      selected_or, selected_and = nil, true
-      search.each do |key, search_value|
-        # Every item must match with search options to be selected
-        puts " search: #{key}: #{search_value} (#{search_value.class.name})"                if options[:debug]
-        case search_value.class.name
-          when 'Regexp'
-            # search: {email: /@gmail/}
-            print "   .1 "                                                                  if options[:debug]
-            selected = phil_evaluate item_value(item, key, options), search_value, options.merge(operator: '=~')
-          when 'Class'
-            # search: {code: String} or {code: Fixnum}
-            print "   .2 item.class == value | #{item.class} == #{search_value}"            if options[:debug]
-            selected = item_value(item, key, options).class == search_value
-          when 'Array'
-            # search: {id: [1,2]}
-            print "   .3 "                                                                  if options[:debug]
-            selected = search_value.include? item_value(item, key, options)
-          else
-            # search: {id: 2} or {id: '<3'} or any other operator
-            print "   .4 "                                                                  if options[:debug]
-            selected = phil_evaluate item_value(item, key, options), search_value, options.merge(operator: '==')
-        end
-        puts "  #{'=> x' if selected}"                                                      if options[:debug]
-        selected_or   = true      if !selected_or && selected
-        selected_and  = selected  if selected_and
-      end
-
-      if options[:or]
-        puts " #{'=> X (Or)' if selected_or}"                                               if options[:debug]
-        selected_or
-      else
-        puts " #{'=> X (And)' if selected_and}"                                             if options[:debug]
-        selected_and
-      end
-    end
-
-    def item_value item, label, options={}
-      case item.class.name
-        when "Hash"   then
-          print " v1 item[#{label}] "                                                       if options[:debug]
-          item[label]
-        when "Fixnum", "Float", "Bignum", "Symbol", "String"
-          print " v2 #{item.class.name} "                                                   if options[:debug]
-          if options[:everywhere]
-            print "#{item} "                                                                if options[:debug]
-            item
-          else
-            print "- "                                                                      if options[:debug]
-            nil
-          end
-        else
-          print " v3 item.#{label} "                                                        if options[:debug]
-          item.send(label) if item.respond_to? label
-      end
-    end
-
-    def phil_evaluate item, value, options={}
-      options = {
-          operator:     '==',
-          debug:        false
-      }.merge(options)
-      operator    = phil_get_operator value
-      value       = operator ? value.gsub(operator,'').to_i : value
-      operator  ||= options[:operator]
-      print " item #{operator} value"                            if options[:debug]
-      print " | #{item} #{operator} #{value}"                    if options[:debug]
-      case operator
-        when '=~'   then item.to_s  =~  value
-        when '=='   then item       ==  value
-        when '==='  then item       === value
-        when '>'    then item       >   value
-        when '<'    then item       <   value
-        when '>='   then item       >=  value
-        when '<='   then item       <=  value
-        when '!='   then item       !=  value
-      end
-    end
-
-    def phil_get_operator exp
-      return unless exp.is_a? String
-      regexp = "(?:<=?|>=?|!=|==|===|=~)"
-      if exp =~ /#{regexp}/
-        exp.match(/#{regexp}/).to_s
-      else
-        nil
-      end
-    end
-
-    def phil_base_objects
-      return "Fixnum", "Float", "Bignum", "Symbol", "String"
-    end
-
-    def philter_help
-      <<-HELP.gsub(/^      /, '')
-      *************************************************************************
-      Philter version #{Philter.version}
-      [].philter 'search', {options}
-      Examples:
-      [1,2,3].philter 1 => [1]
-      [1,2,3].philter [2,3] => [2, 3]
-      [{id: 1, name: 'Mark'},{id: 2, name: 'Bill'}].philter id: 1
-      Articles.philter id: 1
-      People.philter   name: 'Mario'
-      People.philter   email: /\A.+@gmail/
-      Use option get: to select an attribute
-      People.philter   {id: 1}, get: :surname
-      Use option debug: to watch the selection
-      Articles.philter {id: 1}, debug: true
-      *************************************************************************
-      HELP
-    end
-
-  end
-end