From 6602af7fe069246dbcf419c3e904a78b60e7d4dc Mon Sep 17 00:00:00 2001 From: Bram Moolenaar Date: Thu, 7 Jan 2016 22:01:01 +0100 Subject: patch 7.4.1060 Problem: Instructions for writing tests are outdated. Solution: Mention Make_all.mak. Add steps for new style tests. --- src/testdir/README.txt | 45 +++++++++++++++++++++++++++++++++------------ 1 file changed, 33 insertions(+), 12 deletions(-) (limited to 'src/testdir') diff --git a/src/testdir/README.txt b/src/testdir/README.txt index eb79d087c..7cbc77133 100644 --- a/src/testdir/README.txt +++ b/src/testdir/README.txt @@ -1,20 +1,41 @@ This directory contains tests for various Vim features. -If it makes sense, try to add a new test to an already existing file. You may -want to separate it from other tests in that file using :" (that's an Ex -command comment). +If it makes sense, add a new test method to an already existing file. You may +want to separate it from other tests with comment lines. The numbered tests are older, we have switched to named tests. -And the newest way of testing is to use assert functions, see test_assert.vim -for an example. -To add a new test: +And then you can chose between a new style test, which is a Vim script, or an +old style test, which uses Normal mode commands. Use a new style test if you +can. + + +TO ADD A NEW STYLE TEST: + +1) Create a test_.vim file. +2) Add test_.vim to NEW_TESTS in Make_all.mak in alphabetical order. +3) Use make test_.res to run a single test in src/testdir/. + Use make test_ to run a single test in src/. +4) Also add an entry in src/Makefile. + +What you can use (see test_assert.vim for an example): +- Call assert_equal(), assert_true() and assert_false(). +- Use try/catch to check for exceptions. +- Use alloc_fail() to have memory allocation fail. This makes it possible to + to check memory allocation failures are handled gracefully. You need to + change the source code to add an ID to the allocation. Update LAST_ID_USED + above alloc_id() to the highest ID used. + + +TO ADD AN OLD STYLE TEST: + 1) Create test_.in and test_.ok files. -2) Add them to all Makefiles (Make*) in alphabetical order (search for an - existing test_file.out to see where to add the new one). -3) Use make test_.out to run a single test file in src/testdir/. +2) Add test_.out to SCRIPTS_ALL in Make_all.mak in alphabetical order. +3) Use make test_.out to run a single test in src/testdir/. + Use make test_ to run a single test in src/. 4) Also add an entry in src/Makefile. -Keep in mind that the files are used as if everything was typed. -A line break is like pressing Enter. If that happens on the last line you'll -hear a beep. +Keep in mind that the files are used as if everything was typed: +- To add comments use: :" (that's an Ex command comment) +- A line break is like pressing Enter. If that happens on the last line + you'll hear a beep! -- cgit v1.2.1