glebtv-mongoid-rspec 1.12.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b2fe5714fda2ed60f7ddfcc3e3435baca3651311
+  data.tar.gz: 7cc78332ecf79fdf911dda3b1d08a690c0235c2b
+SHA512:
+  metadata.gz: 585662e9ca279626b7b93ff82aaf614b954d5a4513f13bb1738276fa6a7c56866d2498252d96e0e6f7f94f760dd1be0b64a5eab763fe891b9563526929b3d9fa
+  data.tar.gz: ff4bccaf1fd97808af64b87622d2f400059d381063c98940f5ba5292ad51c850e7050806a87685e0d23d4929d53794ed750a0e5e2b4c2e7901d7c8c54d51a7fe

data/.document

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

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.rvmrc
+.bundle
+Gemfile.lock
+pkg/*
+

data/.ruby-gemset

@@ -0,0 +1 @@
+mongoid-rspec

data/.ruby-version

@@ -0,0 +1 @@
+2.1.1

data/.travis.yml

@@ -0,0 +1,14 @@
+services: mongodb
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1.1
+  - jruby-20mode
+  - rbx-2.1.1
+  - rbx-19mode
+
+gemfile:
+  - Gemfile
+  - gemfiles/mongoid-3.1.gemfile
+  - gemfiles/mongoid-4.0.gemfile
+

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in mongoid-rspec.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Evan Sagge
+
+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.md

@@ -0,0 +1,203 @@
+mongoid-rspec
+=
+
+[![Build Status](https://secure.travis-ci.org/glebtv/mongoid-rspec.png?branch=master)](https://travis-ci.org/glebtv/mongoid-rspec)
+
+http://rubygems.org/gems/glebtv-mongoid-rspec
+
+RSpec matchers for Mongoid 3.x / 4.x
+
+Installation
+-
+Add to your Gemfile
+
+    gem 'glebtv-mongoid-rspec'
+
+Drop in existing or dedicated support file in spec/support (spec/support/mongoid.rb)
+
+```ruby
+RSpec.configure do |config|
+  config.include Mongoid::Matchers, type: :model
+end
+```
+
+Association Matchers
+-
+
+```ruby
+describe User do
+  it { should have_many(:articles).with_foreign_key(:author_id).ordered_by(:title) }
+
+  it { should have_one(:record) }
+  #can verify autobuild is set to true
+  it { should have_one(:record).with_autobuild }
+
+  it { should have_many :comments }
+
+  #can also specify with_dependent to test if :dependent => :destroy/:destroy_all/:delete is set
+  it { should have_many(:comments).with_dependent(:destroy) }
+  #can verify autosave is set to true
+  it { should have_many(:comments).with_autosave }
+
+  it { should embed_one :profile }
+
+  it { should have_and_belong_to_many(:children) }
+  it { should have_and_belong_to_many(:children).of_type(User) }
+end
+
+describe Profile do
+  it { should be_embedded_in(:user).as_inverse_of(:profile) }
+end
+
+describe Article do
+  it { should belong_to(:author).of_type(User).as_inverse_of(:articles) }
+  it { should belong_to(:author).of_type(User).as_inverse_of(:articles).with_index }
+  it { should embed_many(:comments) }
+end
+
+describe Comment do
+  it { should be_embedded_in(:article).as_inverse_of(:comments) }
+  it { should belong_to(:user).as_inverse_of(:comments) }
+end
+
+describe Record do
+  it { should belong_to(:user).as_inverse_of(:record) }
+end
+
+describe Site do
+  it { should have_many(:users).as_inverse_of(:site).ordered_by(:email.asc) }
+end
+```
+
+Mass Assignment Matcher
+-
+
+```ruby
+describe User do
+  it { should allow_mass_assignment_of(:login) }
+  it { should allow_mass_assignment_of(:email) }
+  it { should allow_mass_assignment_of(:age) }
+  it { should allow_mass_assignment_of(:password) }
+  it { should allow_mass_assignment_of(:password) }
+  it { should allow_mass_assignment_of(:role).as(:admin) }
+
+  it { should_not allow_mass_assignment_of(:role) }
+end
+```
+
+Validation Matchers
+-
+
+```ruby
+describe Site do
+  it { should validate_presence_of(:name) }
+  it { should validate_uniqueness_of(:name) }
+end
+
+describe User do
+  it { should validate_presence_of(:login) }
+  it { should validate_uniqueness_of(:login).scoped_to(:site) }
+  it { should validate_uniqueness_of(:email).case_insensitive.with_message("is already taken") }
+  it { should validate_format_of(:login).to_allow("valid_login").not_to_allow("invalid login") }
+  it { should validate_associated(:profile) }
+  it { should validate_exclusion_of(:login).to_not_allow("super", "index", "edit") }
+  it { should validate_inclusion_of(:role).to_allow("admin", "member") }
+  it { should validate_confirmation_of(:email) }
+  it { should validate_presence_of(:age).on(:create, :update) }
+  it { should validate_numericality_of(:age).on(:create, :update) }
+  it { should validate_inclusion_of(:age).to_allow(23..42).on([:create, :update]) }
+  it { should validate_presence_of(:password).on(:create) }
+  it { should validate_presence_of(:provider_uid).on(:create) }
+  it { should validate_inclusion_of(:locale).to_allow([:en, :ru]) }
+end
+
+describe Article do
+  it { should validate_length_of(:title).within(8..16) }
+end
+
+describe Profile do
+  it { should validate_numericality_of(:age).greater_than(0) }
+end
+
+describe MovieArticle do
+  it { should validate_numericality_of(:rating).to_allow(:greater_than => 0).less_than_or_equal_to(5) }
+  it { should validate_numericality_of(:classification).to_allow(:even => true, :only_integer => true, :nil => false) }
+end
+
+describe Person do
+   # in order to be able to use the custom_validate matcher, the custom validator class (in this case SsnValidator)
+   # should redefine the kind method to return :custom, i.e. "def self.kind() :custom end"
+  it { should custom_validate(:ssn).with_validator(SsnValidator) }
+end
+```
+
+Accepts Nested Attributes Matcher
+-
+
+```ruby
+describe User do
+  it { should accept_nested_attributes_for(:articles) }
+  it { should accept_nested_attributes_for(:comments) }
+end
+
+describe Article do
+  it { should accept_nested_attributes_for(:permalink) }
+end
+```
+
+Index Matcher
+-
+
+```ruby
+describe Article do
+  it { should have_index_for(published: 1) }
+  it { should have_index_for(title: 1).with_options(unique: true, background: true) }
+end
+
+describe Profile do
+  it { should have_index_for(first_name: 1, last_name: 1) }
+end
+```
+
+Others
+-
+
+```ruby
+describe User do
+  it { should have_fields(:email, :login) }
+  it { should have_field(:s).with_alias(:status) }
+  it { should have_fields(:birthdate, :registered_at).of_type(DateTime) }
+
+  # if you're declaring 'include Mongoid::Timestamps'
+  # or any of 'include Mongoid::Timestamps::Created' and 'Mongoid::Timestamps::Updated'
+  it { should be_timestamped_document }
+  it { should be_timestamped_document.with(:created) }
+  it { should_not be_timestamped_document.with(:updated) }
+
+  it { should be_versioned_document } # if you're declaring `include Mongoid::Versioning`
+  it { should be_paranoid_document } # if you're declaring `include Mongoid::Paranoia`
+  it { should be_multiparameted_document } # if you're declaring `include Mongoid::MultiParameterAttributes`
+end
+
+describe Log do
+  it { should be_stored_in :logs }
+end
+
+describe Article do
+  it { should have_field(:published).of_type(Boolean).with_default_value_of(false) }
+  it { should have_field(:allow_comments).of_type(Boolean).with_default_value_of(true) }
+  it { should_not have_field(:allow_comments).of_type(Boolean).with_default_value_of(false) }
+  it { should_not have_field(:number_of_comments).of_type(Integer).with_default_value_of(1) }
+end
+```
+
+Known issues
+-
+
+accept_nested_attributes_for matcher must test options [issue 91](https://github.com/evansagge/mongoid-rspec/issues/91).
+
+Acknowledgement
+-
+Thanks to [Durran Jordan](https://github.com/durran) for providing the changes necessary to make
+this compatible with mongoid 2.0.0.rc, and for other [contributors](https://github.com/evansagge/mongoid-rspec/contributors)
+to this project.

data/Rakefile

@@ -0,0 +1,18 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+task :default => :spec
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = "./spec/**/*_spec.rb"
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = "./spec/**/*_spec.rb"
+  spec.rcov = true
+end
+

data/gemfiles/mongoid-3.1.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "mongoid", github: "mongoid/mongoid", branch: "3.1.0-stable"
+
+gemspec path: "../"

data/gemfiles/mongoid-4.0.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "mongoid", "~> 4.0.0.beta1"
+
+gemspec path: "../"

data/glebtv-mongoid-rspec.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "mongoid-rspec/version"
+
+Gem::Specification.new do |s|
+  s.name        = "glebtv-mongoid-rspec"
+  s.version     = Mongoid::Rspec::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Evan Sagge", "GlebTv"]
+  s.email       = %q{evansagge@gmail.com}
+  s.homepage    = %q{http://github.com/glebtv/mongoid-rspec}
+  s.summary     = %q{RSpec matchers for Mongoid}
+  s.description = %q{RSpec matches for Mongoid models, including association and validation matchers}
+
+  s.rubyforge_project = "mongoid-rspec"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'rake'
+  s.add_dependency 'mongoid', [">= 3.0", "< 4.1"]
+  s.add_dependency 'rspec', '>= 2.14'
+end

data/lib/glebtv-mongoid-rspec.rb

@@ -0,0 +1 @@
+require 'mongoid-rspec'

data/lib/matchers/accept_nested_attributes.rb

@@ -0,0 +1,65 @@
+module Mongoid
+  module Matchers # :nodoc:
+
+    # Ensures that the model can accept nested attributes for the specified
+    # association.
+    #
+    # Example:
+    #   it { should accept_nested_attributes_for(:articles) }
+    #
+    def accept_nested_attributes_for(attribute)
+      AcceptNestedAttributesForMatcher.new(attribute)
+    end
+
+    class AcceptNestedAttributesForMatcher
+
+      def initialize(attribute)
+        @attribute = attribute.to_s
+        @options = {}
+      end
+
+      def matches?(subject)
+        @subject = subject
+        match?
+      end
+
+      def failure_message
+        "Expected #{expectation} (#{@problem})"
+      end
+
+      def negative_failure_message
+        "Did not expect #{expectation}"
+      end
+
+      def description
+        description = "accepts_nested_attributes_for :#{@attribute}"
+      end
+
+      protected
+        def match?
+          exists?
+        end
+
+        def exists?
+          if config
+            true
+          else
+            @problem = 'is not declared'
+            false
+          end
+        end
+
+        def config
+          model_class.nested_attributes["#{@attribute}_attributes"]
+        end
+
+        def model_class
+          @subject.class
+        end
+
+        def expectation
+          "#{model_class.name} to accept nested attributes for #{@attribute}"
+        end
+    end
+  end
+end

data/lib/matchers/allow_mass_assignment.rb

@@ -0,0 +1,101 @@
+# this code is totally extracted from shoulda-matchers gem.
+module Mongoid
+  module Matchers
+    class AllowMassAssignmentOfMatcher # :nodoc:
+      attr_reader :failure_message, :negative_failure_message
+
+      def initialize(attribute)
+        @attribute = attribute.to_s
+        @options = {}
+      end
+
+      def as(role)
+        if active_model_less_than_3_1?
+          raise "You can specify role only in Rails 3.1 or greater"
+        end
+        @options[:role] = role
+        self
+      end
+
+      def matches?(klass)
+        @klass = klass
+        if attr_mass_assignable?
+          if whitelisting?
+            @negative_failure_message = "#{@attribute} was made accessible"
+          else
+            if protected_attributes.empty?
+              @negative_failure_message = "no attributes were protected"
+            else
+              @negative_failure_message = "#{class_name} is protecting " <<
+                "#{protected_attributes.to_a.to_sentence}, " <<
+                "but not #{@attribute}."
+            end
+          end
+          true
+        else
+          if whitelisting?
+            @failure_message = "Expected #{@attribute} to be accessible"
+          else
+            @failure_message = "Did not expect #{@attribute} to be protected"
+          end
+          false
+        end
+      end
+
+      def description
+        "allow mass assignment of #{@attribute}"
+      end
+
+      private
+
+      def role
+        @options[:role] || :default
+      end
+
+      def protected_attributes
+        @protected_attributes ||= (@klass.class.protected_attributes || [])
+      end
+
+      def accessible_attributes
+        @accessible_attributes ||= (@klass.class.accessible_attributes || [])
+      end
+
+      def whitelisting?
+        authorizer.kind_of?(::ActiveModel::MassAssignmentSecurity::WhiteList)
+      end
+
+      def attr_mass_assignable?
+        !authorizer.deny?(@attribute)
+      end
+
+      def authorizer
+        if active_model_less_than_3_1?
+          @klass.class.active_authorizer
+        else
+          @klass.class.active_authorizer[role]
+        end
+      end
+
+      def class_name
+        @klass.class.name
+      end
+
+      def active_model_less_than_3_1?
+        ::ActiveModel::VERSION::STRING.to_f < 3.1
+      end
+    end
+
+    # Ensures that the attribute can be set on mass update.
+    #
+    #   it { should_not allow_mass_assignment_of(:password) }
+    #   it { should allow_mass_assignment_of(:first_name) }
+    #
+    # In Rails 3.1 you can check role as well:
+    #
+    #   it { should allow_mass_assignment_of(:first_name).as(:admin) }
+    #
+    def allow_mass_assignment_of(value)
+      AllowMassAssignmentOfMatcher.new(value)
+    end
+  end
+end