3da2244c-e957-4d79-aa3e-73e6ff42a18b

Committed 19 Sep 2024 01:56PM UTC coverage: 96.166% (-0.02%) from 96.19%

Build # 3da2244c-e957-4d79-aa3e-73e6ff42a18b

Build Type

push

circleci

Committed by

jrgriffiniii

Commit Message

wip

Run Details

5 of 6 new or added lines in 2 files covered. (83.33%)

1 existing line in 1 file now uncovered.

3311 of 3443 relevant lines covered (96.17%)

410.76 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

95.27

/app/models/work_activity.rb

# frozen_string_literal: true

require_relative "../lib/diff_tools"

# rubocop:disable Metrics/ClassLength
class WorkActivity < ApplicationRecord
  MESSAGE = "COMMENT" # TODO: Migrate existing records to "MESSAGE"; then close #825.
  NOTIFICATION = "NOTIFICATION"
  MESSAGE_ACTIVITY_TYPES = [MESSAGE, NOTIFICATION].freeze

  CHANGES = "CHANGES"
  DATACITE_ERROR = "DATACITE-ERROR"
  FILE_CHANGES = "FILE-CHANGES"
  MIGRATION_START = "MIGRATION_START"
  MIGRATION_COMPLETE = "MIGRATION_COMPLETE"
  PROVENANCE_NOTES = "PROVENANCE-NOTES"
  SYSTEM = "SYSTEM"
  CHANGE_LOG_ACTIVITY_TYPES = [CHANGES, FILE_CHANGES, PROVENANCE_NOTES, SYSTEM, DATACITE_ERROR, MIGRATION_COMPLETE].freeze

  USER_REFERENCE = /@[\w]*/ # e.g. @xy123

  include Rails.application.routes.url_helpers

  belongs_to :work
  has_many :work_activity_notifications, dependent: :destroy

  def self.add_work_activity(work_id, message, user_id, activity_type:, created_at: nil)
    activity = WorkActivity.new(
      work_id:,
      activity_type:,
      message:,
      created_by_user_id: user_id,
      created_at: # If nil, will be set by activerecord at save.
    )
    activity.save!
    activity.notify_users
    activity
  end

  def self.activities_for_work(work_id, activity_types)
    where(work_id:, activity_type: activity_types)
  end

  def self.messages_for_work(work_id)
    activities_for_work(work_id, MESSAGE_ACTIVITY_TYPES)
  end

  def self.changes_for_work(work_id)
    activities_for_work(work_id, CHANGE_LOG_ACTIVITY_TYPES)
  end

  # Log notifications for each of the users references on the activity
  def notify_users
    users_referenced.each do |uid|
      user_id = User.where(uid:).first&.id
      if user_id.nil?
        notify_group(uid)
      else
        WorkActivityNotification.create(work_activity_id: id, user_id:)
      end
    end
  end

  def notify_group(groupid)
    group = Group.where(code: groupid).first
    if group.nil?
      Rails.logger.info("Message #{id} for work #{work_id} referenced an non-existing user: #{groupid}")
    else
      group.administrators.each do |admin|
        WorkActivityNotification.create(work_activity_id: id, user_id: admin.id)
      end
    end
  end

  # Returns the `uid` of the users referenced on the activity (without the `@` symbol)
  def users_referenced
    message.scan(USER_REFERENCE).map { |at_uid| at_uid[1..-1] }
  end

  def created_by_user
    return nil unless created_by_user_id

    User.find(created_by_user_id)
  end

  def message_event_type?
    MESSAGE_ACTIVITY_TYPES.include? activity_type
  end

  def log_event_type?
    CHANGE_LOG_ACTIVITY_TYPES.include? activity_type
  end

  def renderer
    @renderer ||= begin
                    klass = if activity_type == CHANGES
                              MetadataChanges
                            elsif activity_type == FILE_CHANGES
                              FileChanges
                            elsif activity_type == MIGRATION_COMPLETE
                              Migration
                            elsif activity_type == PROVENANCE_NOTES
                              ProvenanceNote
                            elsif CHANGE_LOG_ACTIVITY_TYPES.include?(activity_type)
                              OtherLogEvent
                            else
                              Message
                            end
                    klass.new(self)

                  end
  end

  delegate :to_html, to: :renderer

  class Renderer
    def initialize(work_activity)
      @work_activity = work_activity
    end

    UNKNOWN_USER = "Unknown user outside the system"
    DATE_TIME_FORMAT = "%B %d, %Y %H:%M"
    DATE_FORMAT = "%B %d, %Y"
    SORTABLE_DATE_TIME_FORMAT = "%Y-%m-%d %H:%M"

    def to_html
      title_html + "<span class='message-html'>#{body_html.chomp}</span>"
    end

    def created_by_user_html
      return UNKNOWN_USER unless @work_activity.created_by_user

      "#{@work_activity.created_by_user.given_name_safe} (@#{@work_activity.created_by_user.uid})"
    end

    def created_sortable_html
      @work_activity.created_at.time.strftime(SORTABLE_DATE_TIME_FORMAT)
    end

    def created_updated_html
      created = @work_activity.created_at.time.strftime(DATE_TIME_FORMAT)
      updated = @work_activity.updated_at.time.strftime(DATE_TIME_FORMAT)
      created_date = @work_activity.created_at.time.strftime(DATE_FORMAT)
      updated_date = @work_activity.updated_at.time.strftime(DATE_FORMAT)
      if created_date == updated_date
        created
      else
        "#{created} (backdated event created #{updated})"
      end
    end

    def title_html
      "<span class='activity-history-title'>#{created_updated_html} by #{created_by_user_html}</span>"
    end
  end

  class MetadataChanges < Renderer
    # Returns the message formatted to display _metadata_ changes that were logged as an activity
    def body_html
      message_json = JSON.parse(@work_activity.message)

      # Messages should consistently be Arrays of Hashes, but this might require a migration from legacy field records
      messages = if message_json.is_a?(Array)
                   message_json
                 else
                   Array.wrap(message_json)
                 end

      elements = messages.map do |message|
        markup = if message.is_a?(Hash)
                   message.keys.map do |field|
                     mapped = message[field].map { |value| change_value_html(value) }
                     "<details class='message-html'><summary class='show-changes'>#{field&.titleize}</summary>#{mapped.join}</details>"
                   end
                 else
                   # For handling cases where WorkActivity#message only contains Strings, or Arrays of Strings
                   [
                     "<details class='message-html'><summary class='show-changes'></summary>#{message}</details>"
                   ]
                 end
        markup.join
      end

      elements.flatten.join
    end

    def change_value_html(value)
      if value["action"] == "changed"
        DiffTools::SimpleDiff.new(value["from"], value["to"]).to_html
      else
        "old change"
      end
    end
  end

  class FileChanges < Renderer
    # Returns the message formatted to display _file_ changes that were logged as an activity
    def body_html
      changes = JSON.parse(@work_activity.message)
      if changes.is_a?(Hash)
        changes = [changes]
      end

      files_added = changes.select { |v| v["action"] == "added" }
      files_deleted = changes.select { |v| v["action"] == "removed" }
      files_replaced = changes.select { |v| v["action"] == "replaced" }

      changes_html = []
      unless files_added.empty?
        label = "Files Added: "
        label += files_added.length.to_s
        changes_html << "<tr><td>#{label}</td></tr>"
      end

      unless files_deleted.empty?
        label = "Files Deleted: "
        label += files_deleted.length.to_s
        changes_html << "<tr><td>#{label}</td></tr>"
      end

      unless files_replaced.empty?
        label = "Files Replaced: "
        label += files_replaced.length.to_s
        changes_html << "<tr><td>#{label}</td></tr>"
      end

      "<table>#{changes_html.join}</table>"
    end
  end

  class Migration < Renderer
    # Returns the message formatted to display _file_ changes that were logged as an activity
    def body_html
      changes = JSON.parse(@work_activity.message)
      "<p>#{changes['message']}</p>"
    end
  end

  class BaseMessage < Renderer
    def body_html
      text = user_refernces(@work_activity.message)
      mark_down_to_html(text)
    end

    def mark_down_to_html(text_in)
      # allow ``` for code blocks (Kramdown only supports ~~~)
      text = text_in.gsub("```", "~~~")
      Kramdown::Document.new(text).to_html
    end

    def user_refernces(text_in)
      # convert user references to user links
      text_in.gsub(USER_REFERENCE) do |at_uid|
        uid = at_uid[1..-1]

        if uid
          group = Group.find_by(code: uid)
          if group
            "<a class='message-user-link' title='#{group.title}' href='#{@work_activity.group_path(group)}'>#{group.title}</a>"
          else
            user = User.find_by(uid:)
            user_info = if user
                          user.given_name_safe
                        else
                          uid
                        end
            "<a class='message-user-link' title='#{user_info}' href='#{@work_activity.users_path}/#{uid}'>#{at_uid}</a>"
          end
        else
          Rails.logger.warn("Failed to extract the user ID from #{uid}")
          UNKNOWN_USER
        end
      end
    end
  end

  class OtherLogEvent < BaseMessage
  end

  class Message < BaseMessage
    # Override the default:
    def created_by_user_html
      return UNKNOWN_USER unless @work_activity.created_by_user

      user = @work_activity.created_by_user
      "#{user.given_name_safe} (@#{user.uid})"
    end

    def title_html
      "<span class='activity-history-title'>#{created_by_user_html} at #{created_updated_html}</span>"
    end
  end

  class ProvenanceNote < BaseMessage
    def body_html
      message_hash = JSON.parse(@work_activity.message)
      text = user_refernces(message_hash["note"])
      message = mark_down_to_html(text)
      change_label = message_hash["change_label"]&.titleize
      change_label ||= "Change"
      # TODO: Make this show the change label with the note under see changes
      "<details class='message-html'><summary class='show-changes'>#{change_label}</summary>#{message}</details>"
    end
  end
end
# rubocop:enable Metrics/ClassLength

1	# frozen_string_literal: true
2
3	require_relative "../lib/diff_tools"	2✔
4
5	# rubocop:disable Metrics/ClassLength
6	class WorkActivity < ApplicationRecord	2✔
7	MESSAGE = "COMMENT" # TODO: Migrate existing records to "MESSAGE"; then close #825.	2✔
8	NOTIFICATION = "NOTIFICATION"	2✔
9	MESSAGE_ACTIVITY_TYPES = [MESSAGE, NOTIFICATION].freeze	2✔
10
11	CHANGES = "CHANGES"	2✔
12	DATACITE_ERROR = "DATACITE-ERROR"	2✔
13	FILE_CHANGES = "FILE-CHANGES"	2✔
14	MIGRATION_START = "MIGRATION_START"	2✔
15	MIGRATION_COMPLETE = "MIGRATION_COMPLETE"	2✔
16	PROVENANCE_NOTES = "PROVENANCE-NOTES"	2✔
17	SYSTEM = "SYSTEM"	2✔
18	CHANGE_LOG_ACTIVITY_TYPES = [CHANGES, FILE_CHANGES, PROVENANCE_NOTES, SYSTEM, DATACITE_ERROR, MIGRATION_COMPLETE].freeze	2✔
19
20	USER_REFERENCE = /@[\w]*/ # e.g. @xy123	2✔
21
22	include Rails.application.routes.url_helpers	2✔
23
24	belongs_to :work	2✔
25	has_many :work_activity_notifications, dependent: :destroy	2✔
26
27	def self.add_work_activity(work_id, message, user_id, activity_type:, created_at: nil)	2✔
28	activity = WorkActivity.new(	898✔
29	work_id:,
30	activity_type:,
31	message:,
32	created_by_user_id: user_id,
33	created_at: # If nil, will be set by activerecord at save.
34	)
35	activity.save!	898✔
36	activity.notify_users	898✔
37	activity	898✔
38	end
39
40	def self.activities_for_work(work_id, activity_types)	2✔
41	where(work_id:, activity_type: activity_types)	1,342✔
42	end
43
44	def self.messages_for_work(work_id)	2✔
45	activities_for_work(work_id, MESSAGE_ACTIVITY_TYPES)	548✔
46	end
47
48	def self.changes_for_work(work_id)	2✔
49	activities_for_work(work_id, CHANGE_LOG_ACTIVITY_TYPES)	552✔
50	end
51
52	# Log notifications for each of the users references on the activity
53	def notify_users	2✔
54	users_referenced.each do \|uid\|	910✔
55	user_id = User.where(uid:).first&.id	468✔
56	if user_id.nil?	468✔
57	notify_group(uid)	202✔
58	else
59	WorkActivityNotification.create(work_activity_id: id, user_id:)	266✔
60	end
61	end
62	end
63
64	def notify_group(groupid)	2✔
65	group = Group.where(code: groupid).first	202✔
66	if group.nil?	202✔
67	Rails.logger.info("Message #{id} for work #{work_id} referenced an non-existing user: #{groupid}")	6✔
68	else
69	group.administrators.each do \|admin\|	196✔
70	WorkActivityNotification.create(work_activity_id: id, user_id: admin.id)	118✔
71	end
72	end
73	end
74
75	# Returns the `uid` of the users referenced on the activity (without the `@` symbol)
76	def users_referenced	2✔
77	message.scan(USER_REFERENCE).map { \|at_uid\| at_uid[1..-1] }	1,378✔
78	end
79
80	def created_by_user	2✔
81	return nil unless created_by_user_id	652✔
82
83	User.find(created_by_user_id)	642✔
84	end
85
86	def message_event_type?	2✔
87	MESSAGE_ACTIVITY_TYPES.include? activity_type	×
88	end
89
90	def log_event_type?	2✔
91	CHANGE_LOG_ACTIVITY_TYPES.include? activity_type	×
92	end
93
94	def renderer	2✔
95	@renderer \|\|= begin	240✔
96	klass = if activity_type == CHANGES	238✔
97	MetadataChanges	64✔
98	elsif activity_type == FILE_CHANGES	174✔
99	FileChanges	20✔
100	elsif activity_type == MIGRATION_COMPLETE	154✔
101	Migration	2✔
102	elsif activity_type == PROVENANCE_NOTES	152✔
103	ProvenanceNote	10✔
104	elsif CHANGE_LOG_ACTIVITY_TYPES.include?(activity_type)	142✔
105	OtherLogEvent	66✔
106	else
107	Message	76✔
108	end
109	klass.new(self)	238✔
110
111	end
112	end
113
114	delegate :to_html, to: :renderer	2✔
115
116	class Renderer	2✔
117	def initialize(work_activity)	2✔
118	@work_activity = work_activity	238✔
119	end
120
121	UNKNOWN_USER = "Unknown user outside the system"	2✔
122	DATE_TIME_FORMAT = "%B %d, %Y %H:%M"	2✔
123	DATE_FORMAT = "%B %d, %Y"	2✔
124	SORTABLE_DATE_TIME_FORMAT = "%Y-%m-%d %H:%M"	2✔
125
126	def to_html	2✔
127	title_html + "<span class='message-html'>#{body_html.chomp}</span>"	230✔
128	end
129
130	def created_by_user_html	2✔
131	return UNKNOWN_USER unless @work_activity.created_by_user	162✔
132
133	"#{@work_activity.created_by_user.given_name_safe} (@#{@work_activity.created_by_user.uid})"	154✔
134	end
135
136	def created_sortable_html	2✔
137	@work_activity.created_at.time.strftime(SORTABLE_DATE_TIME_FORMAT)	10✔
138	end
139
140	def created_updated_html	2✔
141	created = @work_activity.created_at.time.strftime(DATE_TIME_FORMAT)	230✔
142	updated = @work_activity.updated_at.time.strftime(DATE_TIME_FORMAT)	230✔
143	created_date = @work_activity.created_at.time.strftime(DATE_FORMAT)	230✔
144	updated_date = @work_activity.updated_at.time.strftime(DATE_FORMAT)	230✔
145	if created_date == updated_date	230✔
146	created	206✔
147	else
148	"#{created} (backdated event created #{updated})"	24✔
149	end
150	end
151
152	def title_html	2✔
153	"<span class='activity-history-title'>#{created_updated_html} by #{created_by_user_html}</span>"	152✔
154	end
155	end
156
157	class MetadataChanges < Renderer	2✔
158	# Returns the message formatted to display _metadata_ changes that were logged as an activity
159	def body_html	2✔
160	message_json = JSON.parse(@work_activity.message)	64✔
161
162	# Messages should consistently be Arrays of Hashes, but this might require a migration from legacy field records
163	messages = if message_json.is_a?(Array)	64✔
164	message_json	×
165	else
166	Array.wrap(message_json)	64✔
167	end
168
169	elements = messages.map do \|message\|	64✔
170	markup = if message.is_a?(Hash)	64✔
171	message.keys.map do \|field\|	64✔
172	mapped = message[field].map { \|value\| change_value_html(value) }	352✔
173	"<details class='message-html'><summary class='show-changes'>#{field&.titleize}</summary>#{mapped.join}</details>"	176✔
174	end
175	else
176	# For handling cases where WorkActivity#message only contains Strings, or Arrays of Strings
177	[
178	"<details class='message-html'><summary class='show-changes'></summary>#{message}</details>"	×
179	]
180	end
181	markup.join	64✔
182	end
183
184	elements.flatten.join	64✔
185	end
186
187	def change_value_html(value)	2✔
188	if value["action"] == "changed"	176✔
189	DiffTools::SimpleDiff.new(value["from"], value["to"]).to_html	176✔
190	else
191	"old change"	×
192	end
193	end
194	end
195
196	class FileChanges < Renderer	2✔
197	# Returns the message formatted to display _file_ changes that were logged as an activity
198	def body_html	2✔
199	changes = JSON.parse(@work_activity.message)	20✔
200	if changes.is_a?(Hash)	20✔
201	changes = [changes]	2✔
202	end
203
204	files_added = changes.select { \|v\| v["action"] == "added" }	60✔
205	files_deleted = changes.select { \|v\| v["action"] == "removed" }	60✔
206	files_replaced = changes.select { \|v\| v["action"] == "replaced" }	60✔
207
208	changes_html = []	20✔
209	unless files_added.empty?	20✔
210	label = "Files Added: "	18✔
211	label += files_added.length.to_s	18✔
212	changes_html << "<tr><td>#{label}</td></tr>"	18✔
213	end
214
215	unless files_deleted.empty?	20✔
216	label = "Files Deleted: "	4✔
217	label += files_deleted.length.to_s	4✔
218	changes_html << "<tr><td>#{label}</td></tr>"	4✔
219	end
220
221	unless files_replaced.empty?	20✔
222	label = "Files Replaced: "	2✔
223	label += files_replaced.length.to_s	2✔
224	changes_html << "<tr><td>#{label}</td></tr>"	2✔
225	end
226
227	"<table>#{changes_html.join}</table>"	20✔
228	end
229	end
230
231	class Migration < Renderer	2✔
232	# Returns the message formatted to display _file_ changes that were logged as an activity
233	def body_html	2✔
234	changes = JSON.parse(@work_activity.message)	2✔
235	"<p>#{changes['message']}</p>"	2✔
236	end
237	end
238
239	class BaseMessage < Renderer	2✔
240	def body_html	2✔
241	text = user_refernces(@work_activity.message)	144✔
242	mark_down_to_html(text)	144✔
243	end
244
245	def mark_down_to_html(text_in)	2✔
246	# allow ``` for code blocks (Kramdown only supports ~~~)
247	text = text_in.gsub("```", "~~~")	154✔
248	Kramdown::Document.new(text).to_html	154✔
249	end
250
251	def user_refernces(text_in)	2✔
252	# convert user references to user links
253	text_in.gsub(USER_REFERENCE) do \|at_uid\|	154✔
254	uid = at_uid[1..-1]	100✔
255
256	if uid	100✔
257	group = Group.find_by(code: uid)	100✔
258	if group	100✔
259	"<a class='message-user-link' title='#{group.title}' href='#{@work_activity.group_path(group)}'>#{group.title}</a>"	44✔
260	else
261	user = User.find_by(uid:)	56✔
262	user_info = if user	56✔
263	user.given_name_safe	56✔
264	else
265	uid	×
266	end
267	"<a class='message-user-link' title='#{user_info}' href='#{@work_activity.users_path}/#{uid}'>#{at_uid}</a>"	56✔
268	end
269	else
NEW 270	Rails.logger.warn("Failed to extract the user ID from #{uid}")	×
UNCOV 271	UNKNOWN_USER	×
272	end
273	end
274	end
275	end
276
277	class OtherLogEvent < BaseMessage	2✔
278	end
279
280	class Message < BaseMessage	2✔
281	# Override the default:
282	def created_by_user_html	2✔
283	return UNKNOWN_USER unless @work_activity.created_by_user	78✔
284
285	user = @work_activity.created_by_user	76✔
286	"#{user.given_name_safe} (@#{user.uid})"	76✔
287	end
288
289	def title_html	2✔
290	"<span class='activity-history-title'>#{created_by_user_html} at #{created_updated_html}</span>"	78✔
291	end
292	end
293
294	class ProvenanceNote < BaseMessage	2✔
295	def body_html	2✔
296	message_hash = JSON.parse(@work_activity.message)	10✔
297	text = user_refernces(message_hash["note"])	10✔
298	message = mark_down_to_html(text)	10✔
299	change_label = message_hash["change_label"]&.titleize	10✔
300	change_label \|\|= "Change"	10✔
301	# TODO: Make this show the change label with the note under see changes
302	"<details class='message-html'><summary class='show-changes'>#{change_label}</summary>#{message}</details>"	10✔
303	end
304	end
305	end
306	# rubocop:enable Metrics/ClassLength

pulibrary / pdc_describe / 3da2244c-e957-4d79-aa3e-73e6ff42a18b

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous