cace366a-ffad-45f1-9b60-678e607fa527

Committed 14 May 2024 02:21PM UTC coverage: 60.862% (-35.0%) from 95.908%

Build # cace366a-ffad-45f1-9b60-678e607fa527

Build Type

push

circleci

Committed by

jrgriffiniii

Commit Message

wip

Run Details

1 of 3 new or added lines in 2 files covered. (33.33%)

1194 existing lines in 57 files now uncovered.

2076 of 3411 relevant lines covered (60.86%)

22.71 hits per line

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

81.55

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

pulibrary / pdc_describe / cace366a-ffad-45f1-9b60-678e607fa527

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