GeezerVison is showing github.com — doc: document wildcard supported by tools/test.py · nodejs/node@bac70c6
File tree
Expand file treeCollapse file tree
Open diff view settings
Expand file treeCollapse file tree
Open diff view settings
Collapse file
Copy file name to clipboardExpand all lines: BUILDING.md +21Lines changed: 21 additions & 0 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -352,6 +352,27 @@ You can also execute the tests in a test suite directory |
352 | 352 | tools/test.py test/message |
353 | 353 | ``` |
354 | 354 |
|
| 355 | +You can execute tests that match a specific naming pattern using the wildcard |
| 356 | +`*`. For example, to run all tests under `test/parallel` with a name that starts |
| 357 | +with `test-stream-`: |
| 358 | + |
| 359 | +```bash |
| 360 | +tools/test.py test/parallel/test-stream-* |
| 361 | +tools/test.py parallel/test-stream-* # The test/ prefix can be omitted |
| 362 | +# In some shell environments, you may need to quote the pattern |
| 363 | +tools/test.py "test/parallel/test-stream-*" |
| 364 | +``` |
| 365 | + |
| 366 | +The whildcard `*` can be used in any part of the path. For example, to run all tests |
| 367 | +with a name that starts with `test-inspector-`, regardless of the directory they are in: |
| 368 | + |
| 369 | +```bash |
| 370 | +# Matches test/sequential/test-inspector-*, test/parallel/test-inspector-*, |
| 371 | +# test/known_issues/test-inspector-*, etc. |
| 372 | +tools/test.py "test/*/test-inspector-*" |
| 373 | +tools/test.py "*/test-inspector-*" # The test/ prefix can be omitted |
| 374 | +``` |
| 375 | + |
355 | 376 | If you want to check the other options, please refer to the help by using |
356 | 377 | the `--help` option: |
357 | 378 |
|
|
Collapse file
Copy file name to clipboardExpand all lines: doc/contributing/writing-tests.md +5Lines changed: 5 additions & 0 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -485,6 +485,11 @@ To generate a test coverage report, see the |
485 | 485 | Nightly coverage reports for the Node.js `main` branch are available at |
486 | 486 | <https://coverage.nodejs.org/>. |
487 | 487 |
|
| 488 | +## Running tests |
| 489 | + |
| 490 | +See the [Building guide](../../BUILDING.md#running-tests) for details on how to |
| 491 | +run tests. |
| 492 | + |
488 | 493 | [ASCII]: https://man7.org/linux/man-pages/man7/ascii.7.html |
489 | 494 | [Google Test]: https://github.com/google/googletest |
490 | 495 | [Test Coverage section of the Building guide]: https://github.com/nodejs/node/blob/HEAD/BUILDING.md#running-coverage |
|