Name		Name	Last commit message	Last commit date
parent directory ..
alias		alias
align		align
ambsym		ambsym
arc		arc
arithm		arithm
assert		assert
assign		assign
avr		avr
benchmarks		benchmarks
borrow		borrow
ccgbugs		ccgbugs
cli		cli
compilepragma		compilepragma
compiler		compiler
compilerapi		compilerapi
compilerfeatures		compilerfeatures
compilerunits		compilerunits
constr		constr
cruft		cruft
defaultprocparam		defaultprocparam
deprecated		deprecated
dir with space		dir with space
dll		dll
effects		effects
errmsgs		errmsgs
error_propagation		error_propagation
exception		exception
fragmentation		fragmentation
gc		gc
gensym		gensym
global		global
ic		ic
import_in_config		import_in_config
importalls		importalls
isolate		isolate
js		js
lang		lang
lang_callable		lang_callable
lang_defs		lang_defs
lang_experimental		lang_experimental
lang_exprs		lang_exprs
lang_meta		lang_meta
lang_objects		lang_objects
lang_stmts		lang_stmts
lang_syntax		lang_syntax
lang_types		lang_types
lent		lent
lookups		lookups
magics		magics
manyloc		manyloc
misc		misc
modules		modules
nimble		nimble
nimdoc		nimdoc
optimization		optimization
overflw		overflw
pragmas		pragmas
showoff		showoff
specialops		specialops
statictypes		statictypes
stdlib		stdlib
stylecheck		stylecheck
system		system
testament		testament
testdata		testdata
threads		threads
tools		tools
typerel		typerel
types		types
untestable		untestable
valgrind		valgrind
vm		vm
dummy.txt		dummy.txt
js.html		js.html
js.nim		js.nim
m14634.nim		m14634.nim
mmaptest.nim		mmaptest.nim
nim.cfg		nim.cfg
readme.md		readme.md
rectest.nim		rectest.nim
stckovfl.nim		stckovfl.nim
test_nimscript.nims		test_nimscript.nims

readme.md

This directory contains the test cases.

Each test must have a filename of the form: t*.nim

Note: Testament is only aware of tests under a directory (eg tests/foo/) and will ignore top-level tests like tests/tbar.nim.

Specs

Each test can contain a spec in a discard """ ... """ block.

Check out the parseSpec procedure in the specs module for a full and reliable reference

action

Specifies what action this test should take.

Default: run

Options:

compile - compiles the module and fails the test if compilations fails.
run - compiles and runs the module, fails the test if compilation or execution of test code fails.
reject - compiles the module and fails the test if compilation succeeds.

There are certain spec keys that imply run, including output and outputsub.

cmd

Specifies the Nim command to use for compiling the test.

There are a number of variables that are replaced in this spec option:

$target - the compilation target, e.g. c.
$options - the options for the compiler.
$file - the filename of the test.
$filedir - the directory of the test file.

Example:

discard """
  cmd: "nim $target --nimblePath:./nimbleDir/simplePkgs $options $file"
"""

Categories

Each folder under this directory represents a test category, which can be tested by running koch tests pcat <category> (or cat to avoid parallel testing, which is slower).

The folder dll contains simple DLL tests.

The folder realtimeGC contains a test for validating that the realtime GC can run properly without linking against the nimrtl.dll/so.