SHTK_UNITTEST_SKIP(3)

NAME
shtk_unittest_skip - Skips the test currently being run

LIBRARY
shtk_import unittest

SYNOPSIS
shtk_unittest_skip [arg1 .. argN]

DESCRIPTION
The shtk_unittest_skip function marks the currently running test as skipped and aborts execution. The message given in the arguments arg1 through argN is printed along the skip condition.

Skipped tests do not count as failures: instead, they just represent a test that cannot be successfully be executed and is thus ignored.

EXAMPLES
Consider the following test case that requires a specific file to be present in the system:

    shtk_unittest_add_test motd_contents
    motd_contents_test() {
        [ -f /etc/motd ] || skip "/etc/motd not found; cannot validate"
        ... do something with /etc/motd here ...
    }

SEE ALSO
shtk(3), shtk_unittest(3)

HISTORY
shtk_unittest_skip first appeared in shtk 1.6.