README

README.md

autofonce

autofonce is a modern runner for GNU Autoconf Testsuites: autofonce has a limited understanding of m4 macros that appear in testsuites written for the GNU Autoconf testsuites, and can run such tests in a modern way.

• Website: https://ocamlpro.github.io/autofonce

• General Documentation: https://ocamlpro.github.io/autofonce/sphinx

• API Documentation: https://ocamlpro.github.io/autofonce/doc

• Sources: https://github.com/ocamlpro/autofonce

Main Features

• automatic run from any directory in the project

• short display focusing on failed tests

• automatic parallel execution

• promotion of tests results to fix tests

Example of Autofonce Test

Here is a simple example of test understood byautofonce:

# Start of a test, and the name that will be displayedAT_SETUP([Example test])# can be used to select tests to run:AT_KEYWORDS([example test autofonce]) # create a file `file` with its contentAT_DATA([file], [content of fileon multiple lines])# call some command, check its exit code, stdout, stderrAT_CHECK([cat file], [0], [stdout of my command], [stderr of my command])# you can do more, ignore some results, run more tests in case of failure, etc.# end of the testAT_CLEANUP

Now, copy this test in a filetest.at, and runautofonce:

$ autofonce init$ autofonce run -T test.atProject description loaded from $PWD/autofonce.tomlLoading tests from file "$PWD/test.at"Creating testing directory $PWD/_autofonce0001 Example test                    FAIL (test.at:14:0 stdout stderr)Results:* 1 checks performed* 0 / 1 tests executed successfully* 1 tests failed: 0001File "$PWD/_autofonce/results.log" created with failure resultszsh: exit 1     autofonce run -T test.at

1. ANSITerminal>= "0.8"
2. autofonce_m4= version
3. autofonce_misc= version
4. autofonce_share= version
5. ez_cmdliner>= "0.2"
6. ez_file>= "0.3"
7. ocplib_stuff>= "0.1"
8. dune>= "2.7.0"
9. ocaml>= "4.10.0"

1. ocamlformatwith-test
2. odocwith-doc
3. ppx_expectwith-test
4. ppx_inline_testwith-test

1. autofonce_lib

None