[LTP] [RFC PATCH v3 1/2] tst_test.sh: Add TST_TEST_DATA and TST_TEST_DATA_IFS

[Cyril Hrubis <chrubis@suse.cz>]

Hi!
> > Actually this is a good idea, we can follow the python underscore
> > notation that uses it for private variables and functions. Hence the
> > counters will become _tst_i, etc.
> 
> > But please do that in a separate patch.
> I meant to add underscore before new functions i.e. _tst_run_tests() and _tst_run_test().
> Variables: do you mean to change local variables in tst_run()?
> That would be really for separate patch.

As I written, change everything private that leaks to the test context
with _tst_ so that it's clear what the test is supposed to set/call.

> > > ---
> > >  doc/test-writing-guidelines.txt | 74 +++++++++++++++++++++++++++++++++++++----
> > >  testcases/lib/tst_test.sh       | 61 +++++++++++++++++++++------------
> > >  2 files changed, 106 insertions(+), 29 deletions(-)
> 
> ...
> > > +TST_TESTFUNC=do_test
> > > +TST_CNT=2
> > > +TST_TEST_DATA="foo:bar:d dd"
> > > +. tst_test.sh
> > > +
> > > +do_test()
> > > +{
> > > +	case $1 in
> > > +	1) tst_res TPASS "Test $1 passed with data '$2'";;
> > > +	2) tst_res TPASS "Test $1 passed with data '$2'";;
> > > +	esac
> > > +}
> > > +
> > > +tst_run
> > > +# output:
> > > +# test 1 TPASS: Test 1 passed with data 'foo:bar:d'
> > > +# test 2 TPASS: Test 2 passed with data 'foo:bar:d'
> > > +
> > > +-------------------------------------------------------------------------------
> > > +When '$TST_TEST_DATA' is used with '$TST_CNT', it's passed as whole string in
> > > +'$2' ($1 is for the test number), '$TST_TEST_DATA_IFS' is ignored. Similar
> > > +would be when using these variables with separate functions.
> 
> > Now that we support both TST_CNT and TST_TEST_DATA_IFS can we change
> > this example to include the TST_TEST_DATA_IFS=":" as well?
> I wanted to demonstrate that TST_TEST_DATA_IFS has a default value ' ').
> But ok, I'll change it to define TST_TEST_DATA_IFS as well.

No problem with that, but then we should get rid of the : from the
example data and keep it only at "foo bar".

> > Can we please prefix the res here with tst_ as well since we are
> > touching the code?
> Sure. To be honest I wasn't sure whether there is some reason for $res being named without
> prefix or not.

I guess that it haven't been caught in the review process when I first
wrote the library...

-- 
Cyril Hrubis
chrubis@suse.cz