paulhorn/sqlite
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Minor updates to testrunner documentation.

Browse Source 
FossilOrigin-Name: f8507bd5e221783175be2bb7b907c098e0970b1cbcb01817df7217005eab9ab4
This commit is contained in:
drh
2026-04-16 17:07:23 +00:00
parent 8895c50403
commit 2cefd5954a
4 changed files with 24 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/testrunner.md
+6 -1
View File
@@ -33,7 +33,7 @@
The testrunner.tcl program is a Tcl script used to run multiple SQLite The testrunner.tcl program is a Tcl script used to run multiple SQLite
tests in parallel, thus reducing testing time on multi-core machines. tests in parallel, thus reducing testing time on multi-core machines.
The testrunner.tcl supports running tests that based on `testfixture`, The testrunner.tcl supports running tests that based on `testfixture`,
`sqlite3`, and `fuzzcheck`. `sqlite3`, `fuzzcheck`, and C programs found in test/c.
<a name="runtr"></a> <a name="runtr"></a>
## 1.1 Running testrunner.tcl ## 1.1 Running testrunner.tcl
@@ -59,11 +59,16 @@ up front.
The standard Makefiles for SQLite include targets that invoke The standard Makefiles for SQLite include targets that invoke
testrunner.tcl. So the following commands also run testrunner.tcl: testrunner.tcl. So the following commands also run testrunner.tcl:
* `make test`
* `make devtest` * `make devtest`
* `make releasetest` * `make releasetest`
* `make sdevtest` * `make sdevtest`
* `make testrunner` * `make testrunner`
Since SQLite 3.53.0, there is a "<tt>make.bat</tt>" script in the root
of the source tree that causes the "make" command to work on Windows.
There is no need to do something different using "nmake" on Windows.
<a name="outputs"></a> <a name="outputs"></a>
## 1.3 Outputs from testrunner.tcl ## 1.3 Outputs from testrunner.tcl
manifest
+8 -9
View File
@@ -1,5 +1,5 @@
C Run\sC-language\stests\sin\stests/c/\sas\spart\sof\srelease\stest. C Minor\supdates\sto\stestrunner\sdocumentation.
D 2026-04-16T16:43:32.721 D 2026-04-16T17:07:23.368
F .fossil-settings/binary-glob 61195414528fb3ea9693577e1980230d78a1f8b0a54c78cf1b9b24d0a409ed6a x F .fossil-settings/binary-glob 61195414528fb3ea9693577e1980230d78a1f8b0a54c78cf1b9b24d0a409ed6a x
F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
@@ -63,7 +63,7 @@ F doc/jsonb.md acd77fc3a709f51242655ad7803510c886aa8304202fa9cf2abc5f5c4e9d7ae5
F doc/lemon.html 2085fda0a90a94fe92159a79dccc5c30d5a2313524887a31659cd66162f17233 F doc/lemon.html 2085fda0a90a94fe92159a79dccc5c30d5a2313524887a31659cd66162f17233
F doc/pager-invariants.txt 83aa3a4724b2d7970cc3f3461f0295c46d4fc19a835a5781cbb35cb52feb0577 F doc/pager-invariants.txt 83aa3a4724b2d7970cc3f3461f0295c46d4fc19a835a5781cbb35cb52feb0577
F doc/tcl-extension-testing.md b88861804fc1eaf83249f8e206334189b61e150c360e1b80d0dcf91af82354f5 F doc/tcl-extension-testing.md b88861804fc1eaf83249f8e206334189b61e150c360e1b80d0dcf91af82354f5
F doc/testrunner.md daffa0ebbbe397a73537ae1b19b3124d489ce5f89dfe570781d1f1ef1809597c F doc/testrunner.md 3589f7914d36adaff6d108566e09b2c6166887bea00580e5343f8b43615ffe12
F doc/trusted-schema.md 33625008620e879c7bcfbbfa079587612c434fa094d338b08242288d358c3e8a F doc/trusted-schema.md 33625008620e879c7bcfbbfa079587612c434fa094d338b08242288d358c3e8a
F doc/vdbesort-memory.md 4da2639c14cd24a31e0af694b1a8dd37eaf277aff3867e9a8cc14046bc49df56 F doc/vdbesort-memory.md 4da2639c14cd24a31e0af694b1a8dd37eaf277aff3867e9a8cc14046bc49df56
F doc/vfs-shm.txt 1a55f3f0e7b6745931b117ba5c9df3640d7a0536f532ef0052563100f4416f86 F doc/vfs-shm.txt 1a55f3f0e7b6745931b117ba5c9df3640d7a0536f532ef0052563100f4416f86
@@ -1718,7 +1718,7 @@ F test/temptrigfault.tes fc5918e64f3867156fefe7cfca9d8e1f495134a5229b2b511b0dc11
F test/temptrigger.test a00f258ed8d21a0e8fd4f322f15e8cfb5cef2e43655670e07a753e3fb4769d61 F test/temptrigger.test a00f258ed8d21a0e8fd4f322f15e8cfb5cef2e43655670e07a753e3fb4769d61
F test/tester.tcl 2d943f60200e0a36bcd3f1f0baf181a751cd3604ef6b6bd4c8dc39b4e8a53116 F test/tester.tcl 2d943f60200e0a36bcd3f1f0baf181a751cd3604ef6b6bd4c8dc39b4e8a53116
F test/testloadext.c 862b848783eaed9985fbce46c65cd214664376b549fae252b364d5d1ef350a27 F test/testloadext.c 862b848783eaed9985fbce46c65cd214664376b549fae252b364d5d1ef350a27
F test/testrunner.tcl cc5ff144daa48e351cf4523a45998986a1d68f85d5babfd53e372dc1a74f6fdc x F test/testrunner.tcl af3dd4e89739b18f9e23ab1c62828cd53a0902e4140269c49485dd6deba9d0f0 x
F test/testrunner_data.tcl dfcf192d274e965845189cc014ac89fff91dde92b6e2ac9e1262897fc21ee2e0 F test/testrunner_data.tcl dfcf192d274e965845189cc014ac89fff91dde92b6e2ac9e1262897fc21ee2e0
F test/testrunner_estwork.tcl 81e2ae10238f50540f42fbf2d94913052a99bfb494b69e546506323f195dcff9 F test/testrunner_estwork.tcl 81e2ae10238f50540f42fbf2d94913052a99bfb494b69e546506323f195dcff9
F test/thread001.test a0985c117eab62c0c65526e9fa5d1360dd1cac5b03bde223902763274ce21899 F test/thread001.test a0985c117eab62c0c65526e9fa5d1360dd1cac5b03bde223902763274ce21899
@@ -2201,9 +2201,8 @@ F tool/warnings-clang.sh bbf6a1e685e534c92ec2bfba5b1745f34fb6f0bc2a362850723a9ee
F tool/warnings.sh a554d13f6e5cf3760f041b87939e3d616ec6961859c3245e8ef701d1eafc2ca2 F tool/warnings.sh a554d13f6e5cf3760f041b87939e3d616ec6961859c3245e8ef701d1eafc2ca2
F tool/win/sqlite.vsix deb315d026cc8400325c5863eef847784a219a2f F tool/win/sqlite.vsix deb315d026cc8400325c5863eef847784a219a2f
F tool/winmain.c 00c8fb88e365c9017db14c73d3c78af62194d9644feaf60e220ab0f411f3604c F tool/winmain.c 00c8fb88e365c9017db14c73d3c78af62194d9644feaf60e220ab0f411f3604c
P cb910047edc591102dd4ed0d57c863b366981b8aa1d3085d5f95b1fbbabf6c31 2d81ee65ffbed30fd98bdda96dc79c1929c73f806cea3c9e4c244b618980b202 P e6929022b71c6bff7aa9cfbdb8a5e80499ca856b8c06d4211c55311b48704a08
R be1926b5db74f71941439938d0fcffd3 R e72d5e901a263ebcbe80388807e7b6df
T +closed 2d81ee65ffbed30fd98bdda96dc79c1929c73f806cea3c9e4c244b618980b202 U drh
U dan Z a1fd3877c2c5ab5147c44c97772a52a3
Z cac81702445eb1f77e03aa0851674706
# Remove this line to create a well-formed Fossil manifest. # Remove this line to create a well-formed Fossil manifest.
manifest.uuid
+1 -1
View File
@@ -1 +1 @@
e6929022b71c6bff7aa9cfbdb8a5e80499ca856b8c06d4211c55311b48704a08 f8507bd5e221783175be2bb7b907c098e0970b1cbcb01817df7217005eab9ab4
test/testrunner.tcl
+9 -14
View File
@@ -142,25 +142,20 @@ are run. Otherwise, each pattern is interpreted as a glob pattern. Only
those tcl tests for which the final component of the filename matches at those tcl tests for which the final component of the filename matches at
least one specified pattern are run. The glob wildcard '*' is prepended least one specified pattern are run. The glob wildcard '*' is prepended
to the pattern if it does not start with '^' and appended to every to the pattern if it does not start with '^' and appended to every
pattern that does not end with '$'. If PATTERN begins with "~", then it pattern that does not end with '$'. If any PATTERN argument begins with "~",
is an anti-pattern that only matches tests that do not match PATTERN. then it is an anti-pattern. When PATTERN arguments are present, tests are
Tests or only run if they match one or more patterns and match no only run if they match one or more patterns and match no anti-patterns.
anti-patterns.
If no PATTERN arguments are present, then various fuzztest, threadtest
and other tests are run as part of the "release" permutation. These are
omitted if any PATTERN arguments are specified on the command line.
If a PERMUTATION is specified and is followed by the path to a Tcl script If a PERMUTATION is specified and is followed by the path to a Tcl script
instead of a list of patterns, then that single Tcl test script is run instead of a list of patterns, then that single Tcl test script is run
with the specified permutation. with the specified permutation.
The "status" and "njob" commands are designed to be run from the same The "status" and "njob" commands are designed to be run from the same
directory as a running testrunner.tcl script that is running tests. The directory as a running testrunner.tcl script. The "status" command prints
"status" command prints a report describing the current state and progress a report describing the current state and progress of the tests. Use
of the tests. Use the "-d N" option to have the status display clear the the "-d N" option to have the status display clear the screen and repeat
screen and repeat every N seconds. The "njob" command may be used to query every N seconds. The "njob" command may be used to query or modify the
or modify the number of sub-processes the test script uses to run tests. number of sub-processes the test script uses to run tests.
The "halt" command modifies the database so that all tasks are marked The "halt" command modifies the database so that all tasks are marked
as complete. Testing will halt when all tests currently running complete. as complete. Testing will halt when all tests currently running complete.
@@ -180,7 +175,7 @@ shows the jobs that failed. If PATTERN are provided, the error information
is only provided for jobs that match PATTERN. is only provided for jobs that match PATTERN.
The "retest" command reruns tests that failed or were never completed The "retest" command reruns tests that failed or were never completed
by a prior invocation of testrunner.tcl. by the previous invocation of testrunner.tcl.
Full documentation here: https://sqlite.org/src/doc/trunk/doc/testrunner.md Full documentation here: https://sqlite.org/src/doc/trunk/doc/testrunner.md
}]] }]]