This document describes usage of the unit testing framework for uim
for developers.
* Abstract
The testing framework can test *.scm written for uim. It consists of
the three components below.
- Gauche: a Scheme implementation
- GaUnit: an unit testing framework for Gauche
- uim-test-utils.scm: uim-sh to GaUnit adapter
The framework runs on Gauche and evaluates the expression of tests
by sending it to uim-sh invoked as inferior process. So the
framework can test all uim-dependent codes, on the rich Scheme
environment.
uim-test-utils.scm was contributed by Kouhei Sutou, the author of
GaUnit. Thank you for the significant help.
* Prerequisite
Install the following.
- Gauche 0.8.5 or higher
http://www.shiro.dreamhost.com/scheme/gauche/
- GaUnit 0.1.6
http://www.cozmixng.org/~kou/download/index.html.en
http://www.cozmixng.org/~rwiki/index.rb?cmd=view;name=GaUnit%3A%3AREADME.en
* Usage
1) cd top source/build directory of uim
2) Build uim
3) cd test/
4) Run test as follows
All tests:
$ ./run-test.scm
Selective:
$ ./run-test.scm test-foo.scm
With options:
$ ./run-test.scm test-util.scm -vv -c "list procedures"
Refer the document of GaUnit or specify -h to see all options.
* Writing tests
1) touch test/test-foo.scm
2) chmod +x test/test-foo.scm
3) Insert test/template.scm into 1)
4) Write tests as described in test/test-example.scm
5) Add test-foo.scm into EXTRA_DIST of test/Makefile.am
* Guidelines for uim project
FIXME: describe this
Generated by dwww version 1.16 on Sat Oct 3 03:24:10 CEST 2026.