aboutsummaryrefslogtreecommitdiff
path: root/runtime/doc/testing.txt
blob: 941c440b6c12952c64023ba27e200857a66e66e9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
*testing.txt*	Nvim


		  VIM REFERENCE MANUAL	  by Bram Moolenaar


Testing Vim and Vim script			*testing-support*

Expression evaluation is explained in |eval.txt|.  This file goes into details
about writing tests in Vim script.  This can be used for testing Vim itself
and for testing plugins.

1. Testing Vim				|testing|
2. Test functions			|test-functions-details|
3. Assert functions			|assert-functions-details|

==============================================================================
1. Testing Vim						*testing*

Vim can be tested after building it, usually with "make test".
The tests are located in the directory "src/testdir".

						*new-style-testing*
New tests should be added as new style tests.  The test scripts are named
test_<feature>.vim (replace <feature> with the feature under test). These use
functions such as |assert_equal()| to keep the test commands and the expected
result in one place.

Find more information in the file src/testdir/README.txt.

==============================================================================
2. Test functions				*test-functions-details*

See |test_garbagecollect_now()|.

==============================================================================
3. Assert functions				*assert-functions-details*

See:
  - |assert_beeps()|
  - |assert_equal()|
  - |assert_equalfile()|
  - |assert_exception()|
  - |assert_fails()|
  - |assert_false()|
  - |assert_inrange()|
  - |assert_match()|
  - |assert_nobeep()|
  - |assert_notequal()|
  - |assert_notmatch()|
  - |assert_report()|
  - |assert_true()|

 vim:tw=78:ts=8:noet:ft=help:norl: