aboutsummaryrefslogtreecommitdiff
path: root/contributing.md
diff options
context:
space:
mode:
authormax-001 <maxsmits21@kpnmail.nl>2024-11-21 09:46:06 +0100
committermax-001 <maxsmits21@kpnmail.nl>2024-11-21 09:46:06 +0100
commit7588439db08a671764345764eb05bcb853a90d76 (patch)
tree6847d8aa1b1b911dde55d529330c7144c6fafbf0 /contributing.md
parentba3b97467ffa9df03d74e87bd567e3dfc521df05 (diff)
parent1cc120a0031cfc19c35240da8390d9129b4d75a3 (diff)
Merge remote-tracking branch 'origin/master' into max/doxygen
Diffstat (limited to 'contributing.md')
-rw-r--r--contributing.md23
1 files changed, 22 insertions, 1 deletions
diff --git a/contributing.md b/contributing.md
index 5b0c79d..9c95851 100644
--- a/contributing.md
+++ b/contributing.md
@@ -20,7 +20,7 @@ that you can click on to open them.
# Code style
- Formatting nitty-gritty is handled by clang-format/clang-tidy (run `make
- format` in the root folder of this repository to format all sources files)
+ format` or `make lint`)
- <details><summary>
ASCII only
</summary><table><tr><th>Good</th><th>Bad</th></tr><tr><td>
@@ -798,6 +798,27 @@ that you can click on to open them.
resolving merge conflicts when multiple sources were added by different
people to the same CMakeLists.txt easier.
+## GoogleTest-specific
+
+- Unit tests are not *required* to follow all code standards
+- <details><summary>
+ Private/protected members may be accessed using preprocessor tricks
+ </summary>
+
+ ```cpp
+ // include unrelated headers before
+
+ #define private public
+ #define protected public
+
+ // headers included after *will* be affected
+ ```
+ </details>
+- Each test source file defines tests within a single test suite (first
+ parameter of `TEST()` / `TEST_F()` macro)
+- Test source files match their suite name (or test fixture name in the case of
+ tests that use a fixture)
+
# Structure
- Files are placed in the appropriate directory: