test: define default clang args for testing

test/cpp/template.yaml

@@ -3,7 +3,4 @@ directives:
   directive: autodoc
   arguments:
   - template.cpp
-  options:
-    clang:
-    - --std=c++17
 expected: template.rst

test/testenv.py

@@ -30,21 +30,37 @@ def get_input_filename(self):
 
         return self.testcase.get_relative_filename(basename)
 
-    def get_directive_string(self):
+    def get_directive_string(self, example=False):
         arguments_str = ' '.join(self.arguments)
         directive_str = f'.. {self.domain}:{self.directive}:: {arguments_str}\n'
 
-        for key, value in self.options.items():
+        if example:
+            # Use the options verbatim in documenting the examples.
+            options = self.options
+        else:
+            # Insert the default clang args for testing.
+            options = self.options.copy()
+            options['clang'] = self.get_clang_args()
+
+        for key, value in options.items():
             if isinstance(value, list):
                 value = ', '.join(value)
             space = ' ' if len(value) else ''
             directive_str += f'   :{key}:{space}{value}\n'
 
         return directive_str
 
+    def _get_default_clang_args(self):
+        if self.domain == 'c':
+            return ['-std=c17']
+        else:
+            return ['-std=c++17']
+
     def get_clang_args(self):
         clang_args = []
 
+        clang_args.extend(self._get_default_clang_args())
+
         clang_args.extend(self.options.get('clang', []))
 
         return clang_args

test/update-examples.py

@@ -85,7 +85,7 @@ def print_example(testcase):
         namespace_push = ''
         namespace_pop = ''
 
-    directive_str = testcase.directives[0].get_directive_string()
+    directive_str = testcase.directives[0].get_directive_string(example=True)
 
     print(f'''Directive
 ~~~~~~~~~