summaryrefslogtreecommitdiff
path: root/app/graphql/types/concerns/gitlab_style_deprecations.rb
blob: e404f1fcad9a84289f5f203911ad94b72c2a2254 (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
# frozen_string_literal: true

# Concern for handling deprecation arguments.
# https://docs.gitlab.com/ee/development/api_graphql_styleguide.html#deprecating-schema-items
module GitlabStyleDeprecations
  extend ActiveSupport::Concern

  private

  # Mutate the arguments, returns the deprecation
  def gitlab_deprecation(kwargs)
    if kwargs[:deprecation_reason].present?
      raise ArgumentError, 'Use `deprecated` property instead of `deprecation_reason`. ' \
                           'See https://docs.gitlab.com/ee/development/api_graphql_styleguide.html#deprecating-schema-items'
    end

    # GitLab allows items to be marked as "alpha", which leverages GraphQL deprecations.
    deprecation_args = kwargs.extract!(:alpha, :deprecated)

    deprecation = ::Gitlab::Graphql::Deprecation.parse(**deprecation_args)
    return unless deprecation

    raise ArgumentError, "Bad deprecation. #{deprecation.errors.full_messages.to_sentence}" unless deprecation.valid?

    kwargs[:deprecation_reason] = deprecation.deprecation_reason
    kwargs[:description] = deprecation.edit_description(kwargs[:description])

    deprecation
  end
end