Class: PartyFoul::IssueRenderers::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/party_foul/issue_renderers/base.rb

Direct Known Subclasses

Rack, Rackless

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(exception, env) ⇒ Base

A new renderer instance for GitHub issues

Parameters:

  • (Exception, Hash) 


10
11
12
13
 
# File 'lib/party_foul/issue_renderers/base.rb', line 10

def initialize(exception, env)
  self.exception = exception
  self.env       = env
end

Instance Attribute Details

#body ⇒ String (readonly)

Renders the issue body

Customize by overriding #body_options

Returns:

  • (String) 


31
32
33
 
# File 'lib/party_foul/issue_renderers/base.rb', line 31

def body
  @body
end

#env ⇒ Object

Returns the value of attribute env.



4
5
6
 
# File 'lib/party_foul/issue_renderers/base.rb', line 4

def env
  @env
end

#exception ⇒ Object

Returns the value of attribute exception.



4
5
6
 
# File 'lib/party_foul/issue_renderers/base.rb', line 4

def exception
  @exception
end

#sha ⇒ Object

Returns the value of attribute sha.



4
5
6
 
# File 'lib/party_foul/issue_renderers/base.rb', line 4

def sha
  @sha
end

Instance Method Details

#body_options(count = 0) ⇒ Hash

The hash used for building the table in issue body

Returns:

  • (Hash) 


105
106
107
 
# File 'lib/party_foul/issue_renderers/base.rb', line 105

def body_options(count = 0)
  { Exception: exception, 'Last Occurrence' => occurred_at, Count: count + 1 }
end

#build_table_from_hash(hash) ⇒ String

Builds an HTML table from hash

Returns:

  • (String) 


119
120
121
 
# File 'lib/party_foul/issue_renderers/base.rb', line 119

def build_table_from_hash(hash)
  "<table>#{rows_for_table_from_hash(hash)}</table>"
end

#comment ⇒ Object

Renderes the issue comment

Customize by overriding #comment_options



45
46
47
 
# File 'lib/party_foul/issue_renderers/base.rb', line 45

def comment
  build_table_from_hash(comment_options)
end

#comment_options ⇒ Hash

The hash used for building the table in the comment body

Returns:

  • (Hash) 


112
113
114
 
# File 'lib/party_foul/issue_renderers/base.rb', line 112

def comment_options
  { 'Occurred At' => occurred_at }
end

#fingerprint ⇒ String

A SHA1 hex digested representation of the title. The fingerprint is used to create a unique value in the issue body. This value is used for seraching when matching issues happen again in the future.

Returns:

  • (String) 


75
76
77
 
# File 'lib/party_foul/issue_renderers/base.rb', line 75

def fingerprint
  Digest::SHA1.hexdigest(title)
end

#labels ⇒ Array

Provides additional labels using the configured options

Returns:

  • (Array) 


143
144
145
146
147
148
149
 
# File 'lib/party_foul/issue_renderers/base.rb', line 143

def labels
  if PartyFoul.additional_labels.respond_to? :call
    PartyFoul.additional_labels.call(self.exception, self.env) || []
  else
    PartyFoul.additional_labels || []
  end
end

#occurred_at ⇒ String

The timestamp when the exception occurred.

Returns:

  • (String) 


98
99
100
 
# File 'lib/party_foul/issue_renderers/base.rb', line 98

def occurred_at
  @occurred_at ||= Time.now.strftime('%B %d, %Y %H:%M:%S %z')
end

#rows_for_table_from_hash(hash) ⇒ String

Builds the rows of an HTML table from hash. Keys as Headers cells and Values as Data cells If the Value is a Hash it will be rendered as a table

Returns:

  • (String) 


128
129
130
131
132
133
134
135
136
137
138
 
# File 'lib/party_foul/issue_renderers/base.rb', line 128

def rows_for_table_from_hash(hash)
  hash.inject('') do |rows, row|
    key, value = row
    if row[1].kind_of?(Hash)
      value = build_table_from_hash(row[1])
    else
      value = CGI.escapeHTML(value.to_s)
    end
    rows << "<tr><th>#{key}</th><td>#{value}</td></tr>"
  end
end

#stack_trace ⇒ String

Compiles the stack trace for use in the issue body. Lines in the stack trace that are part of the application will be rendered as links to the relative file and line on GitHub based upon PartyFoul.web_url, PartyFoul.owner, PartyFoul.repo, and PartyFoul.branch. The branch will be used at the time the exception happens to grab the SHA for that branch at that time for the purpose of linking.

Returns:

  • (String) 


58
59
60
61
62
63
64
65
66
67
68
 
# File 'lib/party_foul/issue_renderers/base.rb', line 58

def stack_trace
  exception.backtrace.map do |line|
    if from_bundler?(line)
      format_line(line)
    elsif (matches = extract_file_name_and_line_number(line))
      "<a href='#{PartyFoul.repo_url}/blob/#{sha}/#{matches[2]}#L#{matches[3]}'>#{format_line(line)}</a>"
    else
      format_line(line)
    end
  end.join("\n")
end

#title ⇒ String

Title of the issue with any object ids masked

Returns:

  • (String) 


18
19
20
21
22
23
24
 
# File 'lib/party_foul/issue_renderers/base.rb', line 18

def title
  if PartyFoul.title_prefix
    "[#{PartyFoul.title_prefix}] #{masked_title}"
  else
    masked_title
  end
end

#update_body(old_body) ⇒ String

Will update the issue body. The count and the time stamp will both be updated. If the format of the issue body fails to match for whatever reason the issue body will be reset.

Returns:

  • (String) 


84
85
86
87
88
89
90
91
92
93
 
# File 'lib/party_foul/issue_renderers/base.rb', line 84

def update_body(old_body)
  begin
    current_count = old_body.match(/<th>Count<\/th><td>(\d+)<\/td>/)[1].to_i
    old_body.sub!("<th>Count</th><td>#{current_count}</td>", "<th>Count</th><td>#{current_count + 1}</td>")
    old_body.sub!(/<th>Last Occurrence<\/th><td>.+?<\/td>/, "<th>Last Occurrence</th><td>#{occurred_at}</td>")
    old_body
  rescue
    self.body
  end
end