doc: document wildcard supported by tools/test.py

[joyeecheung]

This seems to be a underdocumented but useful trick that only very few people know about. Also add a pointer to the test running guide in the test writing guide.

[nodejs-github-bot]

Review requested:

• @nodejs/build
• @nodejs/tsc

[richardlau]

FWIW the test/ prefix is optional and can be omitted, e.g.

tools/test.py parallel/test-stream-*

works.
(IIRC originally the prefix-less (no test/) syntax was the originally supported syntax, and the ability to include the test/ prefix was added later.)

[legendecas]

In certain shells, the wildcard should be quoted:

$ tools/test.py 'parallel/test-stream-*'

I use this pattern a lot, without test/ prefix.

[joyeecheung]

In certain shells, the wildcard should be quoted:

Yes, that's mentioned in the examples

[joyeecheung]

(IIRC originally the prefix-less (no test/) syntax was the originally supported syntax, and the ability to include the test/ prefix was added later.)

Added a few more examples without the prefix (I used the one with the prefix a bit more often because I tend to copy the relative path from vscode)

[nodejs-github-bot]

Landed in 8096aea

[aduh95]

FWIW that might be a bit misleading. If you don't quote it (and you use a POSIX-complient shell), the shell is going to expand it (i.e. looking for all files that match and pass each as a separate arg); so arguably quotes are always necessary, otherwise you waste a lot of time for on the shell expansion:

$ time tools/test.py test/parallel/test-debug*
[00:05|% 100|+  35|-   0]: Done                                               

All tests passed.
tools/test.py test/parallel/test-debug*  15.09s user 1.94s system 92% cpu 18.477 total
$ time tools/test.py 'test/parallel/test-debug*'
[00:05|% 100|+  35|-   0]: Done                                               

All tests passed.
tools/test.py 'test/parallel/test-debug*'  8.38s user 1.04s system 146% cpu 6.424 total