2014-08-25 09:25:02 +00:00
|
|
|
# == Schema Information
|
|
|
|
#
|
|
|
|
# Table name: labels
|
|
|
|
#
|
2016-02-17 13:52:12 +00:00
|
|
|
# id :integer not null, primary key
|
|
|
|
# title :string(255)
|
|
|
|
# color :string(255)
|
|
|
|
# project_id :integer
|
|
|
|
# created_at :datetime
|
|
|
|
# updated_at :datetime
|
|
|
|
# template :boolean default(FALSE)
|
|
|
|
# description :string(255)
|
2014-08-25 09:25:02 +00:00
|
|
|
#
|
|
|
|
|
2014-07-29 14:10:15 +00:00
|
|
|
class Label < ActiveRecord::Base
|
2015-05-03 03:11:21 +00:00
|
|
|
include Referable
|
2016-02-12 14:58:39 +00:00
|
|
|
include Subscribable
|
|
|
|
|
2015-10-06 16:57:13 +00:00
|
|
|
# Represents a "No Label" state used for filtering Issues and Merge
|
|
|
|
# Requests that have no label assigned.
|
2015-10-09 04:24:55 +00:00
|
|
|
LabelStruct = Struct.new(:title, :name)
|
|
|
|
None = LabelStruct.new('No Label', 'No Label')
|
2015-12-02 13:10:43 +00:00
|
|
|
Any = LabelStruct.new('Any Label', '')
|
2015-05-03 03:11:21 +00:00
|
|
|
|
2014-08-15 09:02:05 +00:00
|
|
|
DEFAULT_COLOR = '#428BCA'
|
2014-08-14 08:17:52 +00:00
|
|
|
|
2015-04-17 15:38:31 +00:00
|
|
|
default_value_for :color, DEFAULT_COLOR
|
|
|
|
|
2014-07-29 14:10:15 +00:00
|
|
|
belongs_to :project
|
|
|
|
has_many :label_links, dependent: :destroy
|
2014-07-30 12:15:39 +00:00
|
|
|
has_many :issues, through: :label_links, source: :target, source_type: 'Issue'
|
2016-03-02 02:04:13 +00:00
|
|
|
has_many :merge_requests, through: :label_links, source: :target, source_type: 'MergeRequest'
|
2014-07-29 14:10:15 +00:00
|
|
|
|
2015-12-01 23:53:44 +00:00
|
|
|
validates :color, color: true, allow_blank: false
|
2015-09-03 12:50:23 +00:00
|
|
|
validates :project, presence: true, unless: Proc.new { |service| service.template? }
|
2014-07-30 10:26:54 +00:00
|
|
|
|
2014-08-11 21:59:30 +00:00
|
|
|
# Don't allow '?', '&', and ',' for label titles
|
2014-08-12 08:53:50 +00:00
|
|
|
validates :title,
|
|
|
|
presence: true,
|
2015-04-10 20:14:00 +00:00
|
|
|
format: { with: /\A[^&\?,]+\z/ },
|
2014-08-13 12:12:05 +00:00
|
|
|
uniqueness: { scope: :project_id }
|
2014-07-29 16:19:26 +00:00
|
|
|
|
2015-02-06 04:29:41 +00:00
|
|
|
default_scope { order(title: :asc) }
|
2014-07-30 16:13:35 +00:00
|
|
|
|
2015-09-03 12:50:23 +00:00
|
|
|
scope :templates, -> { where(template: true) }
|
|
|
|
|
2014-08-12 12:16:25 +00:00
|
|
|
alias_attribute :name, :title
|
2014-07-30 12:15:39 +00:00
|
|
|
|
2015-05-03 03:11:21 +00:00
|
|
|
def self.reference_prefix
|
|
|
|
'~'
|
|
|
|
end
|
|
|
|
|
2016-03-01 10:39:49 +00:00
|
|
|
##
|
2015-05-14 20:59:39 +00:00
|
|
|
# Pattern used to extract label references from text
|
2016-03-01 10:39:49 +00:00
|
|
|
#
|
|
|
|
# This pattern supports cross-project references.
|
|
|
|
#
|
2015-05-14 20:59:39 +00:00
|
|
|
def self.reference_pattern
|
2016-03-24 15:41:48 +00:00
|
|
|
@reference_pattern ||= %r{
|
2016-02-25 12:49:42 +00:00
|
|
|
(#{Project.reference_pattern})?
|
|
|
|
#{Regexp.escape(reference_prefix)}
|
2015-05-14 20:59:39 +00:00
|
|
|
(?:
|
2015-05-15 20:07:25 +00:00
|
|
|
(?<label_id>\d+) | # Integer-based label ID, or
|
2015-05-14 20:59:39 +00:00
|
|
|
(?<label_name>
|
2015-05-15 20:07:25 +00:00
|
|
|
[A-Za-z0-9_-]+ | # String-based single-word label title, or
|
|
|
|
"[^&\?,]+" # String-based multi-word label surrounded in quotes
|
2015-05-14 20:59:39 +00:00
|
|
|
)
|
|
|
|
)
|
|
|
|
}x
|
|
|
|
end
|
|
|
|
|
2016-02-25 12:49:42 +00:00
|
|
|
def self.link_reference_pattern
|
|
|
|
nil
|
|
|
|
end
|
|
|
|
|
2016-02-25 13:26:41 +00:00
|
|
|
##
|
2015-05-03 03:11:21 +00:00
|
|
|
# Returns the String necessary to reference this Label in Markdown
|
|
|
|
#
|
|
|
|
# format - Symbol format to use (default: :id, optional: :name)
|
|
|
|
#
|
|
|
|
# Examples:
|
|
|
|
#
|
2016-02-25 07:37:49 +00:00
|
|
|
# Label.first.to_reference # => "~1"
|
|
|
|
# Label.first.to_reference(format: :name) # => "~\"bug\""
|
2016-02-25 09:14:12 +00:00
|
|
|
# Label.first.to_reference(project) # => "gitlab-org/gitlab-ce~1"
|
2015-05-03 03:11:21 +00:00
|
|
|
#
|
|
|
|
# Returns a String
|
2016-02-25 13:26:41 +00:00
|
|
|
#
|
2016-02-25 09:14:12 +00:00
|
|
|
def to_reference(from_project = nil, format: :id)
|
2016-03-03 09:39:18 +00:00
|
|
|
format_reference = label_format_reference(format)
|
|
|
|
reference = "#{self.class.reference_prefix}#{format_reference}"
|
2016-02-25 09:14:12 +00:00
|
|
|
|
|
|
|
if cross_project_reference?(from_project)
|
|
|
|
project.to_reference + reference
|
2015-05-03 03:11:21 +00:00
|
|
|
else
|
2016-02-25 09:14:12 +00:00
|
|
|
reference
|
2015-05-03 03:11:21 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-03-21 23:21:23 +00:00
|
|
|
def open_issues_count(user = nil)
|
|
|
|
issues.visible_to_user(user).opened.count
|
2014-07-30 12:15:39 +00:00
|
|
|
end
|
2015-09-03 12:50:23 +00:00
|
|
|
|
2016-03-21 23:21:23 +00:00
|
|
|
def closed_issues_count(user = nil)
|
|
|
|
issues.visible_to_user(user).closed.count
|
2016-01-25 17:07:04 +00:00
|
|
|
end
|
|
|
|
|
2016-03-02 02:04:34 +00:00
|
|
|
def open_merge_requests_count
|
|
|
|
merge_requests.opened.count
|
|
|
|
end
|
|
|
|
|
2015-09-03 12:50:23 +00:00
|
|
|
def template?
|
|
|
|
template
|
|
|
|
end
|
2016-02-25 09:14:12 +00:00
|
|
|
|
2016-04-20 16:00:12 +00:00
|
|
|
def text_color
|
|
|
|
LabelsHelper::text_color_for_bg(self.color)
|
|
|
|
end
|
|
|
|
|
2016-05-04 21:21:57 +00:00
|
|
|
def title= value
|
|
|
|
value = Sanitize.clean(value.to_s) if value
|
|
|
|
write_attribute(:title, Sanitize.clean(value))
|
|
|
|
end
|
|
|
|
|
2016-02-25 09:14:12 +00:00
|
|
|
private
|
|
|
|
|
|
|
|
def label_format_reference(format = :id)
|
|
|
|
raise StandardError, 'Unknown format' unless [:id, :name].include?(format)
|
|
|
|
|
|
|
|
if format == :name && !name.include?('"')
|
2016-03-03 09:39:18 +00:00
|
|
|
%("#{name}")
|
2016-02-25 09:14:12 +00:00
|
|
|
else
|
2016-03-03 09:39:18 +00:00
|
|
|
id
|
2016-02-25 09:14:12 +00:00
|
|
|
end
|
|
|
|
end
|
2014-07-29 14:10:15 +00:00
|
|
|
end
|