Module: Autobuild::Reporting

Defined in:
lib/autobuild/reporting.rb

Overview

The reporting module provides the framework # to run commands in autobuild and report errors # to the user

It does not use a logging framework like Log4r, but it should ;-)

Class Method Summary collapse

Class Method Details

.<<(reporter) ⇒ Object

Add a new reporter



197
198
199
 
# File 'lib/autobuild/reporting.rb', line 197

def self.<<(reporter)
    @reporters << reporter
end

.clear_reporters ⇒ Object 



205
206
207
 
# File 'lib/autobuild/reporting.rb', line 205

def self.clear_reporters
    @reporters.clear
end

.default_report_on_package_failures ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Helper that returns the default for on_package_failures

The result depends on the value for Autobuild.debug. It is either :exit if debug is false, or :raise if it is true



132
133
134
135
136
137
 
# File 'lib/autobuild/reporting.rb', line 132

def self.default_report_on_package_failures
    if Autobuild.debug then :raise
    else
        :exit
    end
end

.each_log(&block) ⇒ Object

Iterate on all log files



214
215
216
 
# File 'lib/autobuild/reporting.rb', line 214

def self.each_log(&block)
    Autobuild.logfiles.each(&block)
end

.each_reporter(&iter) ⇒ Object 



209
210
211
 
# File 'lib/autobuild/reporting.rb', line 209

def self.each_reporter(&iter)
    @reporters.each(&iter)
end

.error(error) ⇒ Object

Reports that the build failed to the user



192
193
194
 
# File 'lib/autobuild/reporting.rb', line 192

def self.error(error)
    each_reporter { |rep| rep.error(error) }
end

.remove(reporter) ⇒ Object 



201
202
203
 
# File 'lib/autobuild/reporting.rb', line 201

def self.remove(reporter)
    @reporters.delete(reporter)
end

.report(on_package_failures: default_report_on_package_failures) ⇒ Object

Run a block and report known exception If an exception is fatal, the program is terminated using exit()



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
 
# File 'lib/autobuild/reporting.rb', line 103

def self.report(on_package_failures: default_report_on_package_failures)
    begin yield
    rescue Interrupt => e
        interrupted = e
    rescue Autobuild::Exception => e
        return report_finish_on_error([e],
                                      on_package_failures: on_package_failures,
                                      interrupted_by: interrupted)
    end

    # If ignore_erorrs is true, check if some packages have failed
    # on the way. If so, raise an exception to inform the user about
    # it
    errors = []
    Autobuild::Package.each do |_name, pkg|
        errors.concat(pkg.failures)
    end

    report_finish_on_error(errors,
                           on_package_failures: on_package_failures,
                           interrupted_by: interrupted)
end

.report_finish_on_error(errors, on_package_failures: default_report_on_package_failures, interrupted_by: nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Handle how Reporting.report is meant to finish in case of error(s)

Parameters:

  • on_package_failures (Symbol) (defaults to: default_report_on_package_failures) —

    how does the reporting should behave.



145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
 
# File 'lib/autobuild/reporting.rb', line 145

def self.report_finish_on_error(errors,
    on_package_failures: default_report_on_package_failures, interrupted_by: nil)
    if (not_package_error = errors.find { |e| !e.respond_to?(:fatal?) })
        raise not_package_error
    end

    unless %i[raise report_silent exit_silent].include?(on_package_failures)
        errors.each { |e| error(e) }
    end

    fatal = errors.any?(&:fatal?)
    unless fatal
        if interrupted_by
            raise interrupted_by
        else
            return errors
        end
    end

    if on_package_failures == :raise
        raise interrupted_by if interrupted_by

        e = if errors.size == 1 then errors.first
            else
                CompositeException.new(errors)
            end
        raise e
    elsif %i[report_silent report].include?(on_package_failures)
        if interrupted_by
            raise interrupted_by
        else
            errors
        end
    elsif %i[exit exit_silent].include?(on_package_failures)
        exit 1
    else
        raise ArgumentError, "unexpected value for on_package_failures: "\
            "#{on_package_failures}"
    end
end

.success ⇒ Object

Reports a successful build to the user



187
188
189
 
# File 'lib/autobuild/reporting.rb', line 187

def self.success
    each_reporter(&:success)
end