suit 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+
+gem "activesupport", ">= 2.3.5"
+gem "rspec", "~> 2.8.0"
+gem "factory_girl", ">= 1.3.0"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.8.3"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,40 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.1.3)
+      multi_json (~> 1.0)
+    diff-lcs (1.1.3)
+    factory_girl (2.3.2)
+      activesupport
+    git (1.2.5)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.5)
+    multi_json (1.0.4)
+    rake (0.9.2.2)
+    rcov (1.0.0)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 2.3.5)
+  bundler (~> 1.0.0)
+  factory_girl (>= 1.3.0)
+  jeweler (~> 1.8.3)
+  rcov
+  rdoc (~> 3.12)
+  rspec (~> 2.8.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Justin Ball
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,53 @@
+= suit
+
+A set of rspec scope matchers.
+
+== Matchers for common controller methods:
+  
+  describe UsersController, "on GET to show with a valid id" do
+
+   it { should require_login :index, :get }
+   it { should require_role('admin', :index, :get) }
+  end
+  
+  
+== Matchers for common active record scopes:
+  
+   scope :by_title, order("title ASC")
+   scope :by_name, order("name ASC")
+   scope :by_newest, order("created_at DESC")
+   scope :by_oldest, order("created_at ASC")
+   scope :by_latest, order("updated_at DESC")
+   scope :newer_than, lambda { |*args| where("created_at > ?", args.first || DateTime.now) }
+   scope :older_than, lambda { |*args| where("created_at < ?", args.first || 1.day.ago.to_s(:db)) }
+   scope :is_public, where(["is_public = ?", true])
+   scope :created_by, lambda { |creator| where("creator_id = ? AND creator_type = ?", creator.id, creator.class.to_s) } }
+   scope :sorted, order("sort ASC")
+   scope :sorted_id, order("id ASC")
+
+ These matchers will test common scopes used in active record models:
+
+   describe User do
+     it { should scope_by_title }
+     it { should scope_by_name }
+     it { should scope_by_latest }
+     it { should scope_by_newest }
+     it { should scope_by_oldest }
+
+     it { should scope_newer_than }
+     it { should scope_older_than }
+
+     it { should scope_is_public }
+
+     it { should scope_created_by }
+
+     it { should sanitize :title }
+     it { should scope_sorted }
+     it { should scope_sorted_id }
+   end
+
+== Copyright
+
+Copyright (c) 2012 Tatemae.com. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "suit"
+  gem.homepage = "http://github.com/tatemae/suit"
+  gem.license = "MIT"
+  gem.summary = "common rspec matchers"
+  gem.description = %Q{A collection of commonly used rspec matchers}
+  gem.email = "justinball@gmail.com"
+  gem.authors = ["Justin Ball"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "suit #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/controllers/matchers.rb

@@ -0,0 +1,19 @@
+$LOAD_PATH << File.dirname(__FILE__) unless $LOAD_PATH.include?(File.dirname(__FILE__))
+
+require 'matchers/login_matcher'
+require 'matchers/role_matcher'
+
+module Suit # :nodoc:
+  module Controllers # :nodoc:
+    # = Matchers for common controller methods:
+    #
+    #   describe UsersController, "on GET to show with a valid id" do
+    #
+    #     it { should require_login :index, :get }
+    #     it { should require_role('admin', :index, :get) }
+    #   end
+    #
+    module Matchers
+    end
+  end
+end

data/lib/controllers/matchers/login_matcher.rb

@@ -0,0 +1,50 @@
+module Suit # :nodoc:
+  module Controllers # :nodoc:
+    module Matchers
+   
+      # Ensure a login is required for the given action
+      # Parameters:
+      #     action      - Name of the action in the control that should require a login ie "index"
+      #     verb        - Method to use to call the action ie :post, :get
+      #     login_url   - Optional url the user should be redirected to if they aren't logged in.  Defaults to '/login'
+      #
+      # Example:
+      #           it { should require_login 'index', :get, '/signup' }
+      def require_login(action, verb, login_url = '/login')
+        RequireLoginMatcher.new(action, verb, login_url, self)
+      end
+      
+      class RequireLoginMatcher
+        
+        def initialize(action, verb, login_url, context)
+          @action = action
+          @verb = verb
+          @login_url = login_url
+          @context = context
+        end
+        
+        def matches?(controller)
+          @controller = controller
+          requires_login?
+        end
+        
+        def failure_message
+          "Expected a #{@action} to #{@action} to require login"
+        end
+
+        def description
+          "require login #{@action}"
+        end
+        
+        private
+        
+          def requires_login?
+            response = @context.send(@verb, @action, :id => 1)
+            @context.send(:assert_redirected_to, @login_url)
+            true
+          end
+      end
+      
+    end
+  end
+end

data/lib/controllers/matchers/role_matcher.rb

@@ -0,0 +1,72 @@
+module Suit # :nodoc:
+  module Controllers # :nodoc:
+    module Matchers
+   
+      # Ensure a role is required for the given action
+      # Parameters:
+      #     role          - Role require to access the url.
+      #     action        - Name of the action in the control that should require a role ie "index"
+      #     verb          - Method to use to call the action ie :post, :get
+      #     flash_message - Flash message indicating that the user was denied access
+      #     role_url      - Optional url the user should be redirected to if they aren't logged in.  Defaults to '/role'
+      #
+      # Example:
+      #           it { should require_role 'index', :get, /access denied/i, '/signup' }
+      def require_role(role, action, verb, flash_message = /permission/i, role_url = '/login')
+        RequireRoleMatcher.new(role, action, verb, role_url, flash_message, self)
+      end
+      
+      class RequireRoleMatcher
+        
+        def initialize(role, action, verb, role_url, flash_message, context)
+          @role = role
+          @action = action
+          @verb = verb
+          @role_url = role_url
+          @context = context
+          @flash_message = flash_message
+        end
+        
+        def matches?(controller)
+          @controller = controller
+          requires_role?
+        end
+        
+        def failure_message
+          "Expected a '#{@action}' to '#{@action}' to require role '#{@role}'"
+        end
+
+        def description
+          "require role #{@action}"
+        end
+        
+        private
+        
+          def requires_role?
+            response = @context.send(@verb, @action, :id => 1)
+            @context.send(:assert_redirected_to, @role_url)
+            if flash.values.any? {|value| value =~ @flash_message }
+              true
+            else
+              false
+            end
+          end
+          
+          def flash
+            return @flash if @flash
+            flash_and_now = @controller.request.session["flash"].dup if @controller.request.session["flash"]
+            flash         = @controller.send(:flash)
+
+            @flash = if @now
+              flash.keys.each {|key| flash_and_now.delete(key) }
+              flash_and_now
+            else
+              flash
+            end
+          end
+          
+      end
+      
+    end
+  end
+end

data/lib/models/matchers.rb

@@ -0,0 +1,53 @@
+$LOAD_PATH << File.dirname(__FILE__) unless $LOAD_PATH.include?(File.dirname(__FILE__))
+
+require 'matchers/suit_matcher_base'
+require 'matchers/scope_creator_matchers'
+require 'matchers/scope_is_public_matchers'
+require 'matchers/scope_ordinal_matchers'
+require 'matchers/scope_sorting_matchers'
+require 'matchers/scope_time_matchers'
+require 'matchers/scope_active_matchers'
+require 'matchers/nested_attribute_matcher'
+require 'matchers/sanitize_matcher'
+
+module Suit # :nodoc:
+  module Models # :nodoc:
+    # = Matchers for common active record scopes:
+    #
+    #   scope :by_title, order("title ASC")
+    #   scope :by_name, order("name ASC")
+    #   scope :by_newest, order("created_at DESC")
+    #   scope :by_oldest, order("created_at ASC")
+    #   scope :by_latest, order("updated_at DESC")
+    #   scope :newer_than, lambda { |*args| where("created_at > ?", args.first || DateTime.now) }
+    #   scope :older_than, lambda { |*args| where("created_at < ?", args.first || 1.day.ago.to_s(:db)) }
+    #   scope :is_public, where(["is_public = ?", true])
+    #   scope :created_by, lambda { |creator| where("creator_id = ? AND creator_type = ?", creator.id, creator.class.to_s) } }
+    #   scope :sorted, order("sort ASC")
+    #   scope :sorted_id, order("id ASC")
+    #
+    # These matchers will test common scopes used in active record models:
+    #
+    #   describe User do
+    #     it { should scope_by_title }
+    #     it { should scope_by_name }
+    #     it { should scope_by_latest }
+    #     it { should scope_by_newest }
+    #     it { should scope_by_oldest }
+    
+    #     it { should scope_newer_than }
+    #     it { should scope_older_than }
+    
+    #     it { should scope_is_public }
+    
+    #     it { should scope_created_by }
+    
+    #     it { should sanitize :title }
+    #     it { should scope_sorted }
+    #     it { should scope_sorted_id }
+    #   end
+    
+    module Matchers
+    end
+  end
+end

data/lib/models/matchers/nested_attribute_matcher.rb

@@ -0,0 +1,33 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+
+      # Ensures that the model can accept nested attributes for the given model
+      def accept_nested_attributes_for(nested_model)
+        NestedAttributeMatcher.new(nested_model)
+      end
+      
+      class NestedAttributeMatcher < SuitMatcherBase # :nodoc:
+        
+        def initialize(nested_model)
+          @nested_model = nested_model
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          @subject.methods.include?("#{@nested_model}_attributes=")
+        end
+        
+        def failure_message
+          "#{factory_name} does not accept nested attributes for #{@nested_model}"
+        end
+        
+        def description
+          "accepts nested attributes for"
+        end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/sanitize_matcher.rb

@@ -0,0 +1,59 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+
+      # Ensures that the model sanitizes the given attributes
+      def sanitize(attribute)
+        SanitizeMatcher.new(attribute)
+      end
+      
+      class SanitizeMatcher < SuitMatcherBase # :nodoc:
+        
+        def initialize(attribute)
+          @attribute = attribute
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          sanitizes?
+        end
+        
+        def failure_message
+          "#{factory_name} does not correctly sanitize the attribute #{@attribute}"
+        end
+        
+        def description
+          "sanitizes attribute"
+        end
+        
+        private
+        
+          def sanitizes?
+            bad_scripts = [
+              %|';alert(String.fromCharCode(88,83,83))//\';alert(String.fromCharCode(88,83,83))//";alert(String.fromCharCode(88,83,83))//\";alert(String.fromCharCode(88,83,83))//--></SCRIPT>">'><SCRIPT>alert(String.fromCharCode(88,83,83))</SCRIPT>|,
+              %|'';!--"<XSS>=&{()}|,
+              %|<SCRIPT SRC=http://ha.ckers.org/xss.js></SCRIPT>|,
+              %|<IMG SRC="javascript:alert('XSS');">|,
+              %|<IMG SRC=javascript:alert('XSS')>|,
+              %|<IMG SRC=JaVaScRiPt:alert('XSS')>|,
+              %|<IMG SRC=JaVaScRiPt:alert('XSS')>|,
+              %|<IMG SRC=`javascript:alert("RSnake says, 'XSS'")`>|,
+              %|<IMG """><SCRIPT>alert("XSS")</SCRIPT>">|,
+              %|<IMG SRC=javascript:alert(String.fromCharCode(88,83,83))>|,
+              %|<A HREF="h
+              tt	p://6&#9;6.000146.0x7.147/">XSS</A>|,
+              %|<script>alert('message');</script>| ]
+            bad_scripts.each do |bad_value|
+              @subject.send("#{@attribute}=", bad_value)
+              @subject.save
+              clean_value = @subject.send(@attribute)
+              return false if clean_value.include?(bad_value)
+            end
+            true            
+          end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/scope_active_matchers.rb

@@ -0,0 +1,43 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+      
+      # 'active' named scope which indicates whether an item is active or not
+      # requires that the class have a factory
+      # Tests:
+      #   scope :newer_than, lambda { |time| {:conditions => ["created_at < ?", time || 1.day.ago] } }
+      # Examples:
+      #   it { should scope_active }
+      def scope_active
+        ActiveMatcher.new(:active)
+      end
+            
+      class ActiveMatcher < SuitMatcherBase # :nodoc:
+
+        def initialize(scope, field = :active)
+          @scope = scope
+          @field = field
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          @subject.class.delete_all
+          active_item = Factory(factory_name, @field => true)
+          not_active_item = Factory(factory_name, @field => false)
+          @subject.class.send(@scope).include?(active_item) &&
+            !@subject.class.send(@scope).include?(not_active_item)
+        end
+        
+        def failure_message
+          "Expected #{factory_name} to scope by #{@scope} on #{@field} and only find active items. But the call failed"
+        end
+        
+        def description
+          "active items"
+        end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/scope_creator_matchers.rb

@@ -0,0 +1,65 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+
+      # Ensures that the model can scope by 'source'
+      # requires that the class have a factory and that a user factory exist
+      # Tests:
+      #   scope :created_by, lambda { |item_object| {:conditions => ["items.source_id = ? AND items.source_type = ?", item_object.id, item_object.class.to_s] } }  
+      # Examples:
+      #   it { should scope_created_by }
+      def scope_source
+        CreatedByMatcher.new(:source, :source)
+      end
+            
+      # Ensures that the model can scope by created_by
+      # requires that the class have a factory and that a user factory exist
+      # Tests:
+      #   scope :created_by, lambda { |user| where(['user_id = ?', user.id]) } }
+      # Examples:
+      #   it { should scope_created_by }
+      def scope_created_by
+        CreatedByMatcher.new(:created_by, :user)
+      end
+
+      # Ensures that the model can scope by created_by
+      # requires that the class have a factory and that a user factory exist
+      # Tests:
+      #   scope :by_creator, lambda { |creator| where(['creator_id = ?', creator.id]) } }
+      # Examples:
+      #   it { should scope_by_creator }
+      def scope_by_creator
+        CreatedByMatcher.new(:by_creator, :creator)
+      end
+      
+      class CreatedByMatcher < SuitMatcherBase # :nodoc:
+        
+        def initialize(scope, field)
+          @scope = scope
+          @field = field
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          @subject.class.delete_all
+          @user = Factory(:user)
+          @user1 = Factory(:user)
+          @item = Factory(factory_name, @field => @user)
+          @item1 = Factory(factory_name, @field => @user1)
+          items = @subject.class.send(@scope, @user)
+          items.include?(@item) && !items.include?(@item1)
+        end
+        
+        def failure_message
+          "Expected #{factory_name} to have scope created_by and to be able to successfully find #{@subject}'s creator"
+        end
+        
+        def description
+          "scope created_by"
+        end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/scope_is_public_matchers.rb

@@ -0,0 +1,43 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+      
+      # 'is_public' named scope which retrieves items that are marked public
+      # requires that the class have a factory
+      # Tests:
+      #   scope :newer_than, lambda { |time| {:conditions => ["created_at < ?", time || 1.day.ago] } }
+      # Examples:
+      #   it { should scope_is_public }
+      def scope_is_public
+        IsPublicMatcher.new(:is_public)
+      end
+            
+      class IsPublicMatcher < SuitMatcherBase # :nodoc:
+
+        def initialize(scope, field = :is_public)
+          @scope = scope
+          @field = field
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          @subject.class.delete_all
+          public_item = Factory(factory_name, @field => true)
+          not_public_item = Factory(factory_name, @field => false)
+          @subject.class.send(@scope).include?(public_item) &&
+            !@subject.class.send(@scope).include?(not_public_item)
+        end
+        
+        def failure_message
+          "Expected #{factory_name} to scope by #{@scope} on #{@field} and only find public items. But the call failed"
+        end
+        
+        def description
+          "public items"
+        end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/scope_ordinal_matchers.rb

@@ -0,0 +1,47 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+      
+      # Ensures that the model can sort by 'sorted'
+      # requires that the class have a factory
+      # Tests:
+      #   scope :sorted, order("sort ASC")
+      # Examples:
+      #   it { should scope_sorted }
+      def scope_sorted
+        OrdinalMatcher.new(:sorted, :sort)
+      end
+
+      #   it { should scope_sorted_id }
+      def scope_sorted_id
+        OrdinalMatcher.new(:sorted_id, :sort)
+      end
+
+      class OrdinalMatcher < SuitMatcherBase # :nodoc:
+
+        def initialize(scope, field)
+          @scope = scope
+          @field = field
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          @subject.class.delete_all
+          @first = Factory(factory_name, @field => 1)
+          @second = Factory(factory_name, @field => 2)
+          @first == @subject.class.send(@scope)[0] && @second == @subject.class.send(@scope)[1]
+        end
+        
+        def failure_message
+          "Expected #{factory_name} to have scope #{@scope} and order by #{@field}"
+        end
+        
+        def description
+          "sort by ordinal"
+        end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/scope_sorting_matchers.rb

@@ -0,0 +1,95 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+      
+      # Ensures that the model can sort by_title
+      # requires that the class have a factory
+      # Tests:
+      #   scope :by_title, order("title ASC")
+      # Examples:
+      #   it { should scope_by_title }
+      def scope_by_title
+        SortingMatcher.new(:by_title, :title)
+      end
+
+      # Test for 'by_name' named scope which orders by name
+      # requires that the class have a shoulda factory
+      # Tests:
+      #   scope :by_name, order("name ASC")
+      # Examples:
+      #   it { should scope_by_name }
+      def scope_by_name
+        SortingMatcher.new(:by_name, :name)
+      end
+      
+      # For 'by_latest named scope which orders by updated at:
+      # Tests:
+      #   scope :by_latest, order("updated_at DESC")
+      # Examples:
+      #   it { should scope_by_latest }
+      def scope_by_latest
+        SortingMatcher.new(:by_latest, :updated_at)
+      end
+
+      # Test for 'by_newest' named scope which orders by 'created_at DESC'
+      # requires that the class have a shoulda factory
+      # Tests:
+      #   scope :by_newest, order("created_at DESC")
+      # Examples:
+      #   it { should scope_by_newest }
+      def scope_by_newest
+        SortingMatcher.new(:by_newest, :created_at)
+      end
+     
+      # Test for 'by_oldest' named scope which orders by 'created_at ASC'
+      # requires that the class have a shoulda factory
+      # Tests:
+      #   scope :oldest, order("created_at ASC")
+      # Examples:
+      #   it { should scope_oldest }
+      def scope_by_oldest
+        SortingMatcher.new(:by_oldest, :created_at)
+      end
+
+      class SortingMatcher < SuitMatcherBase # :nodoc:
+
+        def initialize(scope, field)
+          @scope = scope
+          @field = field
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          @subject.class.delete_all
+          if @scope == :by_newest
+            first = Factory(factory_name, :created_at => 1.hour.ago)
+            second = Factory(factory_name, :created_at => 1.day.ago)
+            first == @subject.class.send(@scope)[0] && second == @subject.class.send(@scope)[1]
+          elsif @scope == :by_oldest
+            first = Factory(factory_name, :created_at => 1.day.ago)
+            second = Factory(factory_name, :created_at => 1.hour.ago)
+            first == @subject.class.send(@scope)[0] && second == @subject.class.send(@scope)[1]            
+          elsif @scope == :by_latest
+            first = Factory(factory_name, :updated_at => 1.hour.ago)
+            second = Factory(factory_name, :updated_at => 1.day.ago)
+            first == @subject.class.send(@scope)[0] && second == @subject.class.send(@scope)[1]
+          else
+            first = Factory(factory_name, @field => 'a')
+            second = Factory(factory_name, @field => 'b')
+            first == @subject.class.send(@scope)[0] && second == @subject.class.send(@scope)[1]
+          end
+        end
+        
+        def failure_message
+          "Expected #{factory_name} to scope #{@scope} on #{@field}"
+        end
+        
+        def description
+          "sorting"
+        end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/scope_time_matchers.rb

@@ -0,0 +1,59 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+      
+      # 'newer_than' named scope which retrieves items newer than given date
+      # requires that the class have a factory
+      # Tests:
+      #   scope :newer_than, lambda { |time| {:conditions => ["created_at < ?", time || 1.day.ago] } }
+      # Examples:
+      #   it { should scope_recent }
+      def scope_newer_than
+        TimeMatcher.new(:newer_than)
+      end
+
+      # 'scope_older_than' named scope which retrieves items older than the given date
+      # requires that the class have a factory
+      # Tests:
+      #   scope :newer_than, lambda { |time| {:conditions => ["created_at < ?", time || 1.day.ago] } }
+      # Examples:
+      #   it { should scope_recent }
+      def scope_older_than
+        TimeMatcher.new(:older_than)
+      end
+            
+      class TimeMatcher < SuitMatcherBase # :nodoc:
+
+        def initialize(scope, field = :created_at)
+          @scope = scope
+          @field = field
+        end
+        
+        def matches?(subject)
+          @subject = subject
+          @subject.class.delete_all
+          old_item = Factory(factory_name, @field => 1.month.ago)
+          new_item = Factory(factory_name, @field => 1.day.ago)
+          items = @subject.class.send(@scope, 1.week.ago)          
+          if @scope == :newer_than
+            items.include?(new_item) && !items.include?(old_item)
+          elsif @scope == :older_than
+            !items.include?(new_item) && items.include?(old_item)
+          else
+            raise "matcher not implemented for #{@scope}"
+          end
+        end
+        
+        def failure_message
+          "Expected #{factory_name} to scope by #{@scope} on #{@field} and be successful. But the call failed"
+        end
+        
+        def description
+          "items scoped #{@scope}"
+        end
+          
+      end
+
+    end
+  end
+end

data/lib/models/matchers/suit_matcher_base.rb

@@ -0,0 +1,17 @@
+module Suit # :nodoc:
+  module Models # :nodoc:
+    module Matchers
+      
+      class SuitMatcherBase # :nodoc:
+
+        private
+          
+          def factory_name
+            @subject.class.name.underscore.to_sym
+          end
+      
+      end
+      
+    end
+  end
+end

data/lib/suit.rb

@@ -0,0 +1,19 @@
+$LOAD_PATH << File.dirname(__FILE__) unless $LOAD_PATH.include?(File.dirname(__FILE__))
+
+module Suit
+end
+
+require 'rspec/core'
+require 'rspec/mocks'
+require 'rspec/expectations'
+
+require 'factory_girl'
+require 'suit_factories'
+require 'models/matchers'
+require 'controllers/matchers'
+
+RSpec.configure do |config|
+  config.include(Suit::Models::Matchers)
+  config.include(Suit::Controllers::Matchers)
+  config.color_enabled = true
+end

data/lib/suit_factories.rb

@@ -0,0 +1,45 @@
+FactoryGirl.define do
+  
+  sequence :email do |n|
+    "somebody#{n}@example.com"
+  end
+
+  sequence :login do |n|
+    "inquire#{n}"
+  end
+
+  sequence :password do |n|
+    "password#{n}"
+  end
+  
+  sequence :name do |n|
+    "a_name#{n}"
+  end
+
+  sequence :title do |n|
+    "a_title#{n}"
+  end
+
+  sequence :abbr do |n|
+    "abbr#{n}"
+  end
+
+  sequence :uri do |n|
+    "n#{n}.example.com"
+  end
+
+  sequence :description do |n|
+    "This is the description: #{n}"
+  end
+
+  sequence :locale do |n|
+    "a#{n}"
+  end
+
+  sequence :address do |n|
+    "#{n} West #{n} South"
+  end
+ 
+end
+
+

data/spec/controllers/matchers/login_matcher_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe Suit::Controllers:::Matchers do
+  describe "require_login" do
+    it "ensures that login is required" do
+    
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'suit'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/suit.gemspec

@@ -0,0 +1,86 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "suit"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Justin Ball"]
+  s.date = "2012-02-07"
+  s.description = "A collection of commonly used rspec matchers"
+  s.email = "justinball@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".DS_Store",
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/.DS_Store",
+    "lib/controllers/matchers.rb",
+    "lib/controllers/matchers/.DS_Store",
+    "lib/controllers/matchers/login_matcher.rb",
+    "lib/controllers/matchers/role_matcher.rb",
+    "lib/models/matchers.rb",
+    "lib/models/matchers/nested_attribute_matcher.rb",
+    "lib/models/matchers/sanitize_matcher.rb",
+    "lib/models/matchers/scope_active_matchers.rb",
+    "lib/models/matchers/scope_creator_matchers.rb",
+    "lib/models/matchers/scope_is_public_matchers.rb",
+    "lib/models/matchers/scope_ordinal_matchers.rb",
+    "lib/models/matchers/scope_sorting_matchers.rb",
+    "lib/models/matchers/scope_time_matchers.rb",
+    "lib/models/matchers/suit_matcher_base.rb",
+    "lib/suit.rb",
+    "lib/suit_factories.rb",
+    "spec/controllers/matchers/login_matcher_spec.rb",
+    "spec/spec_helper.rb",
+    "suit.gemspec"
+  ]
+  s.homepage = "http://github.com/tatemae/suit"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.12"
+  s.summary = "common rspec matchers"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.5"])
+      s.add_runtime_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_runtime_dependency(%q<factory_girl>, [">= 1.3.0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 2.3.5"])
+      s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_dependency(%q<factory_girl>, [">= 1.3.0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 2.3.5"])
+    s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+    s.add_dependency(%q<factory_girl>, [">= 1.3.0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,202 @@
+--- !ruby/object:Gem::Specification 
+name: suit
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Justin Ball
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-02-07 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 3
+        - 5
+        version: 2.3.5
+  version_requirements: *id001
+  name: activesupport
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 47
+        segments: 
+        - 2
+        - 8
+        - 0
+        version: 2.8.0
+  version_requirements: *id002
+  name: rspec
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  version_requirements: *id003
+  name: factory_girl
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 3
+        - 12
+        version: "3.12"
+  version_requirements: *id004
+  name: rdoc
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  version_requirements: *id005
+  name: bundler
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 49
+        segments: 
+        - 1
+        - 8
+        - 3
+        version: 1.8.3
+  version_requirements: *id006
+  name: jeweler
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id007
+  name: rcov
+  prerelease: false
+description: A collection of commonly used rspec matchers
+email: justinball@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .DS_Store
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/.DS_Store
+- lib/controllers/matchers.rb
+- lib/controllers/matchers/.DS_Store
+- lib/controllers/matchers/login_matcher.rb
+- lib/controllers/matchers/role_matcher.rb
+- lib/models/matchers.rb
+- lib/models/matchers/nested_attribute_matcher.rb
+- lib/models/matchers/sanitize_matcher.rb
+- lib/models/matchers/scope_active_matchers.rb
+- lib/models/matchers/scope_creator_matchers.rb
+- lib/models/matchers/scope_is_public_matchers.rb
+- lib/models/matchers/scope_ordinal_matchers.rb
+- lib/models/matchers/scope_sorting_matchers.rb
+- lib/models/matchers/scope_time_matchers.rb
+- lib/models/matchers/suit_matcher_base.rb
+- lib/suit.rb
+- lib/suit_factories.rb
+- spec/controllers/matchers/login_matcher_spec.rb
+- spec/spec_helper.rb
+- suit.gemspec
+homepage: http://github.com/tatemae/suit
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: common rspec matchers
+test_files: []
+