NetBSD/external/bsd/atf/dist
kre c2105d446d Replace a pipe into tr to normalise a var name (convert '.' or '-'
into '_' to meet sh variable name rules) into a shell string processing
loop.

On my test system, this reduces the total elapsed time for the bin/sh ATF
tests from about 109 secs to about 102 (user cpu from 24.5 to 21, sys cpu
from 34 to 30) and the usr.bin/make tests elapsed time from 42.5 to 40
secs (user from a bit over 15 to a bit over 13, and sys from 16+ to 13+).
(Recorded on an AMD64 domU).

These probably exaggerate the effect, as there are a bunch of quite small
tests, which means the ATF overhead (which this change affects) is a greater
proportion of the total test time than for some other tests where most of
the time is spent actually testing.

But I am fairly confident that there will be at least some improvement.

This could be further improved by removing the cmdsub invocation method,
and instead passing the name of a variable containing the string to
normalise (with the result returned in that same var) - but that would
mean altering all the callers as well.   Some other time maybe.
2020-09-10 22:51:10 +00:00
..
atf-c Consistent use of comma in lists. 2020-07-03 19:22:38 +00:00
atf-c++ remove -std=gnu++98 2020-03-09 20:34:52 +00:00
atf-sh Replace a pipe into tr to normalise a var name (convert '.' or '-' 2020-09-10 22:51:10 +00:00
doc
test-programs
tools Add the system binary paths too since tests use them. 2020-04-23 16:05:15 +00:00
AUTHORS
COPYING
Kyuafile
NEWS
README
atf-c++.hpp
atf-c.h

README

Introductory information                        Automated Testing Framework
===========================================================================


Introduction
************

The Automated Testing Framework (ATF) is a collection of libraries to
implement test programs in a variety of languages.  At the moment, ATF
offers C, C++ and POSIX shell bindings with which to implement tests.
These bindings all offer a similar set of functionality and any test
program written with them exposes a consistent user interface.

ATF-based test programs rely on a separate runtime engine to execute them.
The runtime engine is in charge of isolating the test programs from the
rest of the system to ensure that their results are deterministic and that
they cannot affect the running system.  The runtime engine is also
responsible for gathering the results of all tests and composing reports.
The current runtime of choice is Kyua.


Other documents
***************

* AUTHORS: List of authors and contributors for this project.

* COPYING: License information.

* INSTALL: Compilation and installation instructions.  These is not the
  standard document shipped with many packages, so be sure to read it for
  things that are specific to ATF's build.

* NEWS: List of major changes between formal, published releases.


===========================================================================
vim: filetype=text:textwidth=75:expandtab:shiftwidth=2:softtabstop=2