openproject/spec/requests/api/v3/principals/principals_resource_spec.rb

#-- copyright
# OpenProject is an open source project management software.
# Copyright (C) 2012-2021 the OpenProject GmbH
#
# 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 COPYRIGHT and LICENSE files for more details.
#++

require 'spec_helper'
require 'rack/test'

describe 'API v3 Principals resource', type: :request do
  include Rack::Test::Methods
  include API::V3::Utilities::PathHelper

  describe '#GET /api/v3/principals' do
    subject(:response) { last_response }

    let(:path) do
      api_v3_paths.path_for :principals, filters: filter, sort_by: order
    end
    let(:order) { { name: :desc } }
    let(:filter) { nil }
    let(:project) { FactoryBot.create(:project) }
    let(:other_project) { FactoryBot.create(:project) }
    let(:non_member_project) { FactoryBot.create(:project) }
    let(:role) { FactoryBot.create(:role, permissions: permissions) }
    let(:permissions) { [] }
    let(:user) do
      user = FactoryBot.create(:user,
                               member_in_project: project,
                               member_through_role: role,
                               lastname: 'Aaaa',
                               mail: 'aaaa@example.com')

      FactoryBot.create(:member,
                        project: other_project,
                        principal: user,
                        roles: [role])

      user
    end
    let!(:other_user) do
      FactoryBot.create(:user,
                        member_in_project: other_project,
                        member_through_role: role,
                        lastname: 'Bbbb')
    end
    let!(:user_in_non_member_project) do
      FactoryBot.create(:user,
                        member_in_project: non_member_project,
                        member_through_role: role,
                        lastname: 'Cccc')
    end
    let!(:group) do
      FactoryBot.create(:group,
                        member_in_project: project,
                        member_through_role: role,
                        lastname: 'Gggg')
    end
    let!(:placeholder_user) do
      FactoryBot.create(:placeholder_user,
                        member_in_project: project,
                        member_through_role: role,
                        name: 'Pppp')
    end

    current_user { user }

    before do
      get path
    end

    it 'succeeds' do
      expect(response.status)
        .to eq(200)
    end

    it_behaves_like 'API V3 collection response', 4, 4 do
      let(:elements) { [placeholder_user, group, other_user, user] }
    end

    context 'with a filter for project the user is member in' do
      let(:filter) do
        [{ member: { operator: '=', values: [project.id.to_s] } }]
      end

      it_behaves_like 'API V3 collection response', 3, 3
    end

    context 'with a filter for type "User"' do
      let(:filter) do
        [{ type: { operator: '=', values: ['User'] } }]
      end

      it_behaves_like 'API V3 collection response', 2, 2, nil
    end

    context 'with a filter for type "Group"' do
      let(:filter) do
        [{ type: { operator: '=', values: ['Group'] } }]
      end

      it_behaves_like 'API V3 collection response', 1, 1, 'Group'
    end

    context 'with a filter for type "PlaceholderUser"' do
      let(:filter) do
        [{ type: { operator: '=', values: ['PlaceholderUser'] } }]
      end

      it_behaves_like 'API V3 collection response', 1, 1, 'PlaceholderUser'
    end

    context 'with a without a project membership' do
      let(:user) { FactoryBot.create(:user) }

      # The user herself
      it_behaves_like 'API V3 collection response', 1, 1, 'User'
    end

    context 'with a filter for any name attribute' do
      let(:filter) do
        [{ any_name_attribute: { operator: '~', values: ['aaaa@example.com'] } }]
      end

      it_behaves_like 'API V3 collection response', 1, 1, 'User'
    end

    context 'with a filter for id' do
      let(:filter) do
        [{ id: { operator: '=', values: [user.id.to_s] } }]
      end

      it_behaves_like 'API V3 collection response', 1, 1, 'User' do
        let(:elements) { [user] }
      end
    end

    context 'with a filter for id with the `me` value' do
      let(:filter) do
        [{ id: { operator: '=', values: ['me'] } }]
      end

      it_behaves_like 'API V3 collection response', 1, 1, 'User' do
        let(:elements) { [current_user] }
      end
    end
  end
end