SchemeテストスイートAPI (Gauche ユーザリファレンス)

Next: srfi.66 - オクテットベクタ, Previous: srfi.60 - 整数に対するビット操作, Up: ライブラリモジュール - SRFI [Contents][Index]

11.15 `srfi.64` - SchemeテストスイートAPI ¶

Module: srfi.64 ¶

このモジュールはポータブルなテストスイートを書くAPIを提供します。 Gaucheでは、このsrfiはgauche.testと協調して動くようになっています (gauche.test - 単体テスト参照)。

gauche.testが有効な状態で、SRFI-64テストを走らせた場合、それらのテストはgauche.testの一部として実行されます。

推奨されるテストの書き方は、ポータブルなテストをsrfi-64のみで書き、 Gaucheテストスクリプトから次のとおりincludeすることです。

(use gauche.test)
(test-start "the tests")
;; portable test
(include "test-suite-in-srfi-64")

;; gauche-specific test, if needed
...

(test-end)

test-suite-in-srfi-64.scmをそれ単独で走らせた場合は、 SRFI-64のデフォルトのテスト報告形式で結果が報告されます。 gauche.testスクリプトからincludeして走らせた場合は、結果がgauche.testの報告形式を使って、他のGaucheテストと合わせて報告されます。

Next: Test API, Previous: srfi.64 - SchemeテストスイートAPI, Up: srfi.64 - SchemeテストスイートAPI [Contents][Index]

11.15.1 Test runner ¶

In SRFI-64, tests are run with an active test runner which collects test results and emits reports. It allows users to provide custom runners to handle tailored reports suitable to the specific tests.

Test runner object ¶

Record: test-runner ¶: [SRFI-64]{srfi.64}

Function: test-runner? obj ¶: [SRFI-64]{srfi.64}

Parameter: test-runner-current ¶: [SRFI-64]{srfi.64}

Function: test-runner-get ¶: [SRFI-64]{srfi.64}

Function: test-runner-simple ¶: [SRFI-64]{srfi.64}

Function: test-runner-null ¶: [SRFI-64]{srfi.64}

Function: test-runner-factory :optional factory ¶: [SRFI-64]{srfi.64}

Running tests with a specified runner ¶

Function: test-apply [runner] specifier … procedure ¶: [SRFI-64]{srfi.64}

Macro: test-with-runner runner decl-or-expr … ¶: [SRFI-64]{srfi.64}

Latest result properties ¶

A runner holds a single alist to keep the latest result properties. Except the result-kind property, which is set by every basic test procedures, the usage of properties are up to the test runner and/or test writer.

Function: test-result-clear runner ¶: [SRFI-64]{srfi.64}

Function: test-result-ref runner pname :optional default ¶: [SRFI-64]{srfi.64}

Function: test-result-set! runnre pname value ¶: [SRFI-64]{srfi.64}

Function: test-result-remove runner pname ¶: [SRFI-64]{srfi.64}

Function: test-result-alist runner ¶: [SRFI-64]{srfi.64}

Function: test-result-kind :optional runner ¶: [SRFI-64]{srfi.64}

Function: test-passed? :optional runner ¶: [SRFI-64]{srfi.64}

Keeping track of test status ¶

Function: test-runner-pass-count runner ¶
Function: test-runner-fail-count runner ¶
Function: test-runner-xpass-count runner ¶
Function: test-runner-xfail-count runner ¶
Function: test-runner-skip-count runner ¶: [SRFI-64]{srfi.64}

Function: test-runner-test-name runner ¶: [SRFI-64]{srfi.64}

Function: test-runner-group-path runner ¶: [SRFI-64]{srfi.64}

Function: test-runner-group-stack runner ¶: [SRFI-64]{srfi.64}

Function: test-runner-aux-value runner ¶
Function: test-runner-aux-value! runner value ¶: [SRFI-64]{srfi.64}

Function: test-runner-reset runner ¶: [SRFI-64]{srfi.64}

Callbacks ¶

Function: test-runner-on-test-begin runner ¶
Function: test-runner-on-test-begin! runner proc ¶: [SRFI-64]{srfi.64}

Function: test-runner-on-test-end runner ¶
Function: test-runner-on-test-end! runner proc ¶: [SRFI-64]{srfi.64}

Function: test-runner-on-group-begin runner ¶
Function: test-runner-on-group-begin! runner proc ¶: [SRFI-64]{srfi.64}

Function: test-runner-on-group-end runner ¶
Function: test-runner-on-group-end! runner proc ¶: [SRFI-64]{srfi.64}

Function: test-runner-on-bad-count runner ¶
Function: test-runner-on-bad-count! runner proc ¶: [SRFI-64]{srfi.64}

Function: test-runner-on-bad-end-name runner ¶
Function: test-runner-on-bad-end-name! runner proc ¶: [SRFI-64]{srfi.64}

Function: test-runner-on-final runner ¶
Function: test-runner-on-final! runner proc ¶: [SRFI-64]{srfi.64}

Function: test-on-test-begin-simple runner ¶
Function: test-on-test-end-simple runner ¶
Function: test-on-group-begin-simple runner ¶
Function: test-on-group-end-simple runner ¶
Function: test-on-bad-count-simple runner actual-count expected-count ¶
Function: test-on-bad-end-name-simple runner begin-name end-name ¶: [SRFI-64]{srfi.64}

Previous: Test runner, Up: srfi.64 - SchemeテストスイートAPI [Contents][Index]

11.15.2 Test API ¶

Test grouping ¶

SRFI-64 tests can be grouped, and groups can be nested.

Function: test-begin suite-name :optional count ¶: [SRFI-64]{srfi.64}

Function: test-end :optional suite-name ¶: [SRFI-64]{srfi.64}

Function: test-group suite-name body … ¶: [SRFI-64]{srfi.64}

Function: test-group-with-cleanup suite-name body … cleanup ¶: [SRFI-64]{srfi.64}

Individual tests ¶

Macro: test-assert [test-name] expr ¶: [SRFI-64]{srfi.64}

Macro: test-eqv [test-name] expected test-expr ¶
Macro: test-eq [test-name] expected test-expr ¶
Macro: test-equal [test-name] expected test-expr ¶: [SRFI-64]{srfi.64}

Macro: test-approximate [test-name] extected test-expr margin ¶: [SRFI-64]{srfi.64}

Macro: test-error [[test-name] error-type] test-expr ¶: [SRFI-64]{srfi.64}

Function: test-read-eval-string string ¶: [SRFI-64]{srfi.64}

Macro: test-expect-fail specifier ¶: [SRFI-64]{srfi.64}

Conditional tests ¶

Function: test-match-name name ¶
Function: test-match-nth n :optional count ¶
Function: test-match-any specifier … ¶
Function: test-match-all specifier … ¶: [SRFI-64]{srfi.64}

Function: test-skip specifier ¶: [SRFI-64]{srfi.64}

11.15 srfi.64 - SchemeテストスイートAPI ¶