sheafixstars / reactor-c

A reactor runtime written in C

Reactor-C: A reactor runtime implementation in C

Documentation

To generate and view documentation, see docs/README.md.

Testing

The Github Actions tests for this repo will automatically run all the C Lingua Franca tests with each of the available schedulers. The version of the lingua-franca repo that is used to do this is specified by the lingua-franca-ref.txt file in this directory.

To create a new test, write a C program with a file name ending in "test.c" in a subdirectory of the test directory. That file should contain a main and should return 0 if the test succeeds.

• Tests in the general subdirectory will always be run.
• Tests in the single-threaded and multithreaded subdirectories will be run depending on parameters passed to cmake.

To run tests for the single-threaded runtime, execute the following. Note that -U is required to undefine a name that may be cached from a previous run.

• cd build
• cmake .. -UNUMBER_OF_WORKERS
• cmake --build .
• make test

To run tests for the multithreaded runtime, provide a nonzero number of workers when invoking cmake. For example:

• cmake .. -DNUMBER_OF_WORKERS=2

To define/undefine other preprocessor definitions such as LOG_LEVEL, pass them as arguments to cmake in the same way as with NUMBER_OF_WORKERS, using the same -D/-U prefixes.