rspec_validation_expectations 0.5

data/CHANGELOG

@@ -0,0 +1,5 @@
+5/5/09 - Added scaffolding for future tests [Matthew Bass]
+
+4/16/09 - Added it_should_protect expectation [Matthew Bass]
+
+8/14/08 - Initial import [Matthew Bass]

data/MIT-LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2007-2008 Matthew Bass (http://matthewbass.com)
+
+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

@@ -0,0 +1,71 @@
+= rspec_validation_expectations
+
+Adds several handy expectations for testing ActiveRecord model validations and associations.
+
+== Dependencies
+
+Requires the validation_reflection plugin:
+
+  script/plugin install git://github.com/redinger/validation_reflection.git
+
+== Installation
+
+Install the gem directly:
+
+  sudo gem install pelargir-rspec_validation_expectations --source=http://gems.github.com
+  
+Or install the gem in your Rails project:
+  
+  script/plugin install git://github.com/pelargir/rspec_validation_expectations.git
+
+Or clone the project:
+
+  git clone git://github.com/pelargir/rspec_validation_expectations.git
+
+== Usage
+
+Ensure that validations and assocations are properly defined in your models:
+
+  describe User do
+    it_should_validate_presence_of     :first_name, :last_name, :email
+    it_should_validate_numericality_of :zip
+    it_should_validate_uniqueness_of   :email
+    it_should_validate_inclusion_of    :gender, :in => %w(Male Female)
+    
+    # tests that User.count increases by 1
+    it_should_be_createable :with => {:first_name => 'Ed', :last_name => 'The Duck', :email => 'a@b.com'}
+    
+    it_should_belong_to :employer
+    it_should_have_many :friends, :romans, :countrymen
+    it_should_have_one  :account
+    it_should_have_and_belong_to_many :comments
+    
+    # tests that the attribute is protected
+    it_should_protect :email
+  end
+  
+Which gives you:
+
+  ruby script/spec --format s spec/models/user_spec.rb:
+
+  User
+  - should validate presence of first name
+  - should validate presence of last name
+  - should validate presence of email
+  - should validate numericality of zip
+  - should validate uniqueness of email
+  - should validate inclusion of gender as one of Male or Female
+  - should be creatable
+  - should belong to employer
+  - should have many friends
+  - should have many romans
+  - should have many countrymen
+  - should have one account
+  - should have and belong to many comments
+  - should protect email
+
+== Resources
+
+Repository: http://github.com/pelargir/rspec_validation_expectations/
+Blog: http://matthewbass.com
+Author: Matthew Bass

data/Rakefile

@@ -0,0 +1,13 @@
+require "rake"
+require "spec/rake/spectask"
+
+task :default => :spec
+
+Spec::Rake::SpecTask.new do |spec|
+  spec.spec_files = FileList["spec/**/*_spec.rb"]
+  spec.spec_opts << "--color"
+  spec.libs += ["lib", "spec"]
+  spec.rcov = true
+  spec.rcov_opts = ["--exclude", "spec/**/*"]
+  spec.rcov_dir = "rcov"
+end

data/init.rb

@@ -0,0 +1 @@
+require 'rspec_validation_expectations'

data/lib/rspec_validation_expectations.rb

@@ -0,0 +1,5 @@
+require 'spec/rails/matchers/associations'
+
+require 'rspec_validation_expectations/validation_expectations'
+require 'rspec_validation_expectations/association_expectations'
+require 'rspec_validation_expectations/other_expectations'

data/lib/rspec_validation_expectations/association_expectations.rb

@@ -0,0 +1,35 @@
+def it_should_belong_to *one_or_more_associations
+  model_name = described_type
+  one_or_more_associations.each do |association|
+    it "should belong to #{association}" do
+      model_name.should belong_to(association)
+    end
+  end
+end
+
+def it_should_have_many *one_or_more_associations
+  model_name = described_type
+  one_or_more_associations.each do |association|
+    it "should have many #{association}" do
+      model_name.should have_many(association)
+    end
+  end
+end
+
+def it_should_have_and_belong_to_many *one_or_more_associations
+  model_name = described_type
+  one_or_more_associations.each do |association|
+    it "should have and belong to many #{association}" do
+      model_name.should have_and_belong_to_many(association)
+    end
+  end
+end
+
+def it_should_have_one *one_or_more_associations
+  model_name = described_type
+  one_or_more_associations.each do |association|
+    it "should have one #{association}" do
+      model_name.should have_one(association)
+    end
+  end
+end

data/lib/rspec_validation_expectations/other_expectations.rb

@@ -0,0 +1,8 @@
+def it_should_protect(*one_or_more_attrs)
+  model_class = described_type
+  one_or_more_attrs.each do |attr|
+    it "should protect attribute #{attr}" do
+      model_class.protected_attributes.should include(attr.to_s)
+    end
+  end
+end

data/lib/rspec_validation_expectations/validation_expectations.rb

@@ -0,0 +1,46 @@
+module ValidationExpectations
+
+  BasicValidations = [:presence, :acceptance, :numericality, :format, :length, :confirmation, :uniqueness]
+  InListValidations = [:exclusion, :inclusion]
+
+  BasicValidations.each do |method|
+    define_method("it_should_validate_#{method}_of") do |*one_or_more_fields|
+      options = one_or_more_fields.last.is_a?(Hash) ? one_or_more_fields.pop : {}
+      model_name = described_type
+      one_or_more_fields.each do |field|
+        it "should validate #{method} of #{field.to_s.humanize.downcase}" do
+          validations = model_name.reflect_on_all_validations
+          validations = validations.select { |e| e.macro == "validates_#{method}_of".to_sym }
+          validations.collect(&:name).should include(field)
+          validations.collect(&:options).should include(options)
+        end
+      end
+    end
+  end
+
+  InListValidations.each do |method|
+    define_method("it_should_validate_#{method}_of") do |*one_or_more_fields|
+      options = one_or_more_fields.last.is_a?(Hash) ? one_or_more_fields.pop : {}
+      model_name = described_type
+      one_or_more_fields.each do |field|
+        it "should validate #{method} of #{field.to_s.humanize.downcase} as one of #{options[:in].to_sentence(:words_connector => 'or', :last_word_connector => true)}" do
+          validations = model_name.reflect_on_all_validations
+          validation = validations.detect { |v| v.macro == "validates_#{method}_of".to_sym && v.name == field }
+          validation.options[:in].sort.should == options[:in].sort unless validation.nil?
+        end
+      end
+    end
+  end
+
+end
+
+include ValidationExpectations
+
+def it_should_be_createable *args
+  model_name = described_type
+  attributes = args.last.is_a?(Hash) ? args.last[:with] : {}
+
+  it "should be creatable" do
+    lambda { model_name.create attributes }.should change(model_name, :count).by(1)
+  end
+end

data/lib/spec/rails/matchers/associations.rb

@@ -0,0 +1,36 @@
+# Copied from Josh Knowles' excellent Rspec on Rails Matchers
+# (http://github.com/joshknowles/rspec-on-rails-matchers/tree/master)
+
+module Spec
+  module Example
+    class ExampleGroup
+      def belong_to(association)
+        return simple_matcher("model to belong to #{association}") do |model|
+          model = model.class if model.is_a? ActiveRecord::Base
+          model.reflect_on_all_associations(:belongs_to).find { |a| a.name == association }
+        end
+      end
+
+      def have_many(association)
+        return simple_matcher("model to have many #{association}") do |model|
+          model = model.class if model.is_a? ActiveRecord::Base
+          model.reflect_on_all_associations(:has_many).find { |a| a.name == association }
+        end
+      end
+
+      def have_one(association)
+        return simple_matcher("model to have one #{association}") do |model|
+          model = model.class if model.is_a? ActiveRecord::Base
+          model.reflect_on_all_associations(:has_one).find { |a| a.name == association }
+        end
+      end
+
+      def have_and_belong_to_many(association)
+        return simple_matcher("model to have and belong to many #{association}") do |model|
+          model = model.class if model.is_a? ActiveRecord::Base
+          model.reflect_on_all_associations(:has_and_belongs_to_many).find { |a| a.name == association }
+        end
+      end
+    end
+  end
+end

data/spec/rspec_validation_expectations/association_expectations_spec.rb

@@ -0,0 +1,10 @@
+require "spec_helper"
+
+describe TestClass do
+
+  it_should_belong_to :user_group
+  it_should_have_one :address
+  it_should_have_many :projects
+  it_should_have_and_belong_to_many :groups
+
+end

data/spec/rspec_validation_expectations/other_expectations_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe TestClass do
+
+  it_should_protect :admin
+
+end

data/spec/rspec_validation_expectations/validation_expectations_spec.rb

@@ -0,0 +1,16 @@
+require "spec_helper"
+
+describe TestClass do
+
+  it_should_validate_presence_of :first_name, :last_name
+  it_should_validate_numericality_of :age
+  it_should_validate_uniqueness_of :email
+  it_should_validate_inclusion_of :level, :in => TestClass::Levels
+  it_should_validate_exclusion_of :username, :in => TestClass::BadUsernames
+  it_should_validate_format_of :legacy_code, :with => /\A[a-zA-Z]+\z/
+  it_should_validate_length_of :password, :in => 6..20
+  it_should_validate_confirmation_of :email
+  it_should_validate_acceptance_of :terms_of_service
+  #it_should_be_createable
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require "spec"
+require "rspec_validation_expectations"
+
+require "active_support"
+require "active_record"
+require "validation_reflection"
+
+require "test_class"

data/spec/test_class.rb

@@ -0,0 +1,23 @@
+class TestClass < ActiveRecord::Base
+
+  Levels = %w(beginner intermediate expert)
+  BadUsernames = %w(user admin)
+
+  belongs_to :user_group
+  has_one :address
+  has_many :projects
+  has_and_belongs_to_many :groups
+
+  attr_protected :admin
+
+  validates_presence_of :first_name, :last_name
+  validates_numericality_of :age
+  validates_uniqueness_of :email
+  validates_inclusion_of :level, :in => Levels
+  validates_exclusion_of :username, :in => BadUsernames
+  validates_format_of :legacy_code, :with => /\A[a-zA-Z]+\z/
+  validates_length_of :password, :in => 6..20
+  validates_confirmation_of :email
+  validates_acceptance_of :terms_of_service
+
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+name: rspec_validation_expectations
+version: !ruby/object:Gem::Version 
+  version: "0.5"
+platform: ruby
+authors: 
+- Matthew Bass
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-14 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 2.3.5
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 2.3.5
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: validation_reflection
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 0.3.5
+    version: 
+description: Adds several handy expectations for testing ActiveRecord model validations, similar to what Shoulda provides.
+email: pelargir@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- CHANGELOG
+- MIT-LICENSE
+- Rakefile
+- README
+- init.rb
+- lib/rspec_validation_expectations/association_expectations.rb
+- lib/rspec_validation_expectations/other_expectations.rb
+- lib/rspec_validation_expectations/validation_expectations.rb
+- lib/rspec_validation_expectations.rb
+- lib/spec/rails/matchers/associations.rb
+- spec/rspec_validation_expectations/association_expectations_spec.rb
+- spec/rspec_validation_expectations/other_expectations_spec.rb
+- spec/rspec_validation_expectations/validation_expectations_spec.rb
+- spec/spec_helper.rb
+- spec/test_class.rb
+has_rdoc: true
+homepage: http://github.com/pelargir/rspec_validation_expectations
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: rspec_validation_expectations
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Adds expectations for testing ActiveRecord model validations.
+test_files: []
+