Checktestdata is a tool to verify the syntactical integrity of test cases in programming contests like the ACM ICPC.
It allows you to specify a simple grammar for your testdata input files,
according to which the testdata is checked. In the examples directory
you find two sample scripts
fltcmp.ctd from the
DOMjudge sample problems hello and
fltcmp, and under examples/nwerc2008 the
scripts used for the NWERC 2008 problemset.
We also have a Haskell implementation of the checktestdata program, which supports this specification as well as a Haskell embedded domain-specific language.
Installation and use
- A C++ compiler that supports C++11 including regex support. (GNU g++ >= 4.9 and LLVM clang++ >= 3.5 are known to work)
- Libboost (http://www.boost.org/)
- The GNU GMP libraries (http://gmplib.org/)
- Automake (https://www.gnu.org/software/automake/)
- flexc++/bisonc++ (optional)
If you don't have
bisonc++ available, you may use the release
branch where we've pre-generated the scanner/parser files.
Command line for installing the build dependencies on Debian or Ubuntu, when using the release branch:
apt-get install make g++ libboost-dev libgmp-dev autotools-dev automake
For Redhat-like distributions try:
yum install make g++ boost-devel gmp-devel automake
To compile checktestdata, run:
./bootstrap make dist make
Leave out the
make dist step if you use the pre-generated scanner/parser
files on the release branch.
Finally, you can run
to run a number of tests. Note that a few of the tests are
non-deterministic and may sometimes return an error. This is ok, but the
make check command should run successfully more than 90% of the time.
For usage instructions run:
The commandline program is built upon the separate library
checktestdata.cc as an example for how to use this
library) that can be used to write the syntax checking part of special compare
scripts. It can easily handle the tedious task of verifying that a team's
submission output is syntactically valid, leaving just the task of semantic
validation to another program.
When you want to support presentation error as a verdict, also in variable output problems, the option whitespace-ok can be useful. This allows any non-empty sequence of whitespace (no newlines though) where the SPACE command is used, as well as leading and trailing whitespace on lines (when using the NEWLINE command). Please note that with this option enabled, whitespace matching is greedy, so the script code
INT(1,2) SPACE SPACE INT(1,2)
does not match
1__2 (where the two underscores represent spaces), because the
SPACE command already matches both, so the second cannot match
Copyright & Licencing
Checktestdata is Copyright © 2008 - 2018 by the checktestdata developers and all respective contributors. The current checktestdata developers are Jeroen Bransen, Jaap Eldering, Jan Kuipers, and Tobias Werth; see the git commits for a complete list of contributors.
Checktestdata, including its documentation, is free software; you can redistribute it and/or modify it under the terms of the two-clause BSD license. See the file COPYING.
The M4 autoconf macros are licenced under all-permissive and GPL3+ licences; see the respective files under m4/ for details.
The developers can be reached through the mailinglist
email@example.com. You need to be subscribed before
you can post. Information, subscription and archives are available at:
Some developers and users of checktestdata linger on the IRC channel
dedicated to DOMjudge on the Freenode network: