On Sun, 2024-11-24 at 13:24 +0100, Ulrich Müller wrote:
> # Copyright 2024 Gentoo Authors
> # Distributed under the terms of the GNU General Public License v2
> 
> # @ECLASS: eapi9-pipestatus.eclass
> # @MAINTAINER:
> # Ulrich Müller <ulm@gentoo.org>
> # @AUTHOR:
> # Ulrich Müller <ulm@gentoo.org>
> # @SUPPORTED_EAPIS: 7 8
> # @BLURB: test the PIPESTATUS array
> # @DESCRIPTION:
> # A stand-alone implementation of a possible future pipestatus command
> # (which would be aimed for EAPI 9).  It is meant as a replacement for
> # "assert".  In its simplest form it can be called like this:
> #
> # @CODE
> # foo | bar
> # pipestatus || die
> # @CODE
> #
> # With the -v option, the command will also echo the pipe status array,
> # so it can be assigned to a variable like in the following example:
> #
> # @CODE
> # local status
> # foo | bar
> # status=$(pipestatus -v) || die "foo | bar failed, status ${status}"

I suppose you may want to put a verbose warning not to put "local"
on the same line, because people are going to do that as an "obvious"
optimization.

> # @CODE
> 
> case ${EAPI} in
> 	7|8) ;;
> 	*) die "${ECLASS}: EAPI ${EAPI:-0} not supported" ;;
> esac
> 
> # @FUNCTION: pipestatus
> # @USAGE: [-v]
> # @RETURN: last non-zero element of PIPESTATUS, or zero if all are zero
> # @DESCRIPTION:
> # Test the PIPESTATUS array, i.e. the exit status of the command(s)
> # in the most recently executed foreground pipeline.  If called with
> # option -v, also output the PIPESTATUS array.
> pipestatus() {
> 	local -a status=( "${PIPESTATUS[@]}" )
> 	local s ret=0
> 
> 	[[ $# -gt 0 && ${1} != -v || $# -gt 1 ]] \

Please use parentheses when you combine && and ||, if only for the sake
of readability.

> 		&& die "${FUNCNAME}: bad arguments: $@"

Replace the '\' with the '&&'.

> 
> 	[[ ${1} == -v ]] && echo "${status[@]}"
> 
> 	for s in "${status[@]}"; do
> 		[[ ${s} -ne 0 ]] && ret=${s}

I suppose it's just my C-foo talking and completely needless
optimization here, but it really itches me to iterate the array
backwards and return on the first match.

> 	done
> 
> 	return "${ret}"
> }

-- 
Best regards,
Michał Górny