summaryrefslogtreecommitdiff
path: root/lib/api/feature_flags_user_lists.rb
blob: 086bcbcdc89893ffe4cd66057a8d502c4a2721c3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
# frozen_string_literal: true

module API
  class FeatureFlagsUserLists < ::API::Base
    include PaginationParams

    error_formatter :json, -> (message, _backtrace, _options, _env, _original_exception) {
      message.is_a?(String) ? { message: message }.to_json : message.to_json
    }

    feature_category :feature_flags

    before do
      authorize_admin_feature_flags_user_lists!
    end

    params do
      requires :id, type: String, desc: 'The ID of a project'
    end
    resource 'projects/:id', requirements: API::NAMESPACE_OR_PROJECT_REQUIREMENTS do
      resource :feature_flags_user_lists do
        desc 'Get all feature flags user lists of a project' do
          detail 'This feature was introduced in GitLab 12.10'
          success ::API::Entities::FeatureFlag::UserList
        end
        params do
          optional :search, type: String, desc: 'Returns the list of user lists matching the search critiera'

          use :pagination
        end
        get do
          user_lists = ::FeatureFlagsUserListsFinder.new(user_project, current_user, params).execute
          present paginate(user_lists),
            with: ::API::Entities::FeatureFlag::UserList
        end

        desc 'Create a feature flags user list for a project' do
          detail 'This feature was introduced in GitLab 12.10'
          success ::API::Entities::FeatureFlag::UserList
        end
        params do
          requires :name, type: String, desc: 'The name of the list'
          requires :user_xids, type: String, desc: 'A comma separated list of external user ids'
        end
        post do
          list = user_project.operations_feature_flags_user_lists.create(declared_params)

          if list.save
            present list, with: ::API::Entities::FeatureFlag::UserList
          else
            render_api_error!(list.errors.full_messages, :bad_request)
          end
        end
      end

      params do
        requires :iid, type: String, desc: 'The internal id of the user list'
      end
      resource 'feature_flags_user_lists/:iid' do
        desc 'Get a single feature flag user list belonging to a project' do
          detail 'This feature was introduced in GitLab 12.10'
          success ::API::Entities::FeatureFlag::UserList
        end
        get do
          present user_project.operations_feature_flags_user_lists.find_by_iid!(params[:iid]),
            with: ::API::Entities::FeatureFlag::UserList
        end

        desc 'Update a feature flag user list' do
          detail 'This feature was introduced in GitLab 12.10'
          success ::API::Entities::FeatureFlag::UserList
        end
        params do
          optional :name, type: String, desc: 'The name of the list'
          optional :user_xids, type: String, desc: 'A comma separated list of external user ids'
        end
        put do
          list = user_project.operations_feature_flags_user_lists.find_by_iid!(params[:iid])

          if list.update(declared_params(include_missing: false))
            present list, with: ::API::Entities::FeatureFlag::UserList
          else
            render_api_error!(list.errors.full_messages, :bad_request)
          end
        end

        desc 'Delete a feature flag user list' do
          detail 'This feature was introduced in GitLab 12.10'
        end
        delete do
          list = user_project.operations_feature_flags_user_lists.find_by_iid!(params[:iid])
          unless list.destroy
            render_api_error!(list.errors.full_messages, :conflict)
          end
        end
      end
    end

    helpers do
      def authorize_admin_feature_flags_user_lists!
        authorize! :admin_feature_flags_user_lists, user_project
      end
    end
  end
end