1. Overview
  2. Docs

Description

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.

Tags

org:ocamlpro

Added to opam-repository:

README

Actions Status Release

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 by autofonce:

# Start of a test, and the name that will be displayed
AT_SETUP([Example test])

# can be used to select tests to run:
AT_KEYWORDS([example test autofonce]) 

# create a file `file` with its content
AT_DATA([file], [
content of file
on multiple lines
])

# call some command, check its exit code, stdout, stderr
AT_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 test
AT_CLEANUP

Now, copy this test in a file test.at, and run autofonce:

$ autofonce init
$ autofonce run -T test.at
Project description loaded from $PWD/autofonce.toml
Loading tests from file "$PWD/test.at"
Creating testing directory $PWD/_autofonce

0001 Example test                    FAIL (test.at:14:0 stdout stderr)
Results:
* 1 checks performed
* 0 / 1 tests executed successfully
* 1 tests failed: 0001
File "$PWD/_autofonce/results.log" created with failure results
zsh: exit 1     autofonce run -T test.at

Dependencies (4)

  1. ez_file >= "0.3"
  2. ocplib_stuff >= "0.1"
  3. dune >= "2.7.0"
  4. ocaml >= "4.10.0"

Dev Dependencies (4)

  1. ocamlformat with-test
  2. odoc with-doc
  3. ppx_expect with-test
  4. ppx_inline_test with-test

Used by (1)

  1. autofonce_lib

Conflicts

None

Build status

Results of building autofonce_patch with each compiler on check.ci.ocaml.org, run of against opam-repository 7cdc698. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
0.8 (this version) good good good good good
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure