shoulda-matchers 2.7.0 → 2.8.0.rc1

data/spec/support/acceptance/helpers/rails_version_helpers.rb

@@ -0,0 +1,11 @@
+require_relative 'gem_helpers'
+
+module AcceptanceTests
+  module RailsVersionHelpers
+    include GemHelpers
+
+    def rails_version
+      bundle_version_of('rails')
+    end
+  end
+end

data/spec/support/acceptance/helpers/rspec_helpers.rb

@@ -0,0 +1,26 @@
+module AcceptanceTests
+  module RspecHelpers
+    include GemHelpers
+
+    def rspec_rails_version
+      bundle_version_of('rspec-rails')
+    end
+
+    def add_rspec_file(path, content)
+      content = "require '#{spec_helper_require_path}'\n#{content}"
+      write_file path, content
+    end
+
+    def spec_helper_require_path
+      if rspec_rails_version >= 3
+        'rails_helper'
+      else
+        'spec_helper'
+      end
+    end
+
+    def spec_helper_file_path
+      "spec/#{spec_helper_require_path}.rb"
+    end
+  end
+end

data/spec/support/acceptance/helpers/ruby_version_helpers.rb

@@ -0,0 +1,9 @@
+require_relative '../../tests/version'
+
+module AcceptanceTests
+  module RubyVersionHelpers
+    def ruby_version
+      Tests::Version.new(RUBY_VERSION)
+    end
+  end
+end

data/spec/support/acceptance/helpers/step_helpers.rb

@@ -0,0 +1,117 @@
+require_relative 'file_helpers'
+require_relative 'gem_helpers'
+require_relative 'minitest_helpers'
+
+module AcceptanceTests
+  module StepHelpers
+    include FileHelpers
+    include GemHelpers
+    include MinitestHelpers
+
+    extend RSpec::Matchers::DSL
+
+    def create_active_model_project
+      create_generic_bundler_project
+      add_gem 'activemodel', active_model_version
+    end
+
+    def create_generic_bundler_project
+      fs.create
+      run_command! 'bundle init'
+    end
+
+    def add_shoulda_matchers_to_project(options = {})
+      gem_options = { path: fs.root_directory }
+
+      if options[:manually]
+        gem_options[:require] = false
+      end
+
+      add_gem 'shoulda-matchers', gem_options
+
+      if options[:manually]
+        if options[:test_frameworks].include?(:rspec)
+          append_to_file spec_helper_file_path, "require 'shoulda/matchers'"
+        end
+
+        if options[:test_frameworks].include?(:n_unit)
+          append_to_file 'test/test_helper.rb', "require 'shoulda/matchers'"
+        end
+      end
+    end
+
+    def add_minitest_to_project
+      add_gem 'minitest-reporters'
+
+      append_to_file 'test/test_helper.rb', <<-FILE
+        require 'minitest/autorun'
+        require 'minitest/reporters'
+
+        Minitest::Reporters.use!(Minitest::Reporters::SpecReporter.new)
+      FILE
+    end
+
+    def add_shoulda_context_to_project(options = {})
+      add_gem 'shoulda-context'
+
+      if options[:manually]
+        append_to_file 'test/test_helper.rb', <<-FILE
+          require 'shoulda/context'
+        FILE
+      end
+    end
+
+    def write_minitest_test(path)
+      contents = yield minitest_test_case_superclass
+      write_file(path, contents)
+    end
+
+    def run_n_unit_tests(*paths)
+      run_command_within_bundle 'ruby -I lib -I test', *paths
+    end
+
+    def run_n_unit_test_suite
+      run_rake_tasks('test', env: { TESTOPTS: '-v' })
+    end
+
+    def create_rails_application
+      command = "bundle exec rails new #{fs.project_directory} --skip-bundle"
+
+      run_command!(command) do |runner|
+        runner.directory = nil
+      end
+
+      updating_bundle do |bundle|
+        bundle.remove_gem 'turn'
+        bundle.remove_gem 'coffee-rails'
+        bundle.remove_gem 'uglifier'
+      end
+    end
+
+    def configure_routes_with_single_wildcard_route
+      write_file 'config/routes.rb', <<-FILE
+        Rails.application.routes.draw do
+          get ':controller(/:action(/:id(.:format)))'
+        end
+      FILE
+    end
+
+    def add_rspec_rails_to_project!
+      add_gem 'rspec-rails', rspec_rails_version
+      run_command_within_bundle!('rails g rspec:install')
+      remove_from_file '.rspec', '--warnings'
+    end
+
+    def run_rspec_suite
+      run_rake_tasks('spec', env: { SPEC_OPTS: '-fd' })
+    end
+
+    def add_spring_to_project
+      if rails_version < 4
+        add_gem 'spring'
+      end
+
+      add_gem 'spring-commands-rspec'
+    end
+  end
+end

data/spec/support/acceptance/matchers/have_output.rb

@@ -0,0 +1,31 @@
+module AcceptanceTests
+  module Matchers
+    def have_output(output)
+      HaveOutputMatcher.new(output)
+    end
+
+    class HaveOutputMatcher
+      def initialize(output)
+        @output = output
+      end
+
+      def matches?(runner)
+        @runner = runner
+        runner.has_output?(output)
+      end
+
+      def failure_message
+        "Expected command to have output, but did not.\n\n" +
+          "Command: #{runner.formatted_command}\n\n" +
+          "Expected output:\n" +
+          output + "\n\n" +
+          "Actual output:\n" +
+          runner.elided_output
+      end
+
+      protected
+
+      attr_reader :output, :runner
+    end
+  end
+end

data/spec/support/acceptance/matchers/indicate_number_of_tests_was_run_matcher.rb

@@ -0,0 +1,55 @@
+require_relative '../helpers/pluralization_helpers'
+require_relative '../helpers/rails_version_helpers'
+
+module AcceptanceTests
+  module Matchers
+    def indicate_number_of_tests_was_run(expected_output)
+      IndicateNumberOfTestsWasRunMatcher.new(expected_output)
+    end
+
+    class IndicateNumberOfTestsWasRunMatcher
+      include PluralizationHelpers
+      include RailsVersionHelpers
+
+      def initialize(number)
+        @number = number
+      end
+
+      def matches?(runner)
+        @runner = runner
+        expected_output === actual_output
+      end
+
+      def failure_message
+        message = "Expected output to indicate that #{some_tests_were_run}.\n" +
+          "Expected output: #{expected_output}\n"
+
+        if actual_output.empty?
+          message << 'Actual output: (empty)'
+        else
+          message << "Actual output:\n#{actual_output}"
+        end
+
+        message
+      end
+
+      protected
+
+      attr_reader :number, :runner
+
+      private
+
+      def expected_output
+        /#{number} (tests|runs), #{number} assertions, 0 failures, 0 errors(, 0 skips)?/
+      end
+
+      def actual_output
+        runner.output
+      end
+
+      def some_tests_were_run
+        pluralize(number, 'test was', 'tests were') + ' run'
+      end
+    end
+  end
+end

data/spec/support/acceptance/matchers/indicate_that_tests_were_run_matcher.rb

@@ -0,0 +1,103 @@
+require_relative '../helpers/array_helpers'
+require_relative '../helpers/pluralization_helpers'
+require_relative '../helpers/rails_version_helpers'
+
+module AcceptanceTests
+  module Matchers
+    def indicate_that_tests_were_run(series)
+      IndicateThatTestsWereRunMatcher.new(series)
+    end
+
+    class IndicateThatTestsWereRunMatcher
+      include ArrayHelpers
+      include PluralizationHelpers
+      include RailsVersionHelpers
+
+      def initialize(args)
+        @args = args
+        @series = args.values
+      end
+
+      def matches?(runner)
+        @runner = runner
+        !matching_expected_output.nil?
+      end
+
+      def failure_message
+        "Expected output to indicate that #{some_tests_were_run}.\n" +
+          "#{formatted_expected_output}\n" +
+          "#{formatted_actual_output}\n"
+      end
+
+      protected
+
+      attr_reader :args, :series, :runner
+
+      private
+
+      def expected_outputs
+        [
+          expected_output_for_rails_3,
+          expected_output_for_turn,
+          expected_output_for_rails_4
+        ]
+      end
+
+      def matching_expected_output
+        @_matching_expected_output ||=
+          expected_outputs.detect do |expected_output|
+            actual_output =~ expected_output
+          end
+      end
+
+      def expected_output_for_rails_3
+        full_report = series.map do |number|
+          "#{number} tests, #{number} assertions, 0 failures, 0 errors(, 0 skips)?"
+        end.join('.+')
+
+        Regexp.new(full_report, Regexp::MULTILINE)
+      end
+
+      def expected_output_for_turn
+        full_report = series.map do |number|
+          "pass: #{number},  fail: 0,  error: 0"
+      end.join('.+')
+
+        Regexp.new(full_report, Regexp::MULTILINE)
+      end
+
+      def expected_output_for_rails_4
+        total = series.inject(:+)
+        /#{total} (tests|runs), #{total} assertions, 0 failures, 0 errors(, 0 skips)?/
+      end
+
+      def formatted_expected_output
+        if matching_expected_output
+          "Expected output:\n#{matching_actual_output}"
+        else
+          "Expected output: (n/a)"
+        end
+      end
+
+      def actual_output
+        runner.output
+      end
+
+      def formatted_actual_output
+        if actual_output.empty?
+          "Actual output: (empty)"
+        else
+          "Actual output:\n#{actual_output}"
+        end
+      end
+
+      def some_tests_were_run
+        clauses = args.map do |type, number|
+          pluralize(number, "#{type} test was run", "#{type} tests were run")
+        end
+
+        to_sentence(clauses)
+      end
+    end
+  end
+end

data/spec/support/tests/bundle.rb

@@ -0,0 +1,94 @@
+require_relative 'filesystem'
+require_relative 'command_runner'
+require_relative 'version'
+
+module Tests
+  class Bundle
+    def initialize
+      @already_updating = false
+      @fs = Filesystem.new
+    end
+
+    def updating(&block)
+      if already_updating?
+        yield self
+        return
+      end
+
+      @already_updating = true
+
+      yield self
+
+      @already_updating = false
+
+      install_gems
+    end
+
+    def add_gem(gem, *args)
+      updating do
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        version = args.shift
+        line = assemble_gem_line(gem, version, options)
+        fs.append_to_file('Gemfile', line)
+      end
+    end
+
+    def remove_gem(gem)
+      updating do
+        fs.remove_from_file('Gemfile', /^gem ("|')gem\1/)
+      end
+    end
+
+    def install_gems
+      CommandRunner.run!('bundle install --local') do |runner|
+        runner.retries = 5
+      end
+    end
+
+    def version_of(gem)
+      Version.new(Bundler.definition.specs[gem][0].version)
+    end
+
+    def includes?(gem)
+      Bundler.definition.dependencies.any? do |dependency|
+        dependency.name == gem
+      end
+    end
+
+    protected
+
+    attr_reader :fs
+
+    private
+
+    def already_updating?
+      @already_updating
+    end
+
+    def assemble_gem_line(gem, version, options)
+      formatted_options = options.
+        map { |key, value| "#{key}: #{formatted_value(value)}" }.
+        join(', ')
+
+      line = %(gem '#{gem}')
+
+      if version
+        line << %(, '#{version}')
+      end
+
+      if options.any?
+        line << %(, #{formatted_options})
+      end
+
+      line << "\n"
+    end
+
+    def formatted_value(value)
+      if value.is_a?(Pathname)
+        value.to_s.inspect
+      else
+        value.inspect
+      end
+    end
+  end
+end