2018-08-03 17:22:24 +00:00
|
|
|
# frozen_string_literal: true
|
|
|
|
|
2015-05-09 23:02:59 +00:00
|
|
|
# == Referable concern
|
|
|
|
#
|
|
|
|
# Contains functionality related to making a model referable in Markdown, such
|
|
|
|
# as "#1", "!2", "~3", etc.
|
|
|
|
module Referable
|
|
|
|
extend ActiveSupport::Concern
|
|
|
|
|
|
|
|
# Returns the String necessary to reference this object in Markdown
|
|
|
|
#
|
2017-11-22 13:20:35 +00:00
|
|
|
# from - Referring parent object
|
2015-05-09 23:02:59 +00:00
|
|
|
#
|
|
|
|
# This should be overridden by the including class.
|
|
|
|
#
|
|
|
|
# Examples:
|
|
|
|
#
|
|
|
|
# Issue.first.to_reference # => "#1"
|
|
|
|
# Issue.last.to_reference(other_project) # => "cross-project#1"
|
|
|
|
#
|
|
|
|
# Returns a String
|
2017-11-22 13:20:35 +00:00
|
|
|
def to_reference(_from = nil, full:)
|
2015-05-09 23:02:59 +00:00
|
|
|
''
|
|
|
|
end
|
|
|
|
|
2020-01-29 12:09:08 +00:00
|
|
|
# If this referable object can serve as the base for the
|
|
|
|
# reference of child objects (e.g. projects are the base of
|
|
|
|
# issues), but it is formatted differently, then you may wish
|
|
|
|
# to override this method.
|
|
|
|
def to_reference_base(from = nil, full:)
|
|
|
|
to_reference(from, full: full)
|
|
|
|
end
|
|
|
|
|
2017-11-22 13:20:35 +00:00
|
|
|
def reference_link_text(from = nil)
|
|
|
|
to_reference(from)
|
2015-12-01 11:58:45 +00:00
|
|
|
end
|
|
|
|
|
2017-08-16 19:02:38 +00:00
|
|
|
included do
|
|
|
|
alias_method :non_referable_inspect, :inspect
|
|
|
|
alias_method :inspect, :referable_inspect
|
|
|
|
end
|
|
|
|
|
2017-08-01 20:20:22 +00:00
|
|
|
def referable_inspect
|
|
|
|
if respond_to?(:id)
|
|
|
|
"#<#{self.class.name} id:#{id} #{to_reference(full: true)}>"
|
|
|
|
else
|
|
|
|
"#<#{self.class.name} #{to_reference(full: true)}>"
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2018-08-27 12:35:31 +00:00
|
|
|
class_methods do
|
2015-05-09 23:02:59 +00:00
|
|
|
# The character that prefixes the actual reference identifier
|
|
|
|
#
|
|
|
|
# This should be overridden by the including class.
|
|
|
|
#
|
|
|
|
# Examples:
|
|
|
|
#
|
|
|
|
# Issue.reference_prefix # => '#'
|
|
|
|
# MergeRequest.reference_prefix # => '!'
|
|
|
|
#
|
|
|
|
# Returns a String
|
|
|
|
def reference_prefix
|
|
|
|
''
|
|
|
|
end
|
2015-05-14 20:59:39 +00:00
|
|
|
|
|
|
|
# Regexp pattern used to match references to this object
|
|
|
|
#
|
|
|
|
# This must be overridden by the including class.
|
|
|
|
#
|
2015-05-14 21:09:02 +00:00
|
|
|
# Returns a Regexp
|
2015-05-14 20:59:39 +00:00
|
|
|
def reference_pattern
|
2015-05-15 20:09:17 +00:00
|
|
|
raise NotImplementedError, "#{self} does not implement #{__method__}"
|
2015-05-14 20:59:39 +00:00
|
|
|
end
|
2015-11-30 20:14:46 +00:00
|
|
|
|
2016-06-18 17:55:45 +00:00
|
|
|
def reference_valid?(reference)
|
|
|
|
true
|
|
|
|
end
|
|
|
|
|
2015-11-30 20:14:46 +00:00
|
|
|
def link_reference_pattern(route, pattern)
|
|
|
|
%r{
|
|
|
|
(?<url>
|
|
|
|
#{Regexp.escape(Gitlab.config.gitlab.url)}
|
|
|
|
\/#{Project.reference_pattern}
|
2019-05-29 11:34:00 +00:00
|
|
|
(?:\/\-)?
|
2020-01-18 00:09:18 +00:00
|
|
|
\/#{route.is_a?(Regexp) ? route : Regexp.escape(route)}
|
2015-11-30 20:14:46 +00:00
|
|
|
\/#{pattern}
|
|
|
|
(?<path>
|
2020-09-24 09:09:35 +00:00
|
|
|
(\/[a-z0-9_=-]+)*\/*
|
2015-11-30 20:14:46 +00:00
|
|
|
)?
|
|
|
|
(?<query>
|
|
|
|
\?[a-z0-9_=-]+
|
|
|
|
(&[a-z0-9_=-]+)*
|
|
|
|
)?
|
|
|
|
(?<anchor>\#[a-z0-9_-]+)?
|
|
|
|
)
|
|
|
|
}x
|
|
|
|
end
|
2015-05-09 23:02:59 +00:00
|
|
|
end
|
|
|
|
end
|