openproject/spec/spec_helper.rb

#-- copyright
# OpenProject is a project management system.
#
# Copyright (C) 2012-2013 the OpenProject Team
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License version 3.
#
# See doc/COPYRIGHT.rdoc for more details.
#++

require 'rubygems'

# This file is copied to spec/ when you run 'rails generate rspec:install'
ENV["RAILS_ENV"] ||= 'test'

require File.expand_path("../../config/environment", __FILE__)
require 'rspec/rails'

require 'rspec/autorun'
require 'rspec/example_disabler'
require 'capybara/rails'

# Requires supporting ruby files with custom matchers and macros, etc,
# in spec/support/ and its subdirectories.
Dir[Rails.root.join("spec/support/**/*.rb")].each {|f| require f}

RSpec.configure do |config|
  # ## Mock Framework
  #
  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
  #
  # config.mock_with :mocha
  # config.mock_with :flexmock
  # config.mock_with :rr
  config.mock_with :rspec

  # Remove this line if you're not using ActiveRecord or ActiveRecord fixtures
  config.fixture_path = "#{::Rails.root}/spec/fixtures"

  # If you're not using ActiveRecord, or you'd prefer not to run each of your
  # examples within a transaction, remove the following line or assign false
  # instead of true.
  config.use_transactional_fixtures = true

  # If true, the base class of anonymous controllers will be inferred
  # automatically. This will be the default behavior in future versions of
  # rspec-rails.
  config.infer_base_class_for_anonymous_controllers = false

  # Run specs in random order to surface order dependencies. If you find an
  # order dependency and want to debug it, you can fix the order by providing
  # the seed, which is printed after each run.
  #     --seed 1234
  config.order = "random"

  config.treat_symbols_as_metadata_keys_with_true_values = true
  config.run_all_when_everything_filtered = true

  config.after(:each) do
    OpenProject::RSpecLazinessWarn.warn_if_user_current_set(example)
  end

  config.after(:suite) do
    [User, Project, WorkPackage].each do |cls|
      raise "your specs leave a #{cls} in the DB\ndid you use before(:all) instead of before or forget to kill the instances in a after(:all)?" if cls.count > 0
    end
  end
end

# load disable_specs.rbs from plugins
Rails.application.config.plugins_to_test_paths.each do |dir|
  disable_specs_file = File.join(dir, 'spec', 'disable_specs.rb')
  if File.exists?(disable_specs_file)
    puts 'Loading ' + disable_specs_file
    require disable_specs_file
  end
end

module OpenProject::RSpecLazinessWarn

  def self.warn_if_user_current_set(example)
    # Using the hacky way of getting current_user to avoid under the hood creation of AnonymousUser
    # which might break other tests and at least leaves this user in the db after the test is run.
    user = User.instance_variable_get(:@current_user)
    unless user.nil? or user.is_a? AnonymousUser
      # we only want an abbreviated_stacktrace because the logfiles
      # might otherwise not be capable to show all the warnings.
      # Thus we only take the callers that are part of the user code.
      file_roots = Rails::Application::Railties.engines.map { |e| e.root.to_s } << Rails.root.to_s
      abbreviated_stacktrace = example.metadata[:caller].select { |s| file_roots.any?{ |root| s.include?(root) } }

      # we only want to show the more verbose warning once
      if self.warned
        warn <<-DOC

              ============================================================================================
              #{ example.full_description }
              ============================================================================================
              This spec also leaves User.current in an unclean state.
              ============================================================================================
              #{ abbreviated_stacktrace.join("\n              ") }
              ============================================================================================
        DOC
      else
        warn <<-DOC

                ============================================================================================
                #{ example.full_description }
                ============================================================================================
                This spec leaves User.current in an unclean state, creating a dependency to other specs.

                It sets User.current to a value other than User.anonymous but does not clean up after the
                spec is run. User.current saves this value in an instance variable of the User class.
                This class instance variable is not removed between tests.

                So please go ahead and set User.current to nil afterwards.
                ============================================================================================

                Abbreviated stacktrace:

                #{ abbreviated_stacktrace.join("\n              ") }

                ============================================================================================


        DOC

        self.warned = true
      end

      User.current = nil
    end
  end


  protected

  class << self
    attr_accessor :warned
  end

end