hoodoo 1.11.0 → 1.12.0

data/lib/hoodoo/services/services/interface.rb

@@ -58,10 +58,20 @@ module Hoodoo; module Services
       #
       attr_reader :search
 
+      # Array of prohibited framework search keys as Strings; empty for none
+      # defined.
+      #
+      attr_reader :do_not_search
+
       # Array of supported filter keys as Strings; empty for none defined.
       #
       attr_reader :filter
 
+      # Array of prohibited framewor filter keys as Strings; empty for none
+      # defined.
+      #
+      attr_reader :do_not_filter
+
       # Create an instance with default settings.
       #
       def initialize
@@ -74,7 +84,9 @@ module Hoodoo; module Services
         @sort             = { 'created_at' => Set.new( [ 'desc', 'asc' ] ) }
         @default_sort_key = 'created_at'
         @search           = []
+        @do_not_search    = []
         @filter           = []
+        @do_not_filter    = []
       end
 
       private
@@ -103,12 +115,24 @@ module Hoodoo; module Services
         #
         attr_writer :search
 
+        # Private writer - see #do_not_search - but there's a special contract
+        # with Hoodoo::Services::Interface::ToListDSL which permits it to call
+        # here bypassing +private+ via +send()+.
+        #
+        attr_writer :do_not_search
+
         # Private writer - see #filter - but there's a special contract with
         # Hoodoo::Services::Interface::ToListDSL which permits it to call here
         # bypassing +private+ via +send()+.
         #
         attr_writer :filter
 
+        # Private writer - see #do_not_filter - but there's a special contract
+        # with Hoodoo::Services::Interface::ToListDSL which permits it to call
+        # here bypassing +private+ via +send()+.
+        #
+        attr_writer :do_not_filter
+
     end # 'class ToList'
 
     ###########################################################################
@@ -223,25 +247,59 @@ module Hoodoo; module Services
       # value escaping and validation, if necessary, is up to the service
       # implementation.
       #
-      # +search+:: Array of permitted search keys, as symbols or strings.
-      #            The order of array entries is arbitrary.
+      # +keys+:: Array of permitted search keys, as symbols or strings.
+      #          The order of array entries is arbitrary.
       #
       # Example - allow searches specifying +first_name+ and +last_name+ keys:
       #
       #     search :first_name, :last_name
       #
-      def search( *search )
-        @tl.send( :search=, search.map { | item | item.to_s } )
+      def search( *keys )
+        @tl.send( :search=, keys.map { | item | item.to_s } )
+      end
+
+      # Similar to #search, but for default Hoodoo framework exclusions. The
+      # Hoodoo::Services::Middleware +FRAMEWORK_QUERY_DATA+ array lists the
+      # known framework keys for a given Hoodoo version. An exception is
+      # raised if an attempt is made to exclude unknown keys.
+      #
+      # +keys+:: Array of prohibited framework search keys, as symbols or
+      #          strings. The order of array entries is arbitrary.
+      #
+      def do_not_search( *keys )
+        @tl.send( :do_not_search=, keys.map { | item | item.to_s } )
+
+        unknown = @tl.do_not_search() - Hoodoo::Services::Middleware::FRAMEWORK_QUERY_DATA.keys
+
+        unless unknown.empty?
+          raise "Hoodoo::Services::Interface::ToListDSL\#do_not_search was given one or more unknown keys: #{ unknown.join( ', ' ) }"
+        end
       end
 
       # As #search, but for filtering.
       #
-      # +filter+:: Array of permitted filter keys, as symbols or strings.
-      #            The order of array entries is arbitrary.
+      # +keys+:: Array of permitted filter keys, as symbols or strings.
+      #          The order of array entries is arbitrary.
       #
-      def filter( *filter )
-        @tl.send( :filter=, filter.map { | item | item.to_s } )
+      def filter( *keys )
+        @tl.send( :filter=, keys.map { | item | item.to_s } )
       end
+
+      # As #do_not_search, but for default Hoodoo framework exclusions.
+      #
+      # +keys+:: Array of prohibited framework filter keys, as symbols or
+      #          strings. The order of array entries is arbitrary.
+      #
+      def do_not_filter( *keys )
+        @tl.send( :do_not_filter=, keys.map { | item | item.to_s } )
+
+        unknown = @tl.do_not_filter() - Hoodoo::Services::Middleware::FRAMEWORK_QUERY_DATA.keys
+
+        unless unknown.empty?
+          raise "Hoodoo::Services::Interface::ToListDSL\#do_not_filter was given one or more unknown keys: #{ unknown.join( ', ' ) }"
+        end
+      end
+
     end # 'class ToListDSL'
 
     ###########################################################################

data/lib/hoodoo/version.rb

@@ -12,6 +12,6 @@ module Hoodoo
   # The Hoodoo gem version. If this changes, ensure that the date in
   # "hoodoo.gemspec" is correct and run "bundle install" (or "update").
   #
-  VERSION = '1.11.0'
+  VERSION = '1.12.0'
 
 end

data/spec/active/active_record/finder_spec.rb

@@ -73,31 +73,31 @@ describe Hoodoo::ActiveRecord::Finder do
       self.table_name = :r_spec_model_finder_tests
       sh              = Hoodoo::ActiveRecord::Finder::SearchHelper
 
-      search_with(
+      search_and_filter_map = {
         'mapped_code'     => sh.cs_match( 'code' ),
         :mapped_field_one => sh.ci_match_generic( 'field_one' ),
         :wild_field_one   => sh.ciaw_match_generic( 'field_one '),
         :field_two        => sh.cs_match_csv(),
-        'field_three'     => sh.cs_match_array()
-      )
+        'field_three'     => sh.cs_match_array(),
+        'created_after'   => sh.cs_gte( 'updated_at' )
+      }
 
-      filter_with(
-        'mapped_code'     => sh.cs_match( 'code' ),
-        :mapped_field_one => sh.ci_match_postgres( 'field_one' ),
-        :wild_field_one   => sh.ciaw_match_postgres( 'field_one '),
-        :field_two        => sh.cs_match_csv(),
-        'field_three'     => sh.cs_match_array()
-      )
+      search_with( search_and_filter_map )
+      filter_with( search_and_filter_map )
     end
   end
 
   before :each do
+    @tn = Time.now.round()
+
     @a = RSpecModelFinderTest.new
     @a.id = "one"
     @a.code = 'A' # Must be set else SQLite fails to find this if you search for "code != 'C'" (!)
     @a.field_one = 'group 1'
     @a.field_two = 'two a'
     @a.field_three = 'three a'
+    @a.created_at = @tn - 1.year
+    @a.updated_at = @tn - 1.month
     @a.save!
     @id = @a.id
 
@@ -108,6 +108,8 @@ describe Hoodoo::ActiveRecord::Finder do
     @b.field_one = 'group 1'
     @b.field_two = 'two b'
     @b.field_three = 'three b'
+    @b.created_at = @tn - 1.month
+    @b.updated_at = @tn - 1.week
     @b.save!
     @uuid = @b.uuid
 
@@ -117,6 +119,8 @@ describe Hoodoo::ActiveRecord::Finder do
     @c.field_one = 'group 2'
     @c.field_two = 'two c'
     @c.field_three = 'three c'
+    @c.created_at = @tn
+    @c.updated_at = @tn + 1.day
     @c.save!
     @code = @c.code
 
@@ -610,6 +614,27 @@ describe Hoodoo::ActiveRecord::Finder do
 
       finder = RSpecModelFinderTest.list( @list_params )
       expect( finder ).to eq([@c])
+
+      @list_params.search_data = {
+        'created_after' => @tn - 1.month
+      }
+
+      finder = RSpecModelFinderTest.list( @list_params )
+      expect( finder ).to eq([@c])
+
+      @list_params.search_data = {
+        'created_before' => @tn - 1.month
+      }
+
+      finder = RSpecModelFinderTest.list( @list_params )
+      expect( finder ).to eq([@a])
+
+      @list_params.search_data = {
+        'created_before' => @tn - 1.month + 1.day
+      }
+
+      finder = RSpecModelFinderTest.list( @list_params )
+      expect( finder ).to eq([@b, @a])
     end
 
     it 'searches with chain' do
@@ -650,6 +675,27 @@ describe Hoodoo::ActiveRecord::Finder do
 
       finder = constraint.list( @list_params )
       expect( finder ).to eq([])
+
+      @list_params.search_data = {
+        'created_after' => @tn - 1.month
+      }
+
+      finder = constraint.list( @list_params )
+      expect( finder ).to eq([])
+
+      @list_params.search_data = {
+        'created_before' => @tn - 1.month
+      }
+
+      finder = constraint.list( @list_params )
+      expect( finder ).to eq([@a])
+
+      @list_params.search_data = {
+        'created_before' => @tn - 1.month + 1.day
+      }
+
+      finder = constraint.list( @list_params )
+      expect( finder ).to eq([@b, @a])
     end
   end
 
@@ -707,6 +753,22 @@ describe Hoodoo::ActiveRecord::Finder do
       finder = RSpecModelFinderTestWithHelpers.list( @list_params )
       expect( finder ).to eq( [ @c_wh, @b_wh ] )
     end
+
+    it 'finds with framework override' do
+      @list_params.search_data = {
+        'created_after' => @tn - 1.week
+      }
+
+      finder = RSpecModelFinderTestWithHelpers.list( @list_params )
+      expect( finder ).to eq( [ @c_wh, @b_wh ] )
+
+      @list_params.search_data = {
+        'created_after' => @tn + 1.day
+      }
+
+      finder = RSpecModelFinderTestWithHelpers.list( @list_params )
+      expect( finder ).to eq( [ @c_wh ] )
+    end
   end
 
   # ==========================================================================
@@ -748,6 +810,27 @@ describe Hoodoo::ActiveRecord::Finder do
 
       finder = RSpecModelFinderTest.list( @list_params )
       expect( finder ).to eq([@b])
+
+      @list_params.filter_data = {
+        'created_after' => @tn - 1.month
+      }
+
+      finder = RSpecModelFinderTest.list( @list_params )
+      expect( finder ).to eq([@b, @a])
+
+      @list_params.filter_data = {
+        'created_before' => @tn - 1.month
+      }
+
+      finder = RSpecModelFinderTest.list( @list_params )
+      expect( finder ).to eq([@c, @b])
+
+      @list_params.filter_data = {
+        'created_before' => @tn - 1.month + 1.day
+      }
+
+      finder = RSpecModelFinderTest.list( @list_params )
+      expect( finder ).to eq([@c])
     end
 
     it 'filters with chain' do
@@ -792,6 +875,27 @@ describe Hoodoo::ActiveRecord::Finder do
 
       finder = constraint.list( @list_params )
       expect( finder ).to eq([])
+
+      @list_params.filter_data = {
+        'created_after' => @tn - 1.month
+      }
+
+      finder = constraint.list( @list_params )
+      expect( finder ).to eq([])
+
+      @list_params.filter_data = {
+        'created_before' => @tn - 1.month
+      }
+
+      finder = constraint.list( @list_params )
+      expect( finder ).to eq([@c])
+
+      @list_params.filter_data = {
+        'created_before' => @tn - 1.month + 1.day
+      }
+
+      finder = constraint.list( @list_params )
+      expect( finder ).to eq([@c])
     end
   end
 
@@ -837,7 +941,6 @@ describe Hoodoo::ActiveRecord::Finder do
       expect( finder ).to eq( [ @c_wh, @b_wh, @a_wh ] )
     end
 
-
     it 'filters by comma-separated list' do
       @list_params.filter_data = {
         'field_two' => 'two a,something else,two c,more'
@@ -855,6 +958,22 @@ describe Hoodoo::ActiveRecord::Finder do
       finder = RSpecModelFinderTestWithHelpers.list( @list_params )
       expect( finder ).to eq( [ @a_wh ] )
     end
+
+    it 'filters with framework override' do
+      @list_params.filter_data = {
+        'created_after' => @tn - 1.week
+      }
+
+      finder = RSpecModelFinderTestWithHelpers.list( @list_params )
+      expect( finder ).to eq( [ @a_wh ] )
+
+      @list_params.filter_data = {
+        'created_after' => @tn + 1.day
+      }
+
+      finder = RSpecModelFinderTestWithHelpers.list( @list_params )
+      expect( finder ).to eq( [ @b_wh, @a_wh ] )
+    end
   end
 
   # ==========================================================================
@@ -866,6 +985,7 @@ describe Hoodoo::ActiveRecord::Finder do
       @scoped_1.uuid = 'uuid 1'
       @scoped_1.code = 'code 1'
       @scoped_1.field_one = 'scoped 1'
+      @scoped_1.created_at = @tn - 1.year
       @scoped_1.save!
 
       @scoped_2 = RSpecModelFinderTest.new

data/spec/active/active_record/search_helper_spec.rb

@@ -27,17 +27,6 @@ describe Hoodoo::ActiveRecord::Finder::SearchHelper do
     end
   end
 
-  before :each do
-    @f1 = RSpecModelSearchHelperTest.create
-    @f2 = RSpecModelSearchHelperTest.create( :field => 'hello' )
-    @f3 = RSpecModelSearchHelperTest.create( :field => 'hello' )
-    @f4 = RSpecModelSearchHelperTest.create( :field => 'HELLO' )
-    @f5 = RSpecModelSearchHelperTest.create
-    @f6 = RSpecModelSearchHelperTest.create( :field => 'world' )
-    @f7 = RSpecModelSearchHelperTest.create( :field => 'world' )
-    @f8 = RSpecModelSearchHelperTest.create( :field => 'WORLD' )
-  end
-
   def find( clause )
     RSpecModelSearchHelperTest.where( *clause ).all
   end
@@ -46,387 +35,625 @@ describe Hoodoo::ActiveRecord::Finder::SearchHelper do
     RSpecModelSearchHelperTest.where.not( *clause ).all
   end
 
+  #############################################################################
+  # Although the queries in this section can match things other than strings
+  # in some cases, they're aimed at string comparison most of the time.
   #############################################################################
 
-  context '#cs_match' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.cs_match
-      expect( result.call( 'a', 'b' ) ).to eq( [ 'a = ? AND a IS NOT NULL', 'b' ] )
+  context 'equality' do
+    before :each do
+      @f1 = RSpecModelSearchHelperTest.create
+      @f2 = RSpecModelSearchHelperTest.create( :field => 'hello' )
+      @f3 = RSpecModelSearchHelperTest.create( :field => 'hello' )
+      @f4 = RSpecModelSearchHelperTest.create( :field => 'HELLO' )
+      @f5 = RSpecModelSearchHelperTest.create
+      @f6 = RSpecModelSearchHelperTest.create( :field => 'world' )
+      @f7 = RSpecModelSearchHelperTest.create( :field => 'world' )
+      @f8 = RSpecModelSearchHelperTest.create( :field => 'WORLD' )
     end
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.cs_match( :bar )
-      expect( result.call( 'a', 'b' ) ).to eq( [ 'bar = ? AND bar IS NOT NULL', 'b' ] )
-    end
+    ###########################################################################
 
-    it 'finds expected things' do
-      result = find( described_class.cs_match.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f2, @f3 ] )
+    context '#cs_match' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.cs_match
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'a = ? AND a IS NOT NULL', 'b' ] )
+      end
 
-      result = find( described_class.cs_match.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f4 ] )
+      it 'generates expected one-input-parameter output' do
+        result = described_class.cs_match( :bar )
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'bar = ? AND bar IS NOT NULL', 'b' ] )
+      end
 
-      result = find( described_class.cs_match.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [] )
+      it 'finds expected things' do
+        result = find( described_class.cs_match.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f2, @f3 ] )
 
-      result = find( described_class.cs_match.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [] )
+        result = find( described_class.cs_match.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f4 ] )
 
-      result = find( described_class.cs_match.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [] )
-    end
+        result = find( described_class.cs_match.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [] )
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.cs_match.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f1,           @f4, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.cs_match.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [] )
 
-      result = find_not( described_class.cs_match.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3,      @f5, @f6, @f7, @f8  ] )
+        result = find( described_class.cs_match.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [] )
+      end
 
-      result = find_not( described_class.cs_match.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.cs_match.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f1,           @f4, @f5, @f6, @f7, @f8 ] )
 
-      result = find_not( described_class.cs_match.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find_not( described_class.cs_match.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3,      @f5, @f6, @f7, @f8  ] )
 
-      result = find_not( described_class.cs_match.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
-    end
-  end
+        result = find_not( described_class.cs_match.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  #############################################################################
+        result = find_not( described_class.cs_match.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  context '#cs_match_csv' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.cs_match_csv()
-      expect( result.call( 'a', 'b,c,d' ) ).to eq( [ 'a IN (?) AND a IS NOT NULL', [ 'b', 'c', 'd' ] ] )
+        result = find_not( described_class.cs_match.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      end
     end
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.cs_match_csv( :bar )
-      expect( result.call( 'a', 'b,c,d' ) ).to eq( [ 'bar IN (?) AND bar IS NOT NULL', [ 'b', 'c', 'd' ] ] )
-    end
+    ###########################################################################
 
-    it 'finds expected things' do
-      result = find( described_class.cs_match_csv.call( 'field', 'hello,world' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f6, @f7 ] )
+    context '#cs_match_csv' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.cs_match_csv()
+        expect( result.call( 'a', 'b,c,d' ) ).to eq( [ 'a IN (?) AND a IS NOT NULL', [ 'b', 'c', 'd' ] ] )
+      end
 
-      result = find( described_class.cs_match_csv.call( 'field', 'HELLO,WORLD' ) )
-      expect( result ).to match_array( [ @f4, @f8 ] )
+      it 'generates expected one-input-parameter output' do
+        result = described_class.cs_match_csv( :bar )
+        expect( result.call( 'a', 'b,c,d' ) ).to eq( [ 'bar IN (?) AND bar IS NOT NULL', [ 'b', 'c', 'd' ] ] )
+      end
 
-      result = find( described_class.cs_match_csv.call( 'field', 'hell,worl' ) )
-      expect( result ).to match_array( [] )
+      it 'finds expected things' do
+        result = find( described_class.cs_match_csv.call( 'field', 'hello,world' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f6, @f7 ] )
 
-      result = find( described_class.cs_match_csv.call( 'field', 'llo,ld' ) )
-      expect( result ).to match_array( [] )
+        result = find( described_class.cs_match_csv.call( 'field', 'HELLO,WORLD' ) )
+        expect( result ).to match_array( [ @f4, @f8 ] )
 
-      result = find( described_class.cs_match_csv.call( 'field', 'heLLo,WORld' ) )
-      expect( result ).to match_array( [] )
-    end
+        result = find( described_class.cs_match_csv.call( 'field', 'hell,worl' ) )
+        expect( result ).to match_array( [] )
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.cs_match_csv.call( 'field', 'hello,world' ) )
-      expect( result ).to match_array( [ @f1,           @f4, @f5,          @f8 ] )
+        result = find( described_class.cs_match_csv.call( 'field', 'llo,ld' ) )
+        expect( result ).to match_array( [] )
 
-      result = find_not( described_class.cs_match_csv.call( 'field', 'HELLO,WORLD' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3,      @f5, @f6, @f7      ] )
+        result = find( described_class.cs_match_csv.call( 'field', 'heLLo,WORld' ) )
+        expect( result ).to match_array( [] )
+      end
 
-      result = find_not( described_class.cs_match_csv.call( 'field', 'hell,worl' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.cs_match_csv.call( 'field', 'hello,world' ) )
+        expect( result ).to match_array( [ @f1,           @f4, @f5,          @f8 ] )
 
-      result = find_not( described_class.cs_match_csv.call( 'field', 'llo,ld' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find_not( described_class.cs_match_csv.call( 'field', 'HELLO,WORLD' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3,      @f5, @f6, @f7      ] )
 
-      result = find_not( described_class.cs_match_csv.call( 'field', 'heLLo,WORld' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
-    end
-  end
+        result = find_not( described_class.cs_match_csv.call( 'field', 'hell,worl' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  #############################################################################
+        result = find_not( described_class.cs_match_csv.call( 'field', 'llo,ld' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  context '#cs_match_array' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.cs_match_array()
-      expect( result.call( 'a', [ 'b', 'c', 'd' ] ) ).to eq( [ 'a IN (?) AND a IS NOT NULL', [ 'b', 'c', 'd' ] ] )
+        result = find_not( described_class.cs_match_csv.call( 'field', 'heLLo,WORld' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      end
     end
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.cs_match_array( :bar )
-      expect( result.call( 'a', [ 'b', 'c', 'd' ] ) ).to eq( [ 'bar IN (?) AND bar IS NOT NULL', [ 'b', 'c', 'd' ] ] )
-    end
+    ###########################################################################
 
-    it 'finds expected things' do
-      result = find( described_class.cs_match_array.call( 'field', [ 'hello', 'world' ] ) )
-      expect( result ).to match_array( [ @f2, @f3, @f6, @f7 ] )
+    context '#cs_match_array' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.cs_match_array()
+        expect( result.call( 'a', [ 'b', 'c', 'd' ] ) ).to eq( [ 'a IN (?) AND a IS NOT NULL', [ 'b', 'c', 'd' ] ] )
+      end
 
-      result = find( described_class.cs_match_array.call( 'field', [ 'HELLO', 'WORLD' ] ) )
-      expect( result ).to match_array( [ @f4, @f8 ] )
+      it 'generates expected one-input-parameter output' do
+        result = described_class.cs_match_array( :bar )
+        expect( result.call( 'a', [ 'b', 'c', 'd' ] ) ).to eq( [ 'bar IN (?) AND bar IS NOT NULL', [ 'b', 'c', 'd' ] ] )
+      end
 
-      result = find( described_class.cs_match_array.call( 'field', [ 'hell', 'worl' ] ) )
-      expect( result ).to match_array( [] )
+      it 'finds expected things' do
+        result = find( described_class.cs_match_array.call( 'field', [ 'hello', 'world' ] ) )
+        expect( result ).to match_array( [ @f2, @f3, @f6, @f7 ] )
 
-      result = find( described_class.cs_match_array.call( 'field', [ 'llo', 'ld' ] ) )
-      expect( result ).to match_array( [] )
+        result = find( described_class.cs_match_array.call( 'field', [ 'HELLO', 'WORLD' ] ) )
+        expect( result ).to match_array( [ @f4, @f8 ] )
 
-      result = find( described_class.cs_match_array.call( 'field', [ 'heLLo', 'WORld' ] ) )
-      expect( result ).to match_array( [] )
-    end
+        result = find( described_class.cs_match_array.call( 'field', [ 'hell', 'worl' ] ) )
+        expect( result ).to match_array( [] )
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.cs_match_array.call( 'field', [ 'hello', 'world' ] ) )
-      expect( result ).to match_array( [ @f1,           @f4, @f5,          @f8 ] )
+        result = find( described_class.cs_match_array.call( 'field', [ 'llo', 'ld' ] ) )
+        expect( result ).to match_array( [] )
 
-      result = find_not( described_class.cs_match_array.call( 'field', [ 'HELLO', 'WORLD' ] ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3,      @f5, @f6, @f7      ] )
+        result = find( described_class.cs_match_array.call( 'field', [ 'heLLo', 'WORld' ] ) )
+        expect( result ).to match_array( [] )
+      end
 
-      result = find_not( described_class.cs_match_array.call( 'field', [ 'hell', 'worl' ] ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.cs_match_array.call( 'field', [ 'hello', 'world' ] ) )
+        expect( result ).to match_array( [ @f1,           @f4, @f5,          @f8 ] )
 
-      result = find_not( described_class.cs_match_array.call( 'field', [ 'llo', 'ld' ] ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find_not( described_class.cs_match_array.call( 'field', [ 'HELLO', 'WORLD' ] ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3,      @f5, @f6, @f7      ] )
 
-      result = find_not( described_class.cs_match_array.call( 'field', [ 'heLLo', 'WORld' ] ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
-    end
-  end
+        result = find_not( described_class.cs_match_array.call( 'field', [ 'hell', 'worl' ] ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  #############################################################################
+        result = find_not( described_class.cs_match_array.call( 'field', [ 'llo', 'ld' ] ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  context '#ci_match_generic' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.ci_match_generic()
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(a) = ? AND a IS NOT NULL', 'b' ] )
+        result = find_not( described_class.cs_match_array.call( 'field', [ 'heLLo', 'WORld' ] ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      end
     end
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.ci_match_generic( :bar )
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(bar) = ? AND bar IS NOT NULL', 'b' ] )
-    end
+    ###########################################################################
 
-    it 'finds expected things' do
-      result = find( described_class.ci_match_generic.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+    context '#ci_match_generic' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.ci_match_generic()
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(a) = ? AND a IS NOT NULL', 'b' ] )
+      end
 
-      result = find( described_class.ci_match_generic.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      it 'generates expected one-input-parameter output' do
+        result = described_class.ci_match_generic( :bar )
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(bar) = ? AND bar IS NOT NULL', 'b' ] )
+      end
 
-      result = find( described_class.ci_match_generic.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [] )
+      it 'finds expected things' do
+        result = find( described_class.ci_match_generic.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find( described_class.ci_match_generic.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [] )
+        result = find( described_class.ci_match_generic.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find( described_class.ci_match_generic.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
-    end
+        result = find( described_class.ci_match_generic.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [] )
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.ci_match_generic.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ci_match_generic.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [] )
 
-      result = find_not( described_class.ci_match_generic.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ci_match_generic.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      end
 
-      result = find_not( described_class.ci_match_generic.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.ci_match_generic.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
 
-      result = find_not( described_class.ci_match_generic.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find_not( described_class.ci_match_generic.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
 
-      result = find_not( described_class.ci_match_generic.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
-    end
-  end
+        result = find_not( described_class.ci_match_generic.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  #############################################################################
+        result = find_not( described_class.ci_match_generic.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
 
-  context '#ciaw_match_generic' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.ciaw_match_generic()
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(a) LIKE ? AND a IS NOT NULL', '%b%' ] )
+        result = find_not( described_class.ci_match_generic.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
+      end
     end
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.ciaw_match_generic( :bar )
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(bar) LIKE ? AND bar IS NOT NULL', '%b%' ] )
-    end
+    ###########################################################################
 
-    it 'finds expected things' do
-      result = find( described_class.ciaw_match_generic.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+    context '#ciaw_match_generic' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.ciaw_match_generic()
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(a) LIKE ? AND a IS NOT NULL', '%b%' ] )
+      end
 
-      result = find( described_class.ciaw_match_generic.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      it 'generates expected one-input-parameter output' do
+        result = described_class.ciaw_match_generic( :bar )
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'lower(bar) LIKE ? AND bar IS NOT NULL', '%b%' ] )
+      end
 
-      result = find( described_class.ciaw_match_generic.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      it 'finds expected things' do
+        result = find( described_class.ciaw_match_generic.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find( described_class.ciaw_match_generic.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+        result = find( described_class.ciaw_match_generic.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find( described_class.ciaw_match_generic.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
-    end
+        result = find( described_class.ciaw_match_generic.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.ciaw_match_generic.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ciaw_match_generic.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find_not( described_class.ciaw_match_generic.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ciaw_match_generic.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      end
 
-      result = find_not( described_class.ciaw_match_generic.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.ciaw_match_generic.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
 
-      result = find_not( described_class.ciaw_match_generic.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+        result = find_not( described_class.ciaw_match_generic.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
 
-      result = find_not( described_class.ciaw_match_generic.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
-    end
-  end
+        result = find_not( described_class.ciaw_match_generic.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
 
-  #############################################################################
+        result = find_not( described_class.ciaw_match_generic.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
 
-  context '#csaw_match' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.csaw_match()
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'a LIKE ? AND a IS NOT NULL', '%B%' ] )
+        result = find_not( described_class.ciaw_match_generic.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+      end
     end
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.csaw_match( :bar )
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'bar LIKE ? AND bar IS NOT NULL', '%B%' ] )
+    ###########################################################################
+
+    context '#csaw_match' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.csaw_match()
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'a LIKE ? AND a IS NOT NULL', '%B%' ] )
+      end
+
+      it 'generates expected one-input-parameter output' do
+        result = described_class.csaw_match( :bar )
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'bar LIKE ? AND bar IS NOT NULL', '%B%' ] )
+      end
+
+      it 'finds expected things' do
+        result = find( described_class.csaw_match.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f2, @f3 ] )
+
+        result = find( described_class.csaw_match.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f4 ] )
+
+        result = find( described_class.csaw_match.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f2, @f3 ] )
+
+        result = find( described_class.csaw_match.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f2, @f3 ] )
+
+        result = find( described_class.csaw_match.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [  ] )
+      end
+
+      it 'finds expected things negated' do
+        result = find_not( described_class.csaw_match.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f1, @f4, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.csaw_match.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.csaw_match.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f1, @f4, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.csaw_match.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f1, @f4, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.csaw_match.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      end
     end
 
-    it 'finds expected things' do
-      result = find( described_class.csaw_match.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f2, @f3 ] )
+    ###########################################################################
+
+    context '#ci_match_postgres' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.ci_match_postgres()
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'a ILIKE ? AND a IS NOT NULL', 'B' ] )
+      end
+
+      it 'generates expected one-input-parameter output' do
+        result = described_class.ci_match_postgres( :bar )
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'bar ILIKE ? AND bar IS NOT NULL', 'B' ] )
+      end
 
-      result = find( described_class.csaw_match.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f4 ] )
+      it 'finds expected things' do
+        result = find( described_class.ci_match_postgres.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find( described_class.csaw_match.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f2, @f3 ] )
+        result = find( described_class.ci_match_postgres.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+
+        result = find( described_class.ci_match_postgres.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [] )
+
+        result = find( described_class.ci_match_postgres.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [] )
+
+        result = find( described_class.ci_match_postgres.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      end
 
-      result = find( described_class.csaw_match.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f2, @f3 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.ci_match_postgres.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
 
-      result = find( described_class.csaw_match.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [  ] )
+        result = find_not( described_class.ci_match_postgres.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.ci_match_postgres.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.ci_match_postgres.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.ci_match_postgres.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
+      end
     end
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.csaw_match.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f1, @f4, @f5, @f6, @f7, @f8 ] )
+    ###########################################################################
+
+    context '#ciaw_match_postgres' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.ciaw_match_postgres()
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'a ILIKE ? AND a IS NOT NULL', '%B%' ] )
+      end
+
+      it 'generates expected one-input-parameter output' do
+        result = described_class.ciaw_match_postgres( :bar )
+        expect( result.call( 'a', 'B' ) ).to eq( [ 'bar ILIKE ? AND bar IS NOT NULL', '%B%' ] )
+      end
+
+      it 'finds expected things' do
+        result = find( described_class.ciaw_match_postgres.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find_not( described_class.csaw_match.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ciaw_match_postgres.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find_not( described_class.csaw_match.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f1, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ciaw_match_postgres.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find_not( described_class.csaw_match.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f1, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ciaw_match_postgres.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
 
-      result = find_not( described_class.csaw_match.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.ciaw_match_postgres.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      end
+
+      it 'finds expected things negated' do
+        result = find_not( described_class.ciaw_match_postgres.call( 'field', 'hello' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.ciaw_match_postgres.call( 'field', 'HELLO' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.ciaw_match_postgres.call( 'field', 'hell' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.ciaw_match_postgres.call( 'field', 'llo' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+
+        result = find_not( described_class.ciaw_match_postgres.call( 'field', 'heLLo' ) )
+        expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+      end
     end
+
+    ###########################################################################
+
   end
 
+  #############################################################################
+  # Although the queries in this section can match things other than dates
+  # easily - e.g. compare integers or strings - they were created initially
+  # for date comparisons so the seed data for tests is based on dates only.
   #############################################################################
 
-  context '#ci_match_postgres' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.ci_match_postgres()
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'a ILIKE ? AND a IS NOT NULL', 'B' ] )
-    end
+  context 'difference' do
+    before :each do
+      @tn = Time.now.round()
+      @t1 = RSpecModelSearchHelperTest.create( :created_at => @tn           )
+      @t2 = RSpecModelSearchHelperTest.create( :created_at => @tn           )
+      @t3 = RSpecModelSearchHelperTest.create( :created_at => @tn - 1.month )
+      @t4 = RSpecModelSearchHelperTest.create( :created_at => @tn - 1.month )
+      @t5 = RSpecModelSearchHelperTest.create( :created_at => @tn - 1.year  )
+      @t6 = RSpecModelSearchHelperTest.create( :created_at => @tn - 1.year  )
+      @t7 = RSpecModelSearchHelperTest.create
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.ci_match_postgres( :bar )
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'bar ILIKE ? AND bar IS NOT NULL', 'B' ] )
+      sql = "UPDATE r_spec_model_search_helper_tests SET created_at=NULL WHERE id=#{ @t7.id }"
+      ActiveRecord::Base.connection.execute( sql )
     end
 
-    it 'finds expected things' do
-      result = find( described_class.ci_match_postgres.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+    ###########################################################################
 
-      result = find( described_class.ci_match_postgres.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+    context '#cs_lt' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.cs_lt()
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'a < ? AND a IS NOT NULL', 'b' ] )
+      end
 
-      result = find( described_class.ci_match_postgres.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [] )
+      it 'generates expected one-input-parameter output' do
+        result = described_class.cs_lt( :bar )
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'bar < ? AND bar IS NOT NULL', 'b' ] )
+      end
 
-      result = find( described_class.ci_match_postgres.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [] )
+      it 'finds expected things' do
+        result = find( described_class.cs_lt.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [ @t3, @t4, @t5, @t6 ] )
 
-      result = find( described_class.ci_match_postgres.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
-    end
+        result = find( described_class.cs_lt.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t5, @t6 ] )
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.ci_match_postgres.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.cs_lt.call( 'created_at', ( @tn + 1.month ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6 ] )
 
-      result = find_not( described_class.ci_match_postgres.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.cs_lt.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [] )
 
-      result = find_not( described_class.ci_match_postgres.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.cs_lt.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [] )
+      end
 
-      result = find_not( described_class.ci_match_postgres.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f1, @f2, @f3, @f4, @f5, @f6, @f7, @f8 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.cs_lt.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [ @t1, @t2, @t7 ] )
 
-      result = find_not( described_class.ci_match_postgres.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f1,                @f5, @f6, @f7, @f8 ] )
-    end
-  end
+        result = find_not( described_class.cs_lt.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t7 ] )
 
-  #############################################################################
+        result = find_not( described_class.cs_lt.call( 'created_at', ( @tn + 1.month ) ) )
+        expect( result ).to match_array( [ @t7 ] )
 
-  context '#ciaw_match_postgres' do
-    it 'generates expected no-input-parameter output' do
-      result = described_class.ciaw_match_postgres()
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'a ILIKE ? AND a IS NOT NULL', '%B%' ] )
+        result = find_not( described_class.cs_lt.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6, @t7 ] )
+
+        result = find_not( described_class.cs_lt.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6, @t7 ] )
+      end
     end
 
-    it 'generates expected one-input-parameter output' do
-      result = described_class.ciaw_match_postgres( :bar )
-      expect( result.call( 'a', 'B' ) ).to eq( [ 'bar ILIKE ? AND bar IS NOT NULL', '%B%' ] )
+    ###########################################################################
+
+    context '#cs_lte' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.cs_lte()
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'a <= ? AND a IS NOT NULL', 'b' ] )
+      end
+
+      it 'generates expected one-input-parameter output' do
+        result = described_class.cs_lte( :bar )
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'bar <= ? AND bar IS NOT NULL', 'b' ] )
+      end
+
+      it 'finds expected things' do
+        result = find( described_class.cs_lte.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6 ] )
+
+        result = find( described_class.cs_lte.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t5, @t6 ] )
+
+        result = find( described_class.cs_lte.call( 'created_at', ( @tn + 1.month ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6 ] )
+
+        result = find( described_class.cs_lte.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [ @t5, @t6 ] )
+
+        result = find( described_class.cs_lte.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [] )
+      end
+
+      it 'finds expected things negated' do
+        result = find_not( described_class.cs_lte.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [ @t7 ] )
+
+        result = find_not( described_class.cs_lte.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t7 ] )
+
+        result = find_not( described_class.cs_lte.call( 'created_at', ( @tn + 1.month ) ) )
+        expect( result ).to match_array( [ @t7 ] )
+
+        result = find_not( described_class.cs_lte.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t7 ] )
+
+        result = find_not( described_class.cs_lte.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6, @t7 ] )
+      end
     end
 
-    it 'finds expected things' do
-      result = find( described_class.ciaw_match_postgres.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+    ###########################################################################
 
-      result = find( described_class.ciaw_match_postgres.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+    context '#cs_gt' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.cs_gt()
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'a > ? AND a IS NOT NULL', 'b' ] )
+      end
+
+      it 'generates expected one-input-parameter output' do
+        result = described_class.cs_gt( :bar )
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'bar > ? AND bar IS NOT NULL', 'b' ] )
+      end
+
+      it 'finds expected things' do
+        result = find( described_class.cs_gt.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [] )
+
+        result = find( described_class.cs_gt.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4 ] )
+
+        result = find( described_class.cs_gt.call( 'created_at', ( @tn - 1.month ) ) )
+        expect( result ).to match_array( [ @t1, @t2 ] )
+
+        result = find( described_class.cs_gt.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4 ] )
+
+        result = find( described_class.cs_gt.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6 ] )
+      end
 
-      result = find( described_class.ciaw_match_postgres.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+      it 'finds expected things negated' do
+        result = find_not( described_class.cs_gt.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6, @t7 ] )
 
-      result = find( described_class.ciaw_match_postgres.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+        result = find_not( described_class.cs_gt.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t5, @t6, @t7 ] )
 
-      result = find( described_class.ciaw_match_postgres.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f2, @f3, @f4 ] )
+        result = find_not( described_class.cs_gt.call( 'created_at', ( @tn - 1.month ) ) )
+        expect( result ).to match_array( [ @t3, @t4, @t5, @t6, @t7 ] )
+
+        result = find_not( described_class.cs_gt.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [ @t5, @t6, @t7 ] )
+
+        result = find_not( described_class.cs_gt.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [ @t7 ] )
+      end
     end
 
-    it 'finds expected things negated' do
-      result = find_not( described_class.ciaw_match_postgres.call( 'field', 'hello' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+    ###########################################################################
 
-      result = find_not( described_class.ciaw_match_postgres.call( 'field', 'HELLO' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+    context '#cs_gte' do
+      it 'generates expected no-input-parameter output' do
+        result = described_class.cs_gte()
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'a >= ? AND a IS NOT NULL', 'b' ] )
+      end
 
-      result = find_not( described_class.ciaw_match_postgres.call( 'field', 'hell' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+      it 'generates expected one-input-parameter output' do
+        result = described_class.cs_gte( :bar )
+        expect( result.call( 'a', 'b' ) ).to eq( [ 'bar >= ? AND bar IS NOT NULL', 'b' ] )
+      end
 
-      result = find_not( described_class.ciaw_match_postgres.call( 'field', 'llo' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+      it 'finds expected things' do
+        result = find( described_class.cs_gte.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [ @t1, @t2 ] )
 
-      result = find_not( described_class.ciaw_match_postgres.call( 'field', 'heLLo' ) )
-      expect( result ).to match_array( [ @f1, @f5, @f6, @f7, @f8 ] )
+        result = find( described_class.cs_gte.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4 ] )
+
+        result = find( described_class.cs_gte.call( 'created_at', ( @tn - 1.month ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4 ] )
+
+        result = find( described_class.cs_gte.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6 ] )
+
+        result = find( described_class.cs_gte.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [ @t1, @t2, @t3, @t4, @t5, @t6 ] )
+      end
+
+      it 'finds expected things negated' do
+        result = find_not( described_class.cs_gte.call( 'created_at', @tn ) )
+        expect( result ).to match_array( [ @t3, @t4, @t5, @t6, @t7 ] )
+
+        result = find_not( described_class.cs_gte.call( 'created_at', ( @tn - 2.months ) ) )
+        expect( result ).to match_array( [ @t5, @t6, @t7 ] )
+
+        result = find_not( described_class.cs_gte.call( 'created_at', ( @tn - 1.month ) ) )
+        expect( result ).to match_array( [ @t5, @t6, @t7 ] )
+
+        result = find_not( described_class.cs_gte.call( 'created_at', ( @tn - 1.year ) ) )
+        expect( result ).to match_array( [ @t7 ] )
+
+        result = find_not( described_class.cs_gte.call( 'created_at', ( @tn - 2.years ) ) )
+        expect( result ).to match_array( [ @t7 ] )
+      end
     end
+
+    ###########################################################################
+
   end
 end