Add 'examples' subdir where needed

Author: Bronek

.codecov.yml

@@ -36,3 +36,4 @@ parsers:
 
 ignore:
   - "tests/"
+  - "examples/"

.fossa.yml

@@ -7,4 +7,5 @@ vendoredDependencies:
     exclude:
       - ".git/**"
       - "tests/**"
+      - "examples/**"
       - "ci/**"

.github/workflows/build.yml

@@ -8,6 +8,7 @@ on:
       - '.github/workflows/build.yml'
       - 'include/**'
       - 'tests/**'
+      - 'examples/**'
       - 'CMakeLists.txt'
       - 'cmake/**'
       - 'nix/**'
@@ -20,6 +21,7 @@ on:
       - '.github/workflows/build.yml'
       - 'include/**'
       - 'tests/**'
+      - 'examples/**'
       - 'CMakeLists.txt'
       - 'cmake/**'
       - 'nix/**'

.github/workflows/coverage.yml

@@ -16,6 +16,8 @@ on:
       - '.codecov.yml'
   workflow_dispatch:
 
+  # examples/** not included in coverage paths intentionally, see also .codecov.yml
+
 jobs:
   coverage:
     runs-on:

.github/workflows/docs.yml

@@ -9,6 +9,7 @@ on:
       - 'docs/**'
       - 'include/**'
       - 'tests/**'
+      - 'examples/**'
       - 'CMakeLists.txt'
       - 'cmake/**'
       - '*.md'

.github/workflows/licence.yml

@@ -8,6 +8,7 @@ on:
       - '.github/workflows/licence.yml'
       - 'include/**'
       - 'tests/**'
+      - 'examples/**'
       - 'CMakeLists.txt'
       - 'cmake/**'
       - '.fossa.yml'
@@ -19,6 +20,7 @@ on:
       - '.github/workflows/licence.yml'
       - 'include/**'
       - 'tests/**'
+      - 'examples/**'
       - 'CMakeLists.txt'
       - 'cmake/**'
       - '.fossa.yml'

cmake/Coverage.cmake

@@ -21,7 +21,7 @@ setup_target_for_coverage_gcovr(
     FORMAT ${CODE_COVERAGE_FORMAT}
     EXECUTABLE ${CODE_COVERAGE_TEST}
     EXECUTABLE_ARGS ${CODE_COVERAGE_TEST_ARGS}
-    EXCLUDE "tests"
+    EXCLUDE "tests" "examples"
     DEPENDENCIES all
 )
 

docs/choice/and_then.md

@@ -23,6 +23,6 @@ A monadic type of the same kind.
 ## Examples {style: "api"}
 
 :include-template: templates/snippet.md {
-    path:  "examples/simple.cpp",
+    path:  "simple/main.cpp",
     surroundedBy: ["// example-choice-parse", "// example-choice-checks"]
 }

docs/expected/and_then.md

@@ -23,13 +23,13 @@ A monadic type of the same kind.
 ## Examples {style: "api"}
 
 :include-template: templates/snippet.md {
-    path:  "examples/simple.cpp",
+    path:  "simple/main.cpp",
     surroundedBy: ["// example-error-struct", "// example-expected-and_then-value"],
     desc:  "The resulting value is `13` because `ex` does not contain an `Error` and therefore `and_then` is called."
 }
 
 :include-template: templates/snippet.md {
-    path:  "examples/simple.cpp",
+    path:  "simple/main.cpp",
     surroundedBy: ["// example-error-struct", "// example-expected-and_then-error"],
     desc:  "The result is an `Error` because `ex` already contained an `Error` and therefore `and_then` is not called."
 }

docs/expected/discard.md

@@ -23,7 +23,7 @@ void
 ## Examples {style: "api"}
 
 :include-template: templates/snippet.md {
-    path:  "examples/simple.cpp",
+    path:  "simple/main.cpp",
     surroundedBy: ["// example-error-struct", "// example-expected-discard"],
     desc:  "`42` is observed by `inspect` and the value is discarded by `discard` (no warning for discarded result of `inspect`)."
 }