aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2023-07-19 01:09:09 +0200
committerEgor Tensin <Egor.Tensin@gmail.com>2023-07-19 01:14:12 +0200
commit62c00e34fc70a0d1a311d929015f2ee0ce7f8743 (patch)
treef8f64d4d9566eb87dc659315cdc01738ff146f2b
parentworkflows/ci: restructure job dependencies (diff)
downloadcimple-62c00e34fc70a0d1a311d929015f2ee0ce7f8743.tar.gz
cimple-62c00e34fc70a0d1a311d929015f2ee0ce7f8743.zip
README: update
-rw-r--r--README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
index 42fbe2f..5df79ad 100644
--- a/README.md
+++ b/README.md
@@ -30,6 +30,36 @@ After building, you can run the "test suite" (depends on Pytest).
make test
+### Code coverage
+
+You can generate a code coverage report (depends on `gcovr`) in
+build/coverage/:
+
+ make coverage
+
+The latest code coverage report for the `master` branch can be found at
+https://egor-tensin.github.io/cimple/coverage/.
+
+### Flame graphs
+
+Some performance analysis can be done by looking at flame graphs.
+Generate them after building the project (depends on `perf` & [FlameGraph]):
+
+ make test/perf
+
+[FlameGraph]: https://github.com/brendangregg/FlameGraph
+
+This will generate two flame graphs in build/flame_graphs/; they stress
+slightly different parts of the system:
+
+* [flame_graph_output_simple.svg] for a CI script with short output,
+* [flame_graph_output_long.svg] for a CI script with long output.
+
+[flame_graph_output_simple.svg]: https://egor-tensin.github.io/cimple/flame_graphs/flame_graph_output_simple.svg
+[flame_graph_output_long.svg]: https://egor-tensin.github.io/cimple/flame_graphs/flame_graph_output_long.svg
+
+Follow the links above to view the latest flame graphs for the `master` branch.
+
### Code style
Set up the git pre-commit hook by running `./scripts/setup-hooks.sh`.