test: add an end-to-end fixture for a data-driven generator

This adds a fixture under test-files/template-only-generators/mock-md
that ships its own mock "Markdown-like" generator via an addon-local
`addons-supplemental`: a one-line layout that emits the symbol name,
plus a single escape rule mapping `_` to `\_`.

Author: gennaroprota

CMakeLists.txt

@@ -553,6 +553,44 @@ if (MRDOCS_BUILD_TESTS)
         )
     endforeach ()
 
+    #-------------------------------------------------
+    # Template-only generators
+    #
+    # Fixtures under test-files/template-only-generators/<id> ship an
+    # addon defining their own Handlebars generator. They live outside
+    # test-files/golden-tests so the xml/adoc/html runs do not walk
+    # into them and demand expected files in their own formats.
+    #-------------------------------------------------
+    set(MRDOCS_TEMPLATE_ONLY_ROOT "${PROJECT_SOURCE_DIR}/test-files/template-only-generators")
+    add_test(NAME mrdocs-golden-tests-mock-md
+        COMMAND
+            mrdocs-test
+            --unit=false
+            --action=test
+            "${MRDOCS_TEMPLATE_ONLY_ROOT}/mock-md"
+            "--addons=${CMAKE_SOURCE_DIR}/share/mrdocs/addons"
+            --generator=mock-md
+            "--stdlib-includes=${LIBCXX_DIR}"
+            "--libc-includes=${CMAKE_SOURCE_DIR}/share/mrdocs/headers/libc-stubs"
+            --log-level=warn
+    )
+    foreach (action IN ITEMS test create update)
+        add_custom_target(
+            mrdocs-${action}-test-fixtures-mock-md
+            COMMAND
+                mrdocs-test
+                --unit=false
+                --action=${action}
+                "${MRDOCS_TEMPLATE_ONLY_ROOT}/mock-md"
+                "--addons=${CMAKE_SOURCE_DIR}/share/mrdocs/addons"
+                --generator=mock-md
+                "--stdlib-includes=${LIBCXX_DIR}"
+                "--libc-includes=${CMAKE_SOURCE_DIR}/share/mrdocs/headers/libc-stubs"
+                --log-level=warn
+            DEPENDS mrdocs-test
+        )
+    endforeach ()
+
     #-------------------------------------------------
     # Self-documentation test (warn-as-error toggled by strict flag)
     #-------------------------------------------------

test-files/template-only-generators/mock-md/addons/generator/mock-md/layouts/index.mock-md.hbs

@@ -0,0 +1 @@
+{{symbol.name}}: {{#each symbol.doc.brief.children}}{{literal}}{{/each}}

test-files/template-only-generators/mock-md/addons/generator/mock-md/layouts/wrapper.mock-md.hbs

@@ -0,0 +1 @@
+{{{contents}}}

test-files/template-only-generators/mock-md/addons/generator/mock-md/mrdocs-generator.yml

@@ -0,0 +1,3 @@
+escape:
+  '_': '\_'
+  'TODO': '[!]'

test-files/template-only-generators/mock-md/mrdocs.yml

@@ -0,0 +1,7 @@
+addons-supplemental:
+  - addons
+generator: mock-md
+multipage: false
+show-namespaces: false
+warn-if-undocumented: false
+source-root: .

test-files/template-only-generators/mock-md/simple.cpp

@@ -0,0 +1,8 @@
+// A trivial input that exercises the addon-defined mock-md generator.
+// The function name contains an underscore so the single-byte escape
+// rule '_' -> '\_' fires on it; the doc-comment's brief begins with
+// the literal token TODO so the multi-byte rule 'TODO' -> '[!]' fires
+// there during rendering.
+
+/// TODO write me
+void my_function();

test-files/template-only-generators/mock-md/simple.mock-md

@@ -0,0 +1,2 @@
+my\_function: [!] write me
+