Next: , Up: checks   [Index]


17.1 Selecting tests to be run

As usage example, let’s assume that the system environment variable CHECK_TEST_NAME is set to yellow:

(parameterise ((check-test-name 'yellow))

  ;; this is evaluated
  (check
      (do-something)
    => 123)

  ;; this is evaluated, too
  (check
      (do-some-other-thing)
    => 456))

(parameterise ((check-test-name 'blue))

  ;; this is NOT evaluated
  (check
      (do-something)
    => #t)

  ;; this is NOT evaluated
  (check
      (do-some-other-thing)
    => #f))

;; this is evaluated
(check "yellow-one"
    (do-something)
  => 123)

;; this is NOT evaluated
(check 'red
    (do-something)
  => #t)
Environment Variable: CHECK_TEST_NAME

The system environment variable used to select tests in a test suite file. The value of the variable must be the name, or the prefix of the name, or the suffix of the name, of one or more tests.

Parameter: check-test-name

Holds the name of the current test or tests. Must be set to #f, a string or a symbol.