123 lines
3.2 KiB
Ruby
123 lines
3.2 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
module Gitlab
|
|
module Graphql
|
|
class Deprecation
|
|
REASONS = {
|
|
renamed: 'This was renamed.',
|
|
alpha: 'This feature is in Alpha, and can be removed or changed at any point.'
|
|
}.freeze
|
|
|
|
include ActiveModel::Validations
|
|
|
|
validates :milestone, presence: true, format: { with: /\A\d+\.\d+\z/, message: 'must be milestone-ish' }
|
|
validates :reason, presence: true
|
|
validates :reason,
|
|
format: { with: /.*[^.]\z/, message: 'must not end with a period' },
|
|
if: :reason_is_string?
|
|
validate :milestone_is_string
|
|
validate :reason_known_or_string
|
|
|
|
def self.parse(options)
|
|
new(**options) if options
|
|
end
|
|
|
|
def initialize(reason: nil, milestone: nil, replacement: nil)
|
|
@reason = reason.presence
|
|
@milestone = milestone.presence
|
|
@replacement = replacement.presence
|
|
end
|
|
|
|
def ==(other)
|
|
return false unless other.is_a?(self.class)
|
|
|
|
[reason_text, milestone, replacement] == [:reason_text, :milestone, :replacement].map do |attr|
|
|
other.send(attr) # rubocop: disable GitlabSecurity/PublicSend
|
|
end
|
|
end
|
|
alias_method :eql, :==
|
|
|
|
def markdown(context: :inline)
|
|
parts = [
|
|
"#{deprecated_in(format: :markdown)}.",
|
|
reason_text,
|
|
replacement_markdown.then { |r| "Use: #{r}." if r }
|
|
].compact
|
|
|
|
case context
|
|
when :block
|
|
['WARNING:', *parts].join("\n")
|
|
when :inline
|
|
parts.join(' ')
|
|
end
|
|
end
|
|
|
|
def replacement_markdown
|
|
return unless replacement.present?
|
|
return "`#{replacement}`" unless replacement.include?('.') # only fully qualified references can be linked
|
|
|
|
"[`#{replacement}`](##{replacement.downcase.tr('.', '')})"
|
|
end
|
|
|
|
def edit_description(original_description)
|
|
@original_description = original_description
|
|
return unless original_description
|
|
|
|
original_description + description_suffix
|
|
end
|
|
|
|
def original_description
|
|
return unless @original_description
|
|
return @original_description if @original_description.ends_with?('.')
|
|
|
|
"#{@original_description}."
|
|
end
|
|
|
|
def deprecation_reason
|
|
[
|
|
reason_text,
|
|
replacement && "Please use `#{replacement}`.",
|
|
"#{deprecated_in}."
|
|
].compact.join(' ')
|
|
end
|
|
|
|
private
|
|
|
|
attr_reader :reason, :milestone, :replacement
|
|
|
|
def milestone_is_string
|
|
return if milestone.is_a?(String)
|
|
|
|
errors.add(:milestone, 'must be a string')
|
|
end
|
|
|
|
def reason_known_or_string
|
|
return if REASONS.key?(reason)
|
|
return if reason_is_string?
|
|
|
|
errors.add(:reason, 'must be a known reason or a string')
|
|
end
|
|
|
|
def reason_is_string?
|
|
reason.is_a?(String)
|
|
end
|
|
|
|
def reason_text
|
|
@reason_text ||= REASONS[reason] || "#{reason.to_s.strip}."
|
|
end
|
|
|
|
def description_suffix
|
|
" #{deprecated_in}: #{reason_text}"
|
|
end
|
|
|
|
def deprecated_in(format: :plain)
|
|
case format
|
|
when :plain
|
|
"Deprecated in #{milestone}"
|
|
when :markdown
|
|
"**Deprecated** in #{milestone}"
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|