Docs

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Forge
+
+#### Changed
+
+- You can now pass arguments to `cairo-profiler` or `cairo-coverage`,
+  e.g. `snforge test --coverage --include tests-functions`. If flags name duplicates a flag in `snforge test`, you can
+  use `--` to separate them, e.g. `snforge test --coverage -- --help`
+- You can't use now `--coverage` and `--build-profile` flags at the same time. If you want to use both, you need to run
+  `snforge test` twice with different flags.
+
 ## [0.32.0] - 2024-10-16
 
 ### Cast

docs/src/snforge-advanced-features/profiling.md

@@ -20,3 +20,21 @@ If you want `snforge` to call `cairo-profiler` on generated files automatically,
 ```shell
 $ snforge test --build-profile
 ``` 
+
+## Passing arguments to `cairo-profiler`
+
+You can pass additional arguments to `cairo-profiler`:
+
+```shell
+$ snforge test --build-profile --show-inlined-functions
+```
+
+If the flag name duplicates a flag from `snforge`, you can use the `--` separator:
+
+```shell
+$ snforge test --build-profile -- --help
+```
+
+> 📝 **Note**
+>
+> Running `snforge test --help` won't show info about `cairo-profiler` flags. To see them, run `snforge test --build-profile -- --help`.

docs/src/testing/coverage.md

@@ -45,6 +45,24 @@ $ snforge test --coverage
 
 This will generate a coverage report in the `coverage` directory named `coverage.lcov`.
 
+## Passing arguments to `cairo-coverage`
+
+You can pass additional arguments to `cairo-coverage`:
+
+```shell
+$ snforge test --coverage --include macros
+```
+
+If the flag name duplicates a flag from `snforge`, you can use the `--` separator:
+
+```shell
+$ snforge test --coverage -- --help
+```
+
+> 📝 **Note**
+> 
+> Running `snforge test --help` won't show info about `cairo-coverage` flags. To see them, run `snforge test --coverage -- --help`.
+
 ## Coverage report
 
 `cairo-coverage` generates coverage data as an `.lcov` file. A summary report with aggregated data can be produced by one of many tools that accept the `lcov` format.