116 lines
3 KiB
Ruby
116 lines
3 KiB
Ruby
# A non-diff discussion on an issue, merge request, commit, or snippet, consisting of `DiscussionNote` notes.
|
|
#
|
|
# A discussion of this type can be resolvable.
|
|
class Discussion
|
|
include ResolvableDiscussion
|
|
|
|
attr_reader :notes, :noteable
|
|
|
|
delegate :created_at,
|
|
:project,
|
|
:author,
|
|
|
|
:noteable,
|
|
:for_commit?,
|
|
:for_merge_request?,
|
|
|
|
to: :first_note
|
|
|
|
def self.build(notes, noteable = nil)
|
|
notes.first.discussion_class(noteable).new(notes, noteable)
|
|
end
|
|
|
|
def self.build_collection(notes, noteable = nil)
|
|
notes.group_by { |n| n.discussion_id(noteable) }.values.map { |notes| build(notes, noteable) }
|
|
end
|
|
|
|
# Returns an alphanumeric discussion ID based on `build_discussion_id`
|
|
def self.discussion_id(note)
|
|
Digest::SHA1.hexdigest(build_discussion_id(note).join("-"))
|
|
end
|
|
|
|
# Returns an array of discussion ID components
|
|
def self.build_discussion_id(note)
|
|
[*base_discussion_id(note), SecureRandom.hex]
|
|
end
|
|
|
|
def self.base_discussion_id(note)
|
|
noteable_id = note.noteable_id || note.commit_id
|
|
[:discussion, note.noteable_type.try(:underscore), noteable_id]
|
|
end
|
|
|
|
# When notes on a commit are displayed in context of a merge request that contains that commit,
|
|
# these notes are to be displayed as if they were part of one discussion, even though they were actually
|
|
# individual notes on the commit with different discussion IDs, so that it's clear that these are not
|
|
# notes on the merge request itself.
|
|
#
|
|
# To turn a list of notes into a list of discussions, they are grouped by discussion ID, so to
|
|
# get these out-of-context notes to end up in the same discussion, we need to get them to return the same
|
|
# `discussion_id` when this grouping happens. To enable this, `Note#discussion_id` calls out
|
|
# to the `override_discussion_id` method on the appropriate `Discussion` subclass, as determined by
|
|
# the `discussion_class` method on `Note` or a subclass of `Note`.
|
|
#
|
|
# If no override is necessary, return `nil`.
|
|
# For the case described above, see `OutOfContextDiscussion.override_discussion_id`.
|
|
def self.override_discussion_id(note)
|
|
nil
|
|
end
|
|
|
|
def self.note_class
|
|
DiscussionNote
|
|
end
|
|
|
|
def initialize(notes, noteable = nil)
|
|
@notes = notes
|
|
@noteable = noteable
|
|
end
|
|
|
|
def ==(other)
|
|
other.class == self.class &&
|
|
other.noteable == self.noteable &&
|
|
other.id == self.id &&
|
|
other.notes == self.notes
|
|
end
|
|
|
|
def last_updated_at
|
|
last_note.created_at
|
|
end
|
|
|
|
def last_updated_by
|
|
last_note.author
|
|
end
|
|
|
|
def id
|
|
first_note.discussion_id(noteable)
|
|
end
|
|
|
|
alias_method :to_param, :id
|
|
|
|
def diff_discussion?
|
|
false
|
|
end
|
|
|
|
def individual_note?
|
|
false
|
|
end
|
|
|
|
def new_discussion?
|
|
notes.length == 1
|
|
end
|
|
|
|
def last_note
|
|
@last_note ||= notes.last
|
|
end
|
|
|
|
def collapsed?
|
|
resolved?
|
|
end
|
|
|
|
def expanded?
|
|
!collapsed?
|
|
end
|
|
|
|
def reply_attributes
|
|
first_note.slice(:type, :noteable_type, :noteable_id, :commit_id, :discussion_id)
|
|
end
|
|
end
|