Document --match-path and --no-match-path for forge test

[onbjerg]

See foundry-rs/foundry#662

The relevant file this should be updated in is ./src/forge/tests.md

[rootulp]

I took a stab at documenting this but I'm observing unexpected behavior. I have a forge project that looks like

$ tree .
...
└── src
    ├── Contract.sol
    └── test
        ├── ContractA.t.sol
        ├── ContractB.t.sol
        └── ContractC.t.sol

I'm observing no tests run when I expect all three tests to run

$ forge test --match-path './src/test/*'
compiling...
no files changed, compilation skipped.

I'm observing no tests run when I expect testA to run

> forge test --match-path './src/test/ContractA.t.sol'
compiling...
no files changed, compilation skipped.

I'm observing all tests run when I expect no tests to run

$ forge test --no-match-path './src/test/*'
compiling...
no files changed, compilation skipped.
Running 1 test for ContractA.json:ContractA
[PASS] testA() (gas: 120)

Running 1 test for ContractB.json:ContractB
[PASS] testB() (gas: 120)

Running 1 test for ContractC.json:ContractC
[PASS] testC() (gas: 142)

@lattejed can you please help me understand if I'm using these flags incorrectly?

[lattejed]

--match-path <PATH_PATTERN>
    only run test methods in source files at path matching regex. Requires absolute path

--no-match-path <PATH_PATTERN_INVERSE>
    only run test methods in source files at path not matching regex. Requires absolute path

They require an absolute path. Internally that pattern gets prefixed with a ^ and matched against the absolute paths of contract source files.

If the ergonomics of that are too awkward, feel free to file an issue. I can revisit that

[rootulp]

Thanks! It works as expected now.

$ forge test --match-path '/Users/rootulp/git/hello_foundry/src/test/*'
compiling...
no files changed, compilation skipped.
Running 1 test for ContractA.json:ContractA
[PASS] testA() (gas: 120)

Running 1 test for ContractB.json:ContractB
[PASS] testB() (gas: 120)

Running 1 test for ContractC.json:ContractC
[PASS] testC() (gas: 142)

$ forge test --no-match-path '/Users/rootulp/git/hello_foundry/src/test/*'
compiling...
no files changed, compilation skipped.