Myra test utils

Software freedom empowers sharing. Let's dedicate our libre software projects to saints known for fostering sharing!

This Guile scheme package is dedicated to St. Nicholas of Myra, bishop from 4th century. According to a legend, young Nicholas inherited some meaningful wealth after his parents and then used it to make a secret gift of 3 money sacks that he dropped at a home of 3 poor girls — saving them from being forced into prostitution. He's been the prototype of Santa Claus.

What is this package for?

One part of the package — a test driver extracted from GNU Guix — allows SRFI-64 tests to be easily executed through Automake's make check. This is the same driver as also distributed with Automake, albeit with some extra improvements.

The other part — (myra-test-utils) module — exports modified variants of SRFI-64's test-* forms that optionally spawn an interactive Guile REPL when an unexpected condition is raised.

The test-error macro additionally also alters the behavior of its original by verifying the type of the error raised by tested code. The programmer-supplied error-type argument of the original test-error form would be — as of GNU Guile 3.0.9 — ignored (this is permitted by SRFI-64). Here it can be either an SRFI-35 condition type, a procedure or #t (for the original behavior of accepting all error types).

The same module also supplies some convenience forms for using fixtures when executing test groups.

Using

Look at de Paul records for an example.

Building & installation

This software has a Guix package definition in Wojtek's personal channel. That can serve you as a point of reference.

Copying

This package is available under GNU GPL v3.0 or (at your option) any later version. Additionally, much of the source is independently available under CC0 v1.0. The repository is kept compliant with the REUSE specification, version 3.0.