SoundSoftware Code Site

# Redmine - project management software

# Copyright (C) 2006-2011  Jean-Philippe Lang

#

# This program is free software; you can redistribute it and/or

# modify it under the terms of the GNU General Public License

# as published by the Free Software Foundation; either version 2

# of the License, or (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

ENV["RAILS_ENV"] = "test"

require File.expand_path(File.dirname(__FILE__) + "/../config/environment")

require 'test_help'

require File.expand_path(File.dirname(__FILE__) + '/helper_testcase')

require File.join(RAILS_ROOT,'test', 'mocks', 'open_id_authentication_mock.rb')

require File.expand_path(File.dirname(__FILE__) + '/object_daddy_helpers')

include ObjectDaddyHelpers

class ActiveSupport::TestCase

  # Transactional fixtures accelerate your tests by wrapping each test method

  # in a transaction that's rolled back on completion.  This ensures that the

  # test database remains unchanged so your fixtures don't have to be reloaded

  # between every test method.  Fewer database queries means faster tests.

  #

  # Read Mike Clark's excellent walkthrough at

  #   http://clarkware.com/cgi/blosxom/2005/10/24#Rails10FastTesting

  #

  # Every Active Record database supports transactions except MyISAM tables

  # in MySQL.  Turn off transactional fixtures in this case; however, if you

  # don't care one way or the other, switching from MyISAM to InnoDB tables

  # is recommended.

  self.use_transactional_fixtures = true

  # Instantiated fixtures are slow, but give you @david where otherwise you

  # would need people(:david).  If you don't want to migrate your existing

  # test cases which use the @david style and don't mind the speed hit (each

  # instantiated fixtures translates to a database query per test method),

  # then set this back to true.

  self.use_instantiated_fixtures  = false

  # Add more helper methods to be used by all tests here...

  def log_user(login, password)

    User.anonymous

    get "/login"

    assert_equal nil, session[:user_id]

    assert_response :success

    assert_template "account/login"

    post "/login", :username => login, :password => password

    assert_equal login, User.find(session[:user_id]).login

  end

  def uploaded_test_file(name, mime)

    ActionController::TestUploadedFile.new(ActiveSupport::TestCase.fixture_path + "/files/#{name}", mime, true)

  end

  # Mock out a file

  def self.mock_file

    file = 'a_file.png'

    file.stubs(:size).returns(32)

    file.stubs(:original_filename).returns('a_file.png')

    file.stubs(:content_type).returns('image/png')

    file.stubs(:read).returns(false)

    file

  end

  def mock_file

    self.class.mock_file

  end

  # Use a temporary directory for attachment related tests

  def set_tmp_attachments_directory

    Dir.mkdir "#{RAILS_ROOT}/tmp/test" unless File.directory?("#{RAILS_ROOT}/tmp/test")

    Dir.mkdir "#{RAILS_ROOT}/tmp/test/attachments" unless File.directory?("#{RAILS_ROOT}/tmp/test/attachments")

    Attachment.storage_path = "#{RAILS_ROOT}/tmp/test/attachments"

  end

  def with_settings(options, &block)

    saved_settings = options.keys.inject({}) {|h, k| h[k] = Setting[k].dup; h}

    options.each {|k, v| Setting[k] = v}

    yield

  ensure

    saved_settings.each {|k, v| Setting[k] = v}

  end

  def change_user_password(login, new_password)

    user = User.first(:conditions => {:login => login})

    user.password, user.password_confirmation = new_password, new_password

    user.save!

  end

  def self.ldap_configured?

    @test_ldap = Net::LDAP.new(:host => '127.0.0.1', :port => 389)

    return @test_ldap.bind

  rescue Exception => e

    # LDAP is not listening

    return nil

  end

  # Returns the path to the test +vendor+ repository

  def self.repository_path(vendor)

    File.join(RAILS_ROOT.gsub(%r{config\/\.\.}, ''), "/tmp/test/#{vendor.downcase}_repository")

  end

  # Returns the url of the subversion test repository

  def self.subversion_repository_url

    path = repository_path('subversion')

    path = '/' + path unless path.starts_with?('/')

    "file://#{path}"

  end

  # Returns true if the +vendor+ test repository is configured

  def self.repository_configured?(vendor)

    File.directory?(repository_path(vendor))

  end

  def assert_error_tag(options={})

    assert_tag({:attributes => { :id => 'errorExplanation' }}.merge(options))

  end

  # Shoulda macros

  def self.should_render_404

    should_respond_with :not_found

    should_render_template 'common/error'

  end

  def self.should_have_before_filter(expected_method, options = {})

    should_have_filter('before', expected_method, options)

  end

  def self.should_have_after_filter(expected_method, options = {})

    should_have_filter('after', expected_method, options)

  end

  def self.should_have_filter(filter_type, expected_method, options)

    description = "have #{filter_type}_filter :#{expected_method}"

    description << " with #{options.inspect}" unless options.empty?

    should description do

      klass = "action_controller/filters/#{filter_type}_filter".classify.constantize

      expected = klass.new(:filter, expected_method.to_sym, options)

      assert_equal 1, @controller.class.filter_chain.select { |filter|

        filter.method == expected.method && filter.kind == expected.kind &&

        filter.options == expected.options && filter.class == expected.class

      }.size

    end

  end

  def self.should_show_the_old_and_new_values_for(prop_key, model, &block)

    context "" do

      setup do

        if block_given?

          instance_eval &block

        else

          @old_value = model.generate!

          @new_value = model.generate!

        end

      end

      should "use the new value's name" do

        @detail = JournalDetail.generate!(:property => 'attr',

                                          :old_value => @old_value.id,

                                          :value => @new_value.id,

                                          :prop_key => prop_key)

        assert_match @new_value.name, show_detail(@detail, true)

      end

      should "use the old value's name" do

        @detail = JournalDetail.generate!(:property => 'attr',

                                          :old_value => @old_value.id,

                                          :value => @new_value.id,

                                          :prop_key => prop_key)

        assert_match @old_value.name, show_detail(@detail, true)

      end

    end

  end

  def self.should_create_a_new_user(&block)

    should "create a new user" do

      user = instance_eval &block

      assert user

      assert_kind_of User, user

      assert !user.new_record?

    end

  end

  # Test that a request allows the three types of API authentication

  #

  # * HTTP Basic with username and password

  # * HTTP Basic with an api key for the username

  # * Key based with the key=X parameter

  #

  # @param [Symbol] http_method the HTTP method for request (:get, :post, :put, :delete)

  # @param [String] url the request url

  # @param [optional, Hash] parameters additional request parameters

  # @param [optional, Hash] options additional options

  # @option options [Symbol] :success_code Successful response code (:success)

  # @option options [Symbol] :failure_code Failure response code (:unauthorized)

  def self.should_allow_api_authentication(http_method, url, parameters={}, options={})

    should_allow_http_basic_auth_with_username_and_password(http_method, url, parameters, options)

    should_allow_http_basic_auth_with_key(http_method, url, parameters, options)

    should_allow_key_based_auth(http_method, url, parameters, options)

  end

  # Test that a request allows the username and password for HTTP BASIC

  #

  # @param [Symbol] http_method the HTTP method for request (:get, :post, :put, :delete)

  # @param [String] url the request url

  # @param [optional, Hash] parameters additional request parameters

  # @param [optional, Hash] options additional options

  # @option options [Symbol] :success_code Successful response code (:success)

  # @option options [Symbol] :failure_code Failure response code (:unauthorized)

  def self.should_allow_http_basic_auth_with_username_and_password(http_method, url, parameters={}, options={})

    success_code = options[:success_code] || :success

    failure_code = options[:failure_code] || :unauthorized

    context "should allow http basic auth using a username and password for #{http_method} #{url}" do

      context "with a valid HTTP authentication" do

        setup do

          @user = User.generate_with_protected!(:password => 'my_password', :password_confirmation => 'my_password', :admin => true) # Admin so they can access the project

          @authorization = ActionController::HttpAuthentication::Basic.encode_credentials(@user.login, 'my_password')

          send(http_method, url, parameters, {:authorization => @authorization})

        end

        should_respond_with success_code

        should_respond_with_content_type_based_on_url(url)

        should "login as the user" do

          assert_equal @user, User.current

        end

      end

      context "with an invalid HTTP authentication" do

        setup do

          @user = User.generate_with_protected!

          @authorization = ActionController::HttpAuthentication::Basic.encode_credentials(@user.login, 'wrong_password')

          send(http_method, url, parameters, {:authorization => @authorization})

        end

        should_respond_with failure_code

        should_respond_with_content_type_based_on_url(url)

        should "not login as the user" do

          assert_equal User.anonymous, User.current

        end

      end

      context "without credentials" do

        setup do

          send(http_method, url, parameters, {:authorization => ''})

        end

        should_respond_with failure_code

        should_respond_with_content_type_based_on_url(url)

        should "include_www_authenticate_header" do

          assert @controller.response.headers.has_key?('WWW-Authenticate')

        end

      end

    end

  end

  # Test that a request allows the API key with HTTP BASIC

  #

  # @param [Symbol] http_method the HTTP method for request (:get, :post, :put, :delete)

  # @param [String] url the request url

  # @param [optional, Hash] parameters additional request parameters

  # @param [optional, Hash] options additional options

  # @option options [Symbol] :success_code Successful response code (:success)

  # @option options [Symbol] :failure_code Failure response code (:unauthorized)

  def self.should_allow_http_basic_auth_with_key(http_method, url, parameters={}, options={})

    success_code = options[:success_code] || :success

    failure_code = options[:failure_code] || :unauthorized

    context "should allow http basic auth with a key for #{http_method} #{url}" do

      context "with a valid HTTP authentication using the API token" do

        setup do

          @user = User.generate_with_protected!(:admin => true)

          @token = Token.generate!(:user => @user, :action => 'api')

          @authorization = ActionController::HttpAuthentication::Basic.encode_credentials(@token.value, 'X')

          send(http_method, url, parameters, {:authorization => @authorization})

        end

        should_respond_with success_code

        should_respond_with_content_type_based_on_url(url)

        should_be_a_valid_response_string_based_on_url(url)

        should "login as the user" do

          assert_equal @user, User.current

        end

      end

      context "with an invalid HTTP authentication" do

        setup do

          @user = User.generate_with_protected!

          @token = Token.generate!(:user => @user, :action => 'feeds')

          @authorization = ActionController::HttpAuthentication::Basic.encode_credentials(@token.value, 'X')

          send(http_method, url, parameters, {:authorization => @authorization})

        end

        should_respond_with failure_code

        should_respond_with_content_type_based_on_url(url)

        should "not login as the user" do

          assert_equal User.anonymous, User.current

        end

      end

    end

  end

  # Test that a request allows full key authentication

  #

  # @param [Symbol] http_method the HTTP method for request (:get, :post, :put, :delete)

  # @param [String] url the request url, without the key=ZXY parameter

  # @param [optional, Hash] parameters additional request parameters

  # @param [optional, Hash] options additional options

  # @option options [Symbol] :success_code Successful response code (:success)

  # @option options [Symbol] :failure_code Failure response code (:unauthorized)

  def self.should_allow_key_based_auth(http_method, url, parameters={}, options={})

    success_code = options[:success_code] || :success

    failure_code = options[:failure_code] || :unauthorized

    context "should allow key based auth using key=X for #{http_method} #{url}" do

      context "with a valid api token" do

        setup do

          @user = User.generate_with_protected!(:admin => true)

          @token = Token.generate!(:user => @user, :action => 'api')

          # Simple url parse to add on ?key= or &key=

          request_url = if url.match(/\?/)

                          url + "&key=#{@token.value}"

                        else

                          url + "?key=#{@token.value}"

                        end

          send(http_method, request_url, parameters)

        end

        should_respond_with success_code

        should_respond_with_content_type_based_on_url(url)

        should_be_a_valid_response_string_based_on_url(url)

        should "login as the user" do

          assert_equal @user, User.current

        end

      end

      context "with an invalid api token" do

        setup do

          @user = User.generate_with_protected!

          @token = Token.generate!(:user => @user, :action => 'feeds')

          # Simple url parse to add on ?key= or &key=

          request_url = if url.match(/\?/)

                          url + "&key=#{@token.value}"

                        else

                          url + "?key=#{@token.value}"

                        end

          send(http_method, request_url, parameters)

        end

        should_respond_with failure_code

        should_respond_with_content_type_based_on_url(url)

        should "not login as the user" do

          assert_equal User.anonymous, User.current

        end

      end

    end

    context "should allow key based auth using X-Redmine-API-Key header for #{http_method} #{url}" do

      setup do

        @user = User.generate_with_protected!(:admin => true)

        @token = Token.generate!(:user => @user, :action => 'api')

        send(http_method, url, parameters, {'X-Redmine-API-Key' => @token.value.to_s})

      end

      should_respond_with success_code

      should_respond_with_content_type_based_on_url(url)

      should_be_a_valid_response_string_based_on_url(url)

      should "login as the user" do

        assert_equal @user, User.current

      end

    end

  end

  # Uses should_respond_with_content_type based on what's in the url:

  #

  # '/project/issues.xml' => should_respond_with_content_type :xml

  # '/project/issues.json' => should_respond_with_content_type :json

  #

  # @param [String] url Request

  def self.should_respond_with_content_type_based_on_url(url)

    case

    when url.match(/xml/i)

      should_respond_with_content_type :xml

    when url.match(/json/i)

      should_respond_with_content_type :json

    else

      raise "Unknown content type for should_respond_with_content_type_based_on_url: #{url}"

    end

  end

  # Uses the url to assert which format the response should be in

  #

  # '/project/issues.xml' => should_be_a_valid_xml_string

  # '/project/issues.json' => should_be_a_valid_json_string

  #

  # @param [String] url Request

  def self.should_be_a_valid_response_string_based_on_url(url)

    case

    when url.match(/xml/i)

      should_be_a_valid_xml_string

    when url.match(/json/i)

      should_be_a_valid_json_string

    else

      raise "Unknown content type for should_be_a_valid_response_based_on_url: #{url}"

    end

  end

  # Checks that the response is a valid JSON string

  def self.should_be_a_valid_json_string

    should "be a valid JSON string (or empty)" do

      assert(response.body.blank? || ActiveSupport::JSON.decode(response.body))

    end

  end

  # Checks that the response is a valid XML string

  def self.should_be_a_valid_xml_string

    should "be a valid XML string" do

      assert REXML::Document.new(response.body)

    end

  end

end

# Simple module to "namespace" all of the API tests

module ApiTest

end