qapi: Add a primitive to include other files from a QAPI schema file

The primitive uses JSON syntax, and include paths are relative to the file using the directive:

  { 'include': 'path/to/file.json' }

Signed-off-by: Lluís Vilanova <vilanova@ac.upc.edu>
Reviewed-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Luiz Capitulino <lcapitulino@redhat.com>

tests/qapi-schema/include-before-err.err

@@ -0,0 +1 @@
+tests/qapi-schema/include-before-err.json:2:13: Expected ":"

tests/qapi-schema/include-before-err.exit

@@ -0,0 +1 @@
+1

tests/qapi-schema/include-before-err.json

@@ -0,0 +1,2 @@
+{ 'include': 'include-simple-sub.json' }
+{ 'command' 'missing-colon' }

tests/qapi-schema/include-cycle-b.json

@@ -0,0 +1 @@
+{ 'include': 'include-cycle-c.json' }

tests/qapi-schema/include-cycle-c.json

@@ -0,0 +1 @@
+{ 'include': 'include-cycle.json' }

tests/qapi-schema/include-cycle.err

@@ -0,0 +1,3 @@
+In file included from tests/qapi-schema/include-cycle.json:1:
+In file included from include-cycle-b.json:1:
+include-cycle-c.json:1: Inclusion loop for include-cycle.json

tests/qapi-schema/include-cycle.exit

@@ -0,0 +1 @@
+1

tests/qapi-schema/include-cycle.json

@@ -0,0 +1 @@
+{ 'include': 'include-cycle-b.json' }

tests/qapi-schema/include-format-err.err

@@ -0,0 +1 @@
+tests/qapi-schema/include-format-err.json:1: Invalid 'include' directive

tests/qapi-schema/include-format-err.exit

@@ -0,0 +1 @@
+1

tests/qapi-schema/include-format-err.json

@@ -0,0 +1,2 @@
+{ 'include': 'include-simple-sub.json',
+  'foo': 'bar' }

tests/qapi-schema/include-nested-err.err

@@ -0,0 +1,2 @@
+In file included from tests/qapi-schema/include-nested-err.json:1:
+missing-colon.json:1:10: Expected ":"

tests/qapi-schema/include-nested-err.exit

@@ -0,0 +1 @@
+1

tests/qapi-schema/include-nested-err.json

@@ -0,0 +1 @@
+{ 'include': 'missing-colon.json' }

tests/qapi-schema/include-no-file.err

@@ -0,0 +1 @@
+tests/qapi-schema/include-no-file.json:1: No such file or directory: include-no-file-sub.json

tests/qapi-schema/include-no-file.exit

@@ -0,0 +1 @@
+1

tests/qapi-schema/include-no-file.json

@@ -0,0 +1 @@
+{ 'include': 'include-no-file-sub.json' }

tests/qapi-schema/include-non-file.err

@@ -0,0 +1 @@
+tests/qapi-schema/include-non-file.json:1: Expected a file name (string), got: ['foo', 'bar']

tests/qapi-schema/include-non-file.exit

@@ -0,0 +1 @@
+1

tests/qapi-schema/include-non-file.json

@@ -0,0 +1 @@
+{ 'include': [ 'foo', 'bar' ] }

tests/qapi-schema/include-relpath-sub.json

@@ -0,0 +1,2 @@
+{ 'enum': 'Status',
+  'data': [ 'good', 'bad', 'ugly' ] }

tests/qapi-schema/include-relpath.exit

@@ -0,0 +1 @@
+0

tests/qapi-schema/include-relpath.json

@@ -0,0 +1 @@
+{ 'include': 'include/relpath.json' }

tests/qapi-schema/include-relpath.out

@@ -0,0 +1,3 @@
+[OrderedDict([('enum', 'Status'), ('data', ['good', 'bad', 'ugly'])])]
+[{'enum_name': 'Status', 'enum_values': ['good', 'bad', 'ugly']}]
+[]

tests/qapi-schema/include-self-cycle.err

@@ -0,0 +1 @@
+tests/qapi-schema/include-self-cycle.json:1: Inclusion loop for include-self-cycle.json

tests/qapi-schema/include-self-cycle.exit

@@ -0,0 +1 @@
+1

tests/qapi-schema/include-self-cycle.json

@@ -0,0 +1 @@
+{ 'include': 'include-self-cycle.json' }

tests/qapi-schema/include-simple-sub.json

@@ -0,0 +1,2 @@
+{ 'enum': 'Status',
+  'data': [ 'good', 'bad', 'ugly' ] }

tests/qapi-schema/include-simple.exit

@@ -0,0 +1 @@
+0

tests/qapi-schema/include-simple.json

@@ -0,0 +1 @@
+{ 'include': 'include-simple-sub.json' }

tests/qapi-schema/include-simple.out

@@ -0,0 +1,3 @@
+[OrderedDict([('enum', 'Status'), ('data', ['good', 'bad', 'ugly'])])]
+[{'enum_name': 'Status', 'enum_values': ['good', 'bad', 'ugly']}]
+[]

tests/qapi-schema/include/relpath.json

@@ -0,0 +1 @@
+{ 'include': '../include-relpath-sub.json' }