jirametrics 2.0.1 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26b8d8955807f88acf9f1cce8443d183a9fb72fce98424aba3c7c29e876a6a38
-  data.tar.gz: '039eb9fd005ed0a036f20c72e8f9a8c4cb4bad19f030ed3cf0445bdb6afb0902'
+  metadata.gz: b424b3a1faea57826e0afa0d607b5edea1b824a14af63d2f4fc6b00e4f0c6190
+  data.tar.gz: c4fa2e71b82a118140cbcfaeb8000133917189c5449d7aa03a93d601b2df410b
 SHA512:
-  metadata.gz: ecf2036e99a4bed4275da79e58740bac58c00d8a61120872abb0d51459631d7b7f5c80898bf4bb1212a87042c54cdb83ace95c1f86d2f2df43b8611626bbf1a0
-  data.tar.gz: 5f01cabf487497389977fab8d341d5173e3c5835c8e42422d232aa3ba5b8aaa40af0cb975235374bf953cecf45b2615c5f6b6391560fcdcf6c0f1d77d6ae9e3f
+  metadata.gz: b361d8f4ab3952de3fbc3b39f70704e6817a157d9166218ad436f80f13ca80d83b26a10a002c08528da298a9e8a961ed699dbb121fc6a7edda75572209c0501f
+  data.tar.gz: 86ce2be29726bf2870d8a8bda0e6fd12184f09946e1cbb04fd66b8666b2ae878ec405e20f2b1658f42ccc6f6b783222853d95cb1603b34158a0ada3e4e37c897

data/lib/jirametrics/aging_work_bar_chart.rb

@@ -17,10 +17,15 @@ class AgingWorkBarChart < ChartBase
       <p>
         There are potentially three bars for each issue, although a bar may be missing if the issue has no
         information relevant to that. Hovering over any of the bars will provide more details.
-        <ol><li>The top bar tells you what status the issue is in at any time.</li>
-        <li>The middle bar indicates blocked and stalled states. A lighter orange is stalled and a darker,
-        reddish colour is blocked.</li>
-        <li>The bottom bar indicated an expedited state.</li></ol>
+        <ol>
+          <li>The top bar tells you what status the issue is in at any time. The colour indicates the
+          status category, which will be one of #{color_block '--status-category-todo-color'} To Do,
+          #{color_block '--status-category-inprogress-color'} In Progress,
+          or #{color_block '--status-category-done-color'} Done</li>
+          <li>The middle bar indicates #{color_block '--blocked-color'} blocked
+          or #{color_block '--stalled-color'} stalled.</li>
+          <li>The bottom bar indicated #{color_block '--expedited-color'} expedited.</li>
+        </ol>
       </p>
       <p>
         The gray backgrounds indicate weekends and the red vertical line indicates the 85% point for all
@@ -65,7 +70,7 @@ class AgingWorkBarChart < ChartBase
           issue_label: issue_label,
           title_label: 'Expedited',
           stack: 'expedited',
-          color: 'red',
+          color: CssVariable['--expedited-color'],
           start_date: issue_start_date
         ) { |day| issue.expedited_on_date?(day) }
       ].compact.flatten.each do |data|
@@ -109,7 +114,7 @@ class AgingWorkBarChart < ChartBase
             title: "#{issue.type} : #{change.value}"
           }],
           backgroundColor: status_category_color(status),
-          borderColor: 'white',
+          borderColor: CssVariable['--aging-work-bar-chart-separator-color'],
           borderWidth: {
              top: 0,
              right: 1,
@@ -144,10 +149,13 @@ class AgingWorkBarChart < ChartBase
   end
 
   def one_block_change_data_set starting_change:, ending_time:, issue_label:, stack:, issue_start_time:
-    color = settings['colors']['blocked']
-    color = settings['colors']['stalled'] if starting_change.stalled?
+    deprecated message: 'blocked color should be set via css now', date: '2024-05-03' if settings['blocked_color']
+    deprecated message: 'blocked color should be set via css now', date: '2024-05-03' if settings['stalled_color']
+
+    color = settings['blocked_color'] || '--blocked-color'
+    color = settings['stalled_color'] || '--stalled-color' if starting_change.stalled?
     {
-      backgroundColor: color,
+      backgroundColor: CssVariable[color],
       data: [
         {
           title: starting_change.reasons,

data/lib/jirametrics/aging_work_in_progress_chart.rb

@@ -14,13 +14,14 @@ class AgingWorkInProgressChart < ChartBase
     description_text <<-HTML
       <p>
         This chart shows only work items that have started but not completed, grouped by the column
-      they're currently in. Hovering over a dot will show you the ID of that work item.
-      </p>
-      <p>
-        The gray area indicates the 85% mark for work items that have passed through here - 85% of
-        previous work items left this column while still inside the gray area. Any work items above
-        the gray area are outliers and they are the items that you should pay special attention to.
+        they're currently in. Hovering over a dot will show you the ID of that work item.
       </p>
+      <div>
+        The #{color_block '--non-working-days-color'} shaded area indicates the 85%
+        mark for work items that have passed through here; 85% of
+        previous work items left this column while still inside the shaded area. Any work items above
+        the shading are outliers and they are the items that you should pay special attention to.
+      </div>
     HTML
     init_configuration_block(block) do
       grouping_rules do |issue, rule|
@@ -87,6 +88,7 @@ class AgingWorkInProgressChart < ChartBase
       'label' => "#{percentage}%",
       'barPercentage' => 1.0,
       'categoryPercentage' => 1.0,
+      'backgroundColor' => CssVariable['--aging-work-in-progress-chart-shading-color'],
       'data' => days_at_percentage_threshold_for_all_columns(percentage: percentage, issues: @issues).drop(1)
     }
   end

data/lib/jirametrics/aging_work_table.rb

@@ -7,11 +7,7 @@ class AgingWorkTable < ChartBase
 
   def initialize block
     super()
-    @blocked_icon = '🛑'
-    @expedited_icon = '🔥'
-    @stalled_icon = '🟧'
     @stalled_threshold = 5
-    @dead_icon = '⬛'
     @dead_threshold = 45
     @age_cutoff = 0
 
@@ -54,7 +50,7 @@ class AgingWorkTable < ChartBase
     return unless issue.expedited?
 
     name = issue.raw['fields']['priority']['name']
-    icon_span(title: "Expedited: Has a priority of &quot;#{name}&quot;", icon: @expedited_icon)
+    color_block '--expedited-color', title: "Expedited: Has a priority of &quot;#{name}&quot;"
   end
 
   def blocked_text issue
@@ -63,27 +59,24 @@ class AgingWorkTable < ChartBase
 
     current = issue.blocked_stalled_changes(end_time: time_range.end)[-1]
     if current.blocked?
-      icon_span title: current.reasons, icon: @blocked_icon
+      color_block '--blocked-color', title: current.reasons
     elsif current.stalled?
       if current.stalled_days && current.stalled_days > @dead_threshold
-        icon_span(
+        color_block(
+          '--dead-color',
           title: "Dead? Hasn&apos;t had any activity in #{label_days current.stalled_days}. " \
-            'Does anyone still care about this?',
-          icon: @dead_icon
+            'Does anyone still care about this?'
         )
       else
-        icon_span(
-          title: current.reasons,
-          icon: @stalled_icon
-        )
+        color_block '--stalled-color', title: current.reasons
       end
     end
   end
 
   def unmapped_status_text issue
     icon_span(
-      title: "The status #{issue.status.name.inspect} is not mapped to any column and will not be visible",
-      icon: ' ⁉️'
+      title: "Not visible: The status #{issue.status.name.inspect} is not mapped to any column and will not be visible",
+      icon: ' 👀'
     )
   end
 

data/lib/jirametrics/anonymizer.rb

@@ -12,6 +12,7 @@ class Anonymizer
     @all_boards = @project_config.all_boards
     @possible_statuses = @project_config.possible_statuses
     @date_adjustment = date_adjustment
+    @file_system = project_config.exporter.file_system
   end
 
   def run
@@ -20,7 +21,7 @@ class Anonymizer
     # anonymize_issue_statuses
     anonymize_board_names
     shift_all_dates unless @date_adjustment.zero?
-    puts 'Anonymize done'
+    @file_system.log 'Anonymize done'
   end
 
   def random_phrase
@@ -30,7 +31,7 @@ class Anonymizer
     5.times do |i|
       return RandomWord.phrases.next.tr('_', ' ')
     rescue # rubocop:disable Style/RescueStandardError We don't care what exception was thrown.
-      puts "Random word blew up on attempt #{i + 1}"
+      @file_system.log "Random word blew up on attempt #{i + 1}"
     end
   end
 
@@ -55,7 +56,7 @@ class Anonymizer
 
   def anonymize_column_names
     @all_boards.each_key do |board_id|
-      puts "Anonymizing column names for board #{board_id}"
+      @file_system.log "Anonymizing column names for board #{board_id}"
 
       column_name = 'Column-A'
       @all_boards[board_id].visible_columns.each do |column|
@@ -93,7 +94,7 @@ class Anonymizer
   end
 
   def anonymize_issue_statuses
-    puts 'Anonymizing issue statuses and status categories'
+    @file_system.log 'Anonymizing issue statuses and status categories'
     status_name_hash = build_status_name_hash
 
     @issues.each do |issue|
@@ -130,7 +131,7 @@ class Anonymizer
   end
 
   def shift_all_dates
-    puts "Shifting all dates by #{@date_adjustment} days"
+    @file_system.log "Shifting all dates by #{@date_adjustment} days"
     @issues.each do |issue|
       issue.changes.each do |change|
         change.time = change.time + @date_adjustment

data/lib/jirametrics/chart_base.rb

@@ -10,17 +10,11 @@ class ChartBase
 
   def initialize
     @chart_colors = {
-      'dark:Story' => 'green',
-      'dark:Task' => 'blue',
-      'dark:Bug' => 'orange',
-      'dark:Defect' => 'orange',
-      'dark:Spike' => '#9400D3', # dark purple
-      'light:Story' => '#90EE90',
-      'light:Task' => '#87CEFA',
-      'light:Bug' => '#ffdab9',
-      'light:Defect' => 'orange',
-      'light:Epic' => '#fafad2',
-      'light:Spike' => '#DDA0DD' # light purple
+      'Story'  => CssVariable['--type-story-color'],
+      'Task'   => CssVariable['--type-task-color'],
+      'Bug'    => CssVariable['--type-bug-color'],
+      'Defect' => CssVariable['--type-bug-color'],
+      'Spike'  => CssVariable['--type-spike-color']
     }
     @canvas_width = 800
     @canvas_height = 200
@@ -57,8 +51,8 @@ class ChartBase
     @@chart_counter += 1
   end
 
-  def color_for type:, shade: :dark
-    @chart_colors["#{shade}:#{type}"] ||= random_color
+  def color_for type:
+    @chart_colors[type] ||= random_color
   end
 
   def label_days days
@@ -199,15 +193,15 @@ class ChartBase
     color = status_category_color status
 
     text = is_category ? status.category_name : status.name
-    "<span style='color: #{color}'>#{text}</span>"
+    "<span title='Category: #{status.category_name}'>#{color_block color.name} #{text}</span>"
   end
 
   def status_category_color status
     case status.category_name
     when nil then 'black'
-    when 'To Do' then 'gray'
-    when 'In Progress' then 'blue'
-    when 'Done' then 'green'
+    when 'To Do' then CssVariable['--status-category-todo-color']
+    when 'In Progress' then CssVariable['--status-category-inprogress-color']
+    when 'Done' then CssVariable['--status-category-done-color']
     end
   end
 
@@ -236,4 +230,12 @@ class ChartBase
     @issues = issues.filter_map { |i| @filter_issues_block.call(i) }.uniq
     puts @issues.collect(&:key).join(', ')
   end
+
+  def color_block color, title: nil
+    result = +''
+    result << "<div class='color_block' style='background: var(#{color});'"
+    result << " title=#{title.inspect}" if title
+    result << '></div>'
+    result
+  end
 end

data/lib/jirametrics/css_variable.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+class CssVariable
+  attr_reader :name
+
+  def self.[](name)
+    if name.start_with? '--'
+      CssVariable.new name
+    else
+      name
+    end
+  end
+
+  def initialize name
+    @name = name
+  end
+
+  def to_json(*_args)
+    "getComputedStyle(document.body).getPropertyValue('#{@name}')"
+  end
+
+  def to_s
+    "var(#{@name})"
+  end
+
+  def inspect
+    "CssVariable['#{@name}']"
+  end
+
+  def == other
+    self.class == other.class && @name == other.name
+  end
+end

data/lib/jirametrics/cycletime_scatterplot.rb

@@ -16,16 +16,18 @@ class CycletimeScatterplot < ChartBase
         This chart shows only completed work and indicates both what day it completed as well as
         how many days it took to get done. Hovering over a dot will show you the ID of the work item.
       </p>
-      <p>
-        The gray line indicates the 85th percentile (<%= overall_percent_line %> days). 85% of all
+      <div style="padding-bottom: 0.7em">
+        The #{color_block '--cycletime-scatterplot-overall-trendline-color'} line indicates the 85th
+        percentile (<%= overall_percent_line %> days). 85% of all
         items on this chart fall on or below the line and the remaining 15% are above the line. 85%
         is a reasonable proxy for "most" so that we can say that based on this data set, we can
         predict that most work of this type will complete in <%= overall_percent_line %> days or
         less. The other lines reflect the 85% line for that respective type of work.
-      </p>
-      <p>
-        The gray vertical bars indicate weekends, when theoretically we aren't working.
-      </p>
+      </div>
+      <div>
+        The #{color_block '--non-working-days-color'} vertical bars indicate weekends, when theoretically
+        we aren't working.
+      </div>
     HTML
 
     init_configuration_block block do
@@ -44,7 +46,7 @@ class CycletimeScatterplot < ChartBase
 
     data_sets = create_datasets completed_issues
     overall_percent_line = calculate_percent_line(completed_issues)
-    @percentage_lines << [overall_percent_line, 'gray']
+    @percentage_lines << [overall_percent_line, CssVariable['--cycletime-scatterplot-overall-trendline-color']]
 
     return "<h1>#{@header_text}</h1>No data matched the selected criteria. Nothing to show." if data_sets.empty?
 

data/lib/jirametrics/daily_wip_by_age_chart.rb

@@ -17,7 +17,7 @@ class DailyWipByAgeChart < DailyWipChart
       <p>
         "Completed without being started" reflects the fact that while we know that it completed
         that day, we were unable to determine when it had started. These items will show up in
-        white at the top. Note that the white is approximate because we don't know exactly when
+        white at the top. Note that the this grouping is approximate because we don't know exactly when
         it started so we're guessing.
       </p>
     HTML
@@ -42,11 +42,11 @@ class DailyWipByAgeChart < DailyWipChart
   def not_started stopped:, rules:, created:
     if stopped == rules.current_date
       rules.label = 'Completed but not started'
-      rules.color = '#66FF66'
+      rules.color = '--wip-chart-completed-but-not-started-color'
       rules.group_priority = -1
     else
       rules.label = 'Start date unknown'
-      rules.color = 'white'
+      rules.color = '--body-background'
       rules.group_priority = 11
       created_days = rules.current_date - created + 1
       rules.issue_hint = "(created: #{label_days created_days.to_i} earlier, stopped on #{stopped})"
@@ -55,7 +55,7 @@ class DailyWipByAgeChart < DailyWipChart
 
   def stopped_today rules:
     rules.label = 'Completed'
-    rules.color = '#009900'
+    rules.color = '--wip-chart-completed-color'
     rules.group_priority = -2
   end
 
@@ -65,23 +65,23 @@ class DailyWipByAgeChart < DailyWipChart
     case age
     when 1
       rules.label = 'Less than a day'
-      rules.color = '#aaaaaa'
+      rules.color = '--wip-chart-duration-less-than-day-color'
       rules.group_priority = 10 # Highest is top
     when 2..7
       rules.label = 'A week or less'
-      rules.color = '#80bfff'
+      rules.color = '--wip-chart-duration-week-or-less-color'
       rules.group_priority = 9
     when 8..14
       rules.label = 'Two weeks or less'
-      rules.color = '#ffd700'
+      rules.color = '--wip-chart-duration-two-weeks-or-less-color'
       rules.group_priority = 8
     when 15..28
       rules.label = 'Four weeks or less'
-      rules.color = '#ce6300'
+      rules.color = '--wip-chart-duration-four-weeks-or-less-color'
       rules.group_priority = 7
     else
       rules.label = 'More than four weeks'
-      rules.color = '#990000'
+      rules.color = '--wip-chart-duration-more-than-four-weeks-color'
       rules.group_priority = 6
     end
   end

data/lib/jirametrics/daily_wip_by_blocked_stalled_chart.rb

@@ -9,18 +9,26 @@ class DailyWipByBlockedStalledChart < DailyWipChart
 
   def default_description_text
     <<-HTML
+      <div>
+        This chart highlights work that is #{color_block '--blocked-color'} blocked,
+        #{color_block '--stalled-color'} stalled, or
+        #{color_block '--wip-chart-active-color'} active on each given day.
+        <ul>
+          <li>#{color_block '--blocked-color'} Blocked could mean that the item has been flagged or it's
+            in a status that is configured as blocked, or it could have a link showing that it is blocked
+          by another item. It all depends how the report has been configured.</li>
+          <li>#{color_block '--stalled-color'} Stalled indicates that there has been no activity on this
+          item in five days.</li>
+        </ul>
+      </div>
       <p>
-        This chart highlights work that is blocked or stalled on each given day. In Jira terms, blocked
-        means that the issue has been "flagged". Stalled indicates that the item hasn't had any updates in 5 days.
-      </p>
-      <p>
-        Note that if an item tracks as both blocked and stalled, it will only show up in the flagged totals.
+        Note that if an item tracks as both blocked and stalled, it will only show up in the blocked totals.
         It will not be double counted.
       </p>
-      <p>
-        The white section reflects items that have stopped but for which we can't identify the start date. As
+      <div>
+        The #{color_block '--body-background'} shaded section reflects items that have stopped but for which we can't identify the start date. As
         a result, we are unable to properly show the WIP for these items.
-      </p>
+      </div>
     HTML
   end
 
@@ -48,29 +56,29 @@ class DailyWipByBlockedStalledChart < DailyWipChart
 
     if stopped_today && started.nil?
       rules.label = 'Completed but not started'
-      rules.color = '#66FF66'
+      rules.color = '--wip-chart-completed-but-not-started-color'
       rules.group_priority = -1
     elsif stopped_today
       rules.label = 'Completed'
-      rules.color = '#009900'
+      rules.color = '--wip-chart-completed-color'
       rules.group_priority = -2
     elsif started.nil?
       rules.label = 'Start date unknown'
-      rules.color = 'white'
+      rules.color = '--body-background'
       rules.group_priority = 4
     elsif change&.blocked?
       rules.label = 'Blocked'
-      rules.color = 'red'
+      rules.color = '--blocked-color'
       rules.group_priority = 1
       rules.issue_hint = "(#{change.reasons})"
     elsif change&.stalled?
       rules.label = 'Stalled'
-      rules.color = 'orange'
+      rules.color = '--stalled-color'
       rules.group_priority = 2
       rules.issue_hint = "(#{change.reasons})"
     else
       rules.label = 'Active'
-      rules.color = 'lightgray'
+      rules.color = '--wip-chart-active-color'
       rules.group_priority = 3
     end
   end

data/lib/jirametrics/daily_wip_chart.rb

@@ -102,8 +102,8 @@ class DailyWipChart < ChartBase
       label: grouping_rule.label,
       data: data,
       backgroundColor: grouping_rule.color || random_color,
-      borderColor: 'gray',
-      borderWidth: grouping_rule.color == 'white' ? 1 : 0,
+      borderColor: CssVariable['--wip-chart-border-color'],
+      borderWidth: grouping_rule.color.to_s == 'var(--body-background)' ? 1 : 0,
       borderRadius: positive ? 0 : 5
     }
   end

data/lib/jirametrics/dependency_chart.rb

@@ -84,7 +84,8 @@ class DependencyChart < ChartBase
     result << issue_link.other_issue.key.inspect
     result << '['
     result << 'label=' << (link_rules.label || issue_link.label).inspect
-    result << ',color=' << (link_rules.line_color || 'black').inspect
+    result << ',color=' << (link_rules.line_color || 'gray').inspect
+    result << ',fontcolor=' << (link_rules.line_color || 'gray').inspect
     result << ',dir=both' if link_rules.bidirectional_arrows?
     result << '];'
     result
@@ -101,12 +102,26 @@ class DependencyChart < ChartBase
     tooltip = "#{issue.key}: #{issue.summary}"
     result << ",tooltip=#{tooltip[0..80].inspect}"
     unless issue_rules.color == :none
-      result << %(,style=filled,fillcolor="#{issue_rules.color || color_for(type: issue.type, shade: :light)}")
+      result << %(,style=filled,fillcolor="#{issue_rules.color || color_for(type: issue.type)}")
     end
     result << ']'
     result
   end
 
+  # This used to pull colours from chart_base but the migration to CSS colours kept breaking
+  # this chart so we moved it here, until we're finished with the rest. TODO: Revisit whether
+  # this can also use customizable CSS colours
+  def color_for type:
+    @chart_colors = {
+      'Story' => '#90EE90',
+      'Task' => '#87CEFA',
+      'Bug' => '#ffdab9',
+      'Defect' => '#ffdab9',
+      'Epic' => '#fafad2',
+      'Spike' => '#DDA0DD' # light purple
+    }[type] ||= random_color
+  end
+
   def build_dot_graph
     issue_links = find_links
 
@@ -148,6 +163,7 @@ class DependencyChart < ChartBase
     dot_graph = []
     dot_graph << 'digraph mygraph {'
     dot_graph << 'rankdir=LR'
+    dot_graph << 'bgcolor="transparent"'
 
     # Sort the keys so they are proccessed in a deterministic order.
     visible_issues.values.sort_by(&:key_as_i).each do |issue|
@@ -177,18 +193,6 @@ class DependencyChart < ChartBase
     message
   end
 
-  def default_color_for_issue issue
-    {
-      'Story' => '#90EE90',
-      'Task' => '#87CEFA',
-      'Bug' => '#f08080',
-      'Defect' => '#f08080',
-      'Epic' => '#fafad2',
-      'Spike' => '#7fffd4',
-      'Sub-task' => '#dcdcdc'
-    }[issue.type]
-  end
-
   def shrink_svg svg
     scale = 0.8
     svg.sub(/width="([\d.]+)pt" height="([\d.]+)pt"/) do

data/lib/jirametrics/downloader.rb

@@ -10,7 +10,7 @@ class Downloader
   attr_reader :file_system
 
   # For testing only
-  attr_reader :start_date_in_query
+  attr_reader :start_date_in_query, :board_id_to_filter_id
 
   def initialize download_config:, file_system:, jira_gateway:
     @metadata = {}
@@ -55,7 +55,7 @@ class Downloader
 
   def log text, both: false
     @file_system.log text
-    puts text if both
+    puts text if both && !@quiet_mode
   end
 
   def find_board_ids
@@ -93,7 +93,7 @@ class Downloader
     intercept_jql = @download_config.project_config.settings['intercept_jql']
     jql = intercept_jql.call jql if intercept_jql
 
-    log "  #{jql}"
+    log "  JQL: #{jql}"
     escaped_jql = CGI.escape jql
 
     max_results = 100
@@ -157,10 +157,10 @@ class Downloader
 
   def download_statuses
     log '  Downloading all statuses', both: true
-    json = @jira_gateway.call_url relative_url: "/rest/api/2/status"
+    json = @jira_gateway.call_url relative_url: '/rest/api/2/status'
 
     @file_system.save_json(
-      json: json, 
+      json: json,
       filename: "#{@target_path}#{@download_config.project_config.file_prefix}_statuses.json"
     )
   end
@@ -282,9 +282,8 @@ class Downloader
 
       # Pick up any issues that had a status change in the range
       start_date_text = @start_date_in_query.strftime '%Y-%m-%d'
-      end_date_text = today.strftime '%Y-%m-%d'
       # find_in_range = %((status changed DURING ("#{start_date_text} 00:00","#{end_date_text} 23:59")))
-      find_in_range = %((updated >= "#{start_date_text} 00:00" AND updated <= "#{end_date_text} 23:59"))
+      find_in_range = %(updated >= "#{start_date_text} 00:00")
 
       segments << "(#{find_in_range} OR #{catch_all})"
     end

data/lib/jirametrics/examples/aggregated_project.rb

@@ -10,9 +10,11 @@
 # single team. For that reason, we look at slightly different things that we would on a single team board.
 
 class Exporter
-  def aggregated_project name:, project_names:
+  def aggregated_project name:, project_names:, settings: {}
     project name: name do
       puts name
+      self.settings.merge! settings
+
       aggregate do
         project_names.each do |project_name|
           include_issues_from project_name

data/lib/jirametrics/examples/standard_project.rb

@@ -6,13 +6,19 @@
 # See https://github.com/mikebowler/jirametrics/wiki/Examples-folder for more
 class Exporter
   def standard_project name:, file_prefix:, ignore_issues: nil, starting_status: nil, boards: {},
-      default_board: nil, anonymize: false
+      default_board: nil, anonymize: false, settings: {}, status_category_mappings: {}
 
     project name: name do
       puts name
       self.anonymize if anonymize
 
       settings['blocked_link_text'] = ['is blocked by']
+      self.settings.merge! settings
+
+      status_category_mappings.each do |status, category|
+        status_category_mapping status: status, category: category
+      end
+
       file_prefix file_prefix
       download do
         rolling_date_count 90
@@ -50,7 +56,7 @@ class Exporter
                  type: :header
           end
 
-          discard_changes_before status_becomes: (starting_status || :backlog)
+          discard_changes_before status_becomes: (starting_status || :backlog) # rubocop:disable Style/RedundantParentheses
 
           cycletime_scatterplot do
             show_trend_lines
@@ -89,7 +95,7 @@ class Exporter
             TEXT
             grouping_rules do |issue, rules|
               rules.label = issue.parent&.key || 'No parent'
-              rules.color = 'white' if rules.label == 'No parent'
+              rules.color = '--body-background' if rules.label == 'No parent'
             end
           end
           expedited_chart
@@ -107,7 +113,7 @@ class Exporter
               when 'Sync'
                 rules.use_bidirectional_arrows
               else
-                # This is a link type that we don't recognized. Dump it to standard out to draw attention
+                # This is a link type that we don't recognize. Dump it to standard out to draw attention
                 # to it.
                 puts "name=#{link.name}, label=#{link.label}"
               end