openproject/spec/support/shared/acts_as_watchable.rb

#-- copyright
# OpenProject is a project management system.
# Copyright (C) 2012-2015 the OpenProject Foundation (OPF)
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License version 3.
#
# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
# Copyright (C) 2006-2013 Jean-Philippe Lang
# Copyright (C) 2010-2013 the ChiliProject Team
#
# 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.
#
# See doc/COPYRIGHT.rdoc for more details.
#++

shared_examples_for 'acts_as_watchable included' do
  before do
    unless defined?(model_instance) &&
           defined?(watch_permission) &&
           defined?(project)
      raise <<MESSAGE
  This share example needs the following objects:
  * model_instance: An instance of the watchable under test
  * watch_permission: The symbol for the permission required for watching an instance
  * project: the project the model_instance is in
MESSAGE
    end
  end

  let(:watcher_role) { FactoryGirl.create(:role, permissions: [watch_permission]) }
  let(:non_watcher_role) { FactoryGirl.create(:role, permissions: []) }
  let(:non_member_user) { FactoryGirl.create(:user) }
  let(:user_with_permission) do
    FactoryGirl.create(:user,
                       member_in_project: project,
                       member_through_role: watcher_role)
  end

  let(:user_wo_permission) do
    if is_public_permission
      FactoryGirl.create(:user)
    else
      FactoryGirl.create(:user,
                         member_in_project: project,
                         member_through_role: non_watcher_role)
    end
  end
  let(:admin) { FactoryGirl.build(:admin) }
  let(:anonymous_user) { FactoryGirl.build(:anonymous) }
  let(:watching_user) do
    FactoryGirl.create(:user,
                       member_in_project: project,
                       member_through_role: watcher_role).tap do |user|
      Watcher.create(watchable: model_instance, user: user)
    end
  end

  let(:is_public_permission) do
    Redmine::AccessControl.public_permissions.map(&:name).include?(watch_permission)
  end

  describe '#possible_watcher_users' do
    subject { model_instance.possible_watcher_users }

    before do
      admin.save!
      anonymous_user.save!
      user_with_permission.save!
      user_wo_permission.save!
    end

    shared_context 'non member role has the permission to watch' do
      let(:non_member_role) { Role.non_member }

      before do
        non_member_role.add_permission! watch_permission
      end
    end

    shared_context 'anonymous role has the permission to watch' do
      let(:anonymous_role) { FactoryGirl.build :anonymous_role, permissions: [watch_permission] }

      before do
        anonymous_role.save!
      end
    end

    # While using share context here does not make sense for now as it
    # is only used once, the intend of acts as watchable is to also
    # include non members as watchers. Then the permission will be
    # a variable to also test for.
    include_context 'non member role has the permission to watch'
    include_context 'anonymous role has the permission to watch'

    context 'when it is a public project' do
      it 'contains members allowed to view' do
        expect(model_instance.possible_watcher_users)
          .to match_array([user_with_permission])
      end
    end

    context 'when it is a private project' do
      before do
        project.update_attributes is_public: false
        model_instance.reload
      end

      it 'contains members allowed to view' do
        expect(model_instance.possible_watcher_users)
          .to match_array([user_with_permission])
      end
    end
  end

  describe '#watcher_recipients' do
    before do
      watching_user
      model_instance.reload
    end

    subject { model_instance.watcher_recipients }

    it { is_expected.to match_array([watching_user]) }

    context 'when the permission to watch has been removed' do
      before do
        if is_public_permission
          watching_user.memberships.destroy_all
        else
          watcher_role.remove_permission! watch_permission
        end

        model_instance.reload
      end

      it { is_expected.to match_array([]) }
    end
  end

  describe '#watched_by?' do
    before do
      watching_user
      model_instance.reload
    end

    subject { model_instance.watched_by?(watching_user) }

    it { is_expected.to be_truthy }

    context 'when the permission to view work packages has been removed' do
      # an existing watcher shouldn't be removed
      before do
        if is_public_permission
          skip "Not applicable for #{model_instance.class} as #{watch_permission} " +
            'is a public permission'
        end

        watcher_role.remove_permission! watch_permission

        model_instance.reload
      end

      it { is_expected.to be_truthy }
    end
  end
end