Pass full pre-extraction code to transforms as snippet['full-code']

When json-path is used, transforms can now access the full source document
via ctx.snippet['full-code'] alongside the extracted input_data. Warn when
multiple matches are found. Strip full-code before json-full output.

Author: avillar

ogc/bblocks/models.py

@@ -239,6 +239,10 @@ def _load_examples(self):
                             logger.warning('json-path %s found no matches in ref %s - skipping snippet',
                                            snippet['json-path'], ref)
                             continue
+                        if len(matches) > 1:
+                            logger.warning('json-path %s found %d matches in ref %s - using first match only',
+                                           snippet['json-path'], len(matches), ref)
+                        snippet['full-code'] = code
                         snippet['code'] = dumper(matches[0].value)
                 filtered_snippets.append(snippet)
             if 'snippets' in example:

ogc/bblocks/templates/json-full/index.json

@@ -8,7 +8,12 @@ output = {**bblock.metadata}
 if bblock.description:
     output['description'] = bblock.description
 if bblock.examples:
-    output['examples'] = bblock.examples
+    output['examples'] = [
+        {**example, 'snippets': [{k: v for k, v in s.items() if k != 'full-code'}
+                                  for s in example.get('snippets', [])]}
+        if 'snippets' in example else example
+        for example in bblock.examples
+    ]
 if bblock.example_prefixes:
     output['examplePrefixes'] = bblock.example_prefixes
 if bblock.annotated_schema: