diff mbox series

[03/13] fstests: refactor test boilerplate code

Message ID 162370435585.3800603.509157515145342966.stgit@locust (mailing list archive)
State New, archived
Headers show
Series fstests: move test group lists into test files | expand

Commit Message

Darrick J. Wong June 14, 2021, 8:59 p.m. UTC
From: Darrick J. Wong <djwong@kernel.org>

Create two new helper functions to deal with boilerplate test code:

A helper function to set the seq and seqnum variables.  We will expand
on this in the next patch so that fstests can autogenerate group files
from now on.

A helper function to register cleanup code that will run if the test
exits or trips over a standard range of signals.

Signed-off-by: Darrick J. Wong <djwong@kernel.org>
Reviewed-by: Chandan Babu R <chandanrlinux@gmail.com>
Reviewed-by: Allison Henderson <allison.henderson@oracle.com>
---
 common/preamble |   49 +++++++++++++++++++++++++++++++++++++++++++++++++
 new             |   33 ++++++++++++---------------------
 2 files changed, 61 insertions(+), 21 deletions(-)
 create mode 100644 common/preamble

Comments

Christoph Hellwig June 16, 2021, 5:42 a.m. UTC | #1
On Mon, Jun 14, 2021 at 01:59:15PM -0700, Darrick J. Wong wrote:
> From: Darrick J. Wong <djwong@kernel.org>
> 
> Create two new helper functions to deal with boilerplate test code:
> 
> A helper function to set the seq and seqnum variables.  We will expand
> on this in the next patch so that fstests can autogenerate group files
> from now on.
> 
> A helper function to register cleanup code that will run if the test
> exits or trips over a standard range of signals.
> 
> Signed-off-by: Darrick J. Wong <djwong@kernel.org>
> Reviewed-by: Chandan Babu R <chandanrlinux@gmail.com>
> Reviewed-by: Allison Henderson <allison.henderson@oracle.com>

Nice!

Reviewed-by: Christoph Hellwig <hch@lst.de>
Eric Biggers June 16, 2021, 8:47 p.m. UTC | #2
On Mon, Jun 14, 2021 at 01:59:15PM -0700, Darrick J. Wong wrote:
> From: Darrick J. Wong <djwong@kernel.org>
> 
> Create two new helper functions to deal with boilerplate test code:
> 
> A helper function to set the seq and seqnum variables.  We will expand
> on this in the next patch so that fstests can autogenerate group files
> from now on.
> 
> A helper function to register cleanup code that will run if the test
> exits or trips over a standard range of signals.
> 
> Signed-off-by: Darrick J. Wong <djwong@kernel.org>
> Reviewed-by: Chandan Babu R <chandanrlinux@gmail.com>
> Reviewed-by: Allison Henderson <allison.henderson@oracle.com>

Looks good:

Reviewed-by: Eric Biggers <ebiggers@google.com>

A couple nits below:

> +# Standard cleanup function.  Individual tests should override this.
> +_cleanup()
> +{
> +	cd /
> +	rm -r -f $tmp.*
> +}

It should say "can override this", not "should override this".

> +# Initialize the global seq, seqres, here, tmp, and status variables to their
> +# defaults.  Group memberships are the only arguments to this helper.
> +_begin_fstest()
> +{

This function does more than what the comment says.  It should say something
more along the lines of "Prepare for executing a fstest by initializing some
global variables, registering a default cleanup function, importing helper
functions, and removing $seqres.full.  This must be passed the list of groups to
which the test belongs."

- Eric
Darrick J. Wong June 17, 2021, 12:02 a.m. UTC | #3
On Wed, Jun 16, 2021 at 01:47:32PM -0700, Eric Biggers wrote:
> On Mon, Jun 14, 2021 at 01:59:15PM -0700, Darrick J. Wong wrote:
> > From: Darrick J. Wong <djwong@kernel.org>
> > 
> > Create two new helper functions to deal with boilerplate test code:
> > 
> > A helper function to set the seq and seqnum variables.  We will expand
> > on this in the next patch so that fstests can autogenerate group files
> > from now on.
> > 
> > A helper function to register cleanup code that will run if the test
> > exits or trips over a standard range of signals.
> > 
> > Signed-off-by: Darrick J. Wong <djwong@kernel.org>
> > Reviewed-by: Chandan Babu R <chandanrlinux@gmail.com>
> > Reviewed-by: Allison Henderson <allison.henderson@oracle.com>
> 
> Looks good:
> 
> Reviewed-by: Eric Biggers <ebiggers@google.com>
> 
> A couple nits below:
> 
> > +# Standard cleanup function.  Individual tests should override this.
> > +_cleanup()
> > +{
> > +	cd /
> > +	rm -r -f $tmp.*
> > +}
> 
> It should say "can override this", not "should override this".

Fixed.

> > +# Initialize the global seq, seqres, here, tmp, and status variables to their
> > +# defaults.  Group memberships are the only arguments to this helper.
> > +_begin_fstest()
> > +{
> 
> This function does more than what the comment says.  It should say something
> more along the lines of "Prepare for executing a fstest by initializing some
> global variables, registering a default cleanup function, importing helper
> functions, and removing $seqres.full.  This must be passed the list of groups to
> which the test belongs."

Ok, I'll change that.

# Prepare to run a fstest by initializing the global seq, seqres, here,
# tmp, and status variables to their defaults, importing common
# functions, registering a cleanup function, and removing the
# $seqres.full file.
#
# The list of group memberships for this test (e.g. auto quick rw) must
# be passed as arguments to this helper.  It is not necessary to name
# this test explicitly as a member of the 'all' group.

--D

> 
> - Eric
diff mbox series

Patch

diff --git a/common/preamble b/common/preamble
new file mode 100644
index 00000000..eafce487
--- /dev/null
+++ b/common/preamble
@@ -0,0 +1,49 @@ 
+#!/bin/bash
+# SPDX-License-Identifier: GPL-2.0
+# Copyright (c) 2021 Oracle.  All Rights Reserved.
+
+# Boilerplate fstests functionality
+
+# Standard cleanup function.  Individual tests should override this.
+_cleanup()
+{
+	cd /
+	rm -r -f $tmp.*
+}
+
+# Install the supplied cleanup code as a signal handler for HUP, INT, QUIT,
+# TERM, or when the test exits.  Extra signals can be specified as subsequent
+# parameters.
+_register_cleanup()
+{
+	local cleanup="$1"
+	shift
+
+	test -n "$cleanup" && cleanup="${cleanup}; "
+	trap "${cleanup}exit \$status" EXIT HUP INT QUIT TERM $*
+}
+# Initialize the global seq, seqres, here, tmp, and status variables to their
+# defaults.  Group memberships are the only arguments to this helper.
+_begin_fstest()
+{
+	if [ -n "$seq" ]; then
+		echo "_begin_fstest can only be called once!"
+		exit 1
+	fi
+
+	seq=`basename $0`
+	seqres=$RESULT_DIR/$seq
+	echo "QA output created by $seq"
+
+	here=`pwd`
+	tmp=/tmp/$$
+	status=1	# failure is the default!
+
+	_register_cleanup _cleanup
+
+	. ./common/rc
+
+	# remove previous $seqres.full before test
+	rm -f $seqres.full
+
+}
diff --git a/new b/new
index 357983d9..531fd123 100755
--- a/new
+++ b/new
@@ -153,27 +153,18 @@  cat <<End-of-File >$tdir/$id
 #
 # what am I here for?
 #
-seq=\`basename \$0\`
-seqres=\$RESULT_DIR/\$seq
-echo "QA output created by \$seq"
-
-here=\`pwd\`
-tmp=/tmp/\$\$
-status=1	# failure is the default!
-trap "_cleanup; exit \\\$status" 0 1 2 3 15
-
-_cleanup()
-{
-	cd /
-	rm -f \$tmp.*
-}
-
-# get standard environment, filters and checks
-. ./common/rc
-. ./common/filter
-
-# remove previous \$seqres.full before test
-rm -f \$seqres.full
+. ./common/preamble
+_begin_fstest group list here
+
+# Override the default cleanup function.
+# _cleanup()
+# {
+# 	cd /
+# 	rm -r -f \$tmp.*
+# }
+
+# Import common functions.
+# . ./common/filter
 
 # real QA test starts here