NetBSD/external/bsd/kyua-atf-compat/dist/atf-report.sh

192 lines
5.9 KiB
Bash

#! __SH__
# Copyright 2012 Google Inc.
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are
# met:
#
# * Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# * Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
# * Neither the name of Google Inc. nor the names of its contributors
# may be used to endorse or promote products derived from this software
# without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
# \file atf-report.sh
# Kyua-based compatibility replacement for atf-report.
. "${KYUA_ATF_COMPAT_PKGDATADIR:-__PKGDATADIR__}/lib.subr"
# Gets the action identifier from the output of 'kyua test'.
#
# \param file The file that contains the output of 'kyua test'. Can be
# /dev/stdout.
#
# \post Prints the action identifier.
get_action() {
local file="${1}"; shift
grep '^Committed action ' "${file}" | cut -d ' ' -f 3
}
# Generates an HTML report.
#
# The original atf-report generates HTML reports that are made up of solely a
# single HTML page. Because of this, such reports can be written directly to
# the file specified by the user.
#
# Because Kyua generates "rich" HTML reports (i.e. reports that consist of more
# than one HTML page), we cannot perfectly emulate atf-report. Instead, we
# create an auxiliary directory to hold all the files, and then place a link to
# such files in the file specified by the user. The drawback is that HTML
# reports sent to stdout are no longer possible.
#
# \param output_file The name of the file to which to write the HTML report.
# This file will end up being a symlink to the real report.
report_html() {
local output_file="${1}"; shift
[ "${output_file}" != "/dev/stdout" ] || \
lib_usage_error "Cannot write HTML reports to stdout"
local dir="$(dirname "${output_file}")"
local index_name="${output_file##*/}"
local files_name="$(echo "${index_name}" | sed -e 's,\.[a-zA-Z]*$,,').files"
kyua report-html --action="$(get_action /dev/stdin)" \
--output="${dir}/${files_name}"
echo "Pointing ${index_name} to ${files_name}/index.html"
( cd "${dir}" && ln -s "${files_name}/index.html" "${index_name}" )
}
# Genereates an XML report.
#
# For our compatibility purposes, we assume that the XML report is just an HTML
# report.
#
# \param output_file The name of the file to which to write the HTML report.
# This file will end up being a symlink to the real report.
report_xml() {
local output_file="${1}"; shift
lib_warning "XML output not supported; generating HTML instead"
report_html "${output_file}"
}
# Generates progressive textual reports.
#
# This wrapper attempts to emulate atf-report's ticker output by reading the
# output of 'kyua test' progressively and sending it to the screen as soon as it
# becomes available. The tail of the 'kyua test' report that includes summaries
# for the run is suppressed and is replaced with the more-detailed output of
# 'kyua report'.
#
# \param output_file The name of the file to which to write the textual report.
# Can be /dev/stdout.
report_ticker() {
local output_file="${1}"; shift
local print=yes
while read line; do
[ -n "${line}" ] || print=no
if [ "${print}" = yes ]; then
case "${line}" in
Committed*)
echo "${line}" >>"${Lib_TempDir}/output"
;;
*)
echo "${line}"
;;
esac
else
echo "${line}" >>"${Lib_TempDir}/output"
fi
done
kyua report --action="$(get_action "${Lib_TempDir}/output")" \
--output="${output_file}"
}
# Generates a report based on an output specification.
#
# \param output_spec The format:file specification of the output.
report() {
local output_spec="${1}"; shift
local output_format="$(echo "${output_spec}" | cut -d : -f 1)"
local output_file="$(echo "${output_spec}" | cut -d : -f 2)"
[ "${output_file}" != - ] || output_file=/dev/stdout
case "${output_format}" in
html|ticker|xml)
"report_${output_format}" "${output_file}"
;;
*)
lib_usage_error "Unknown output format '${output_format}'"
;;
esac
}
# Prints program usage to stdout.
#
# \param progname The name of the program to use for the syntax help.
usage() {
local progname="${1}"; shift
echo "Usage: ${progname} [-o output-spec]"
}
# Entry point for the program.
#
# \param ... The user-provided arguments.
main()
{
local output_spec="ticker:-"
while getopts ':o:' arg "${@}"; do
case "${arg}" in
o)
output_spec="${OPTARG}"
;;
\?)
lib_usage_error "Unknown option -${OPTARG}"
;;
esac
done
shift $((${OPTIND} - 1))
[ ${#} -eq 0 ] || lib_usage_error "No arguments allowed"
lib_init_tempdir
report "${output_spec}"
lib_cleanup
}
main "${@}"