vim: src/testdir/README.txt annotate

annotate src/testdir/README.txt @ 21741:baccf9e06efe v8.2.1420

patch 8.2.1420: test 49 is old style Commit: https://github.com/vim/vim/commit/f7c4d83609acdfe0e4d0fec9413697ac97c0c3f9 Author: Bram Moolenaar <Bram@vim.org> Date: Tue Aug 11 20:42:19 2020 +0200 patch 8.2.1420: test 49 is old style Problem: Test 49 is old style. Solution: Convert remaining parts to new style. Remove obsolete items. (Yegappan Lakshmanan, closes #6683)

author	Bram Moolenaar <Bram@vim.org>
date	Tue, 11 Aug 2020 20:45:05 +0200
parents	07627d1b4d8c
children	808edde1e97d

rev	line source
6168 93aa03401309 updated for version 7.4.420 Bram Moolenaar <bram@vim.org> parents: diff changeset	1 This directory contains tests for various Vim features.
15430 d94901eeb762 patch 8.1.0723: cannot easily run specific test when in src/testdir Bram Moolenaar <Bram@vim.org> parents: 15034 diff changeset	2 For testing an indent script see runtime/indent/testdir/README.txt.
6168 93aa03401309 updated for version 7.4.420 Bram Moolenaar <bram@vim.org> parents: diff changeset	3
7517 9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	4 If it makes sense, add a new test method to an already existing file. You may
9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	5 want to separate it from other tests with comment lines.
6168 93aa03401309 updated for version 7.4.420 Bram Moolenaar <bram@vim.org> parents: diff changeset	6
7517 9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	7 TO ADD A NEW STYLE TEST:
9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	8
9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	9 1) Create a test_<subject>.vim file.
15430 d94901eeb762 patch 8.1.0723: cannot easily run specific test when in src/testdir Bram Moolenaar <Bram@vim.org> parents: 15034 diff changeset	10 2) Add test_<subject>.res to NEW_TESTS_RES in Make_all.mak in alphabetical
d94901eeb762 patch 8.1.0723: cannot easily run specific test when in src/testdir Bram Moolenaar <Bram@vim.org> parents: 15034 diff changeset	11 order.
d94901eeb762 patch 8.1.0723: cannot easily run specific test when in src/testdir Bram Moolenaar <Bram@vim.org> parents: 15034 diff changeset	12 3) Also add an entry "test_<subject>" to NEW_TESTS in Make_all.mak.
d94901eeb762 patch 8.1.0723: cannot easily run specific test when in src/testdir Bram Moolenaar <Bram@vim.org> parents: 15034 diff changeset	13 4) Use make test_<subject> to run a single test.
6168 93aa03401309 updated for version 7.4.420 Bram Moolenaar <bram@vim.org> parents: diff changeset	14
14689 796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	15 At 2), instead of running the test separately, it can be included in
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	16 "test_alot". Do this for quick tests without side effects. The test runs a
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	17 bit faster, because Vim doesn't have to be started, one Vim instance runs many
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	18 tests.
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	19
19465 07627d1b4d8c patch 8.2.0290: running individual test differs from all tests Bram Moolenaar <Bram@vim.org> parents: 16087 diff changeset	20 At 4), to run a test in GUI, add "GUI_FLAG=-g" to the make command.
07627d1b4d8c patch 8.2.0290: running individual test differs from all tests Bram Moolenaar <Bram@vim.org> parents: 16087 diff changeset	21
14689 796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	22
7517 9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	23 What you can use (see test_assert.vim for an example):
14689 796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	24
10100 26441931dad7 commit https://github.com/vim/vim/commit/dac1947bb366ef43cd6da95acc730554e76d8b84 Christian Brabandt <cb@256bit.org> parents: 9909 diff changeset	25 - Call assert_equal(), assert_true(), assert_false(), etc.
14689 796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	26
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	27 - Use assert_fails() to check for expected errors.
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	28
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	29 - Use try/catch to avoid an exception aborts the test.
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	30
16087 e992f31274b7 patch 8.1.1048: minor issues with tests Bram Moolenaar <Bram@vim.org> parents: 15430 diff changeset	31 - Use test_alloc_fail() to have memory allocation fail. This makes it possible
e992f31274b7 patch 8.1.1048: minor issues with tests Bram Moolenaar <Bram@vim.org> parents: 15430 diff changeset	32 to check memory allocation failures are handled gracefully. You need to
e992f31274b7 patch 8.1.1048: minor issues with tests Bram Moolenaar <Bram@vim.org> parents: 15430 diff changeset	33 change the source code to add an ID to the allocation. Add a new one to
e992f31274b7 patch 8.1.1048: minor issues with tests Bram Moolenaar <Bram@vim.org> parents: 15430 diff changeset	34 alloc_id_T, before aid_last.
14689 796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	35
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	36 - Use test_override() to make Vim behave differently, e.g. if char_avail()
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	37 must return FALSE for a while. E.g. to trigger the CursorMovedI autocommand
16087 e992f31274b7 patch 8.1.1048: minor issues with tests Bram Moolenaar <Bram@vim.org> parents: 15430 diff changeset	38 event. See test_cursor_func.vim for an example.
14689 796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	39
10100 26441931dad7 commit https://github.com/vim/vim/commit/dac1947bb366ef43cd6da95acc730554e76d8b84 Christian Brabandt <cb@256bit.org> parents: 9909 diff changeset	40 - If the bug that is being tested isn't fixed yet, you can throw an exception
14689 796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	41 with "Skipped" so that it's clear this still needs work. E.g.: throw
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	42 "Skipped: Bug with <c-e> and popupmenu not fixed yet"
796d794cdc88 patch 8.1.0357: instructions for tests are outdated Christian Brabandt <cb@256bit.org> parents: 13304 diff changeset	43
9228 ea504064c996 commit https://github.com/vim/vim/commit/fd89d7ea81b18d32363456b16258174dc9e095dc Christian Brabandt <cb@256bit.org> parents: 8011 diff changeset	44 - See the start of runtest.vim for more help.
7517 9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	45
9d67399f49c6 commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Christian Brabandt <cb@256bit.org> parents: 7478 diff changeset	46
13304 013c44d9dc09 patch 8.0.1526: no test using a screen dump yet Christian Brabandt <cb@256bit.org> parents: 10549 diff changeset	47 TO ADD A SCREEN DUMP TEST:
013c44d9dc09 patch 8.0.1526: no test using a screen dump yet Christian Brabandt <cb@256bit.org> parents: 10549 diff changeset	48
15034 6e4e0d43b20b patch 8.1.0528: various typos in comments Bram Moolenaar <Bram@vim.org> parents: 14689 diff changeset	49 Mostly the same as writing a new style test. Additionally, see help on
13304 013c44d9dc09 patch 8.0.1526: no test using a screen dump yet Christian Brabandt <cb@256bit.org> parents: 10549 diff changeset	50 "terminal-dumptest". Put the reference dump in "dumps/Test_func_name.dump".
013c44d9dc09 patch 8.0.1526: no test using a screen dump yet Christian Brabandt <cb@256bit.org> parents: 10549 diff changeset	51

Mercurial > vim

annotate src/testdir/README.txt @ 21741:baccf9e06efe v8.2.1420