1# *-*- Mode: Python -*-*
2
3# This file is a stress test of supported qapi constructs that must
4# parse and compile correctly.
5
6# Whitelists to permit QAPI rule violations
7{ 'pragma': {
8    # Commands allowed to return a non-dictionary:
9    'returns-whitelist': [
10        'guest-get-time',
11        'guest-sync' ] } }
12
13{ 'struct': 'TestStruct',
14  'data': { 'integer': {'type': 'int'}, 'boolean': 'bool', 'string': 'str' } }
15
16# for testing enums
17{ 'struct': 'NestedEnumsOne',
18  'data': { 'enum1': 'EnumOne',   # Intentional forward reference
19            '*enum2': 'EnumOne', 'enum3': 'EnumOne', '*enum4': 'EnumOne' } }
20
21# An empty enum, although unusual, is currently acceptable
22{ 'enum': 'MyEnum', 'data': [ ] }
23
24# Likewise for an empty struct, including an empty base
25{ 'struct': 'Empty1', 'data': { } }
26{ 'struct': 'Empty2', 'base': 'Empty1', 'data': { } }
27
28{ 'command': 'user_def_cmd0', 'data': 'Empty2', 'returns': 'Empty2' }
29
30# for testing override of default naming heuristic
31{ 'enum': 'QEnumTwo',
32  'prefix': 'QENUM_TWO',
33  'data': [ 'value1', 'value2' ] }
34
35# for testing nested structs
36{ 'struct': 'UserDefOne',
37  'base': 'UserDefZero',        # intentional forward reference
38  'data': { 'string': 'str',
39            '*enum1': 'EnumOne' } }   # intentional forward reference
40
41{ 'enum': 'EnumOne',
42  'data': [ 'value1', 'value2', 'value3', 'value4' ] }
43
44{ 'struct': 'UserDefZero',
45  'data': { 'integer': 'int' } }
46
47{ 'struct': 'UserDefTwoDictDict',
48  'data': { 'userdef': 'UserDefOne', 'string': 'str' } }
49
50{ 'struct': 'UserDefTwoDict',
51  'data': { 'string1': 'str',
52            'dict2': 'UserDefTwoDictDict',
53            '*dict3': 'UserDefTwoDictDict' } }
54
55{ 'struct': 'UserDefTwo',
56  'data': { 'string0': 'str',
57            'dict1': 'UserDefTwoDict' } }
58
59{ 'struct': 'UserDefThree',
60  'data': { 'string0': 'str' } }
61
62# dummy struct to force generation of array types not otherwise mentioned
63{ 'struct': 'ForceArrays',
64  'data': { 'unused1':['UserDefOne'], 'unused2':['UserDefTwo'],
65            'unused3':['TestStruct'] } }
66
67# for testing unions
68# Among other things, test that a name collision between branches does
69# not cause any problems (since only one branch can be in use at a time),
70# by intentionally using two branches that both have a C member 'a_b'
71{ 'struct': 'UserDefA',
72  'data': { 'boolean': 'bool', '*a_b': 'int' } }
73
74{ 'struct': 'UserDefB',
75  'data': { 'intb': 'int', '*a-b': 'bool' } }
76
77{ 'union': 'UserDefFlatUnion',
78  'base': 'UserDefUnionBase',   # intentional forward reference
79  'discriminator': 'enum1',
80  'data': { 'value1' : {'type': 'UserDefA'},
81            'value2' : 'UserDefB',
82            'value3' : 'UserDefB'
83            # 'value4' defaults to empty
84  } }
85
86{ 'struct': 'UserDefUnionBase',
87  'base': 'UserDefZero',
88  'data': { 'string': 'str', 'enum1': 'EnumOne' } }
89
90# this variant of UserDefFlatUnion defaults to a union that uses members with
91# allocated types to test corner cases in the cleanup/dealloc visitor
92{ 'union': 'UserDefFlatUnion2',
93  'base': { '*integer': 'int', 'string': 'str', 'enum1': 'QEnumTwo' },
94  'discriminator': 'enum1',
95  'data': { 'value1' : 'UserDefC', # intentional forward reference
96            'value2' : 'UserDefB' } }
97
98{ 'struct': 'WrapAlternate',
99  'data': { 'alt': 'UserDefAlternate' } }
100{ 'alternate': 'UserDefAlternate',
101  'data': { 'udfu': {'type': 'UserDefFlatUnion'}, 'e': 'EnumOne', 'i': 'int',
102            'n': 'null' } }
103
104{ 'struct': 'UserDefC',
105  'data': { 'string1': 'str', 'string2': 'str' } }
106
107# for testing use of 'number' within alternates
108{ 'alternate': 'AltEnumBool', 'data': { 'e': 'EnumOne', 'b': 'bool' } }
109{ 'alternate': 'AltEnumNum', 'data': { 'e': 'EnumOne', 'n': 'number' } }
110{ 'alternate': 'AltNumEnum', 'data': { 'n': 'number', 'e': 'EnumOne' } }
111{ 'alternate': 'AltEnumInt', 'data': { 'e': 'EnumOne', 'i': 'int' } }
112
113# for testing use of 'str' within alternates
114{ 'alternate': 'AltStrObj', 'data': { 's': 'str', 'o': 'TestStruct' } }
115
116# for testing native lists
117{ 'union': 'UserDefNativeListUnion',
118  'data': { 'integer': ['int'],
119            's8': ['int8'],
120            's16': ['int16'],
121            's32': ['int32'],
122            's64': ['int64'],
123            'u8': ['uint8'],
124            'u16': ['uint16'],
125            'u32': ['uint32'],
126            'u64': ['uint64'],
127            'number': ['number'],
128            'boolean': ['bool'],
129            'string': ['str'],
130            'sizes': ['size'],
131            'any': ['any'] } }
132
133# for testing sub-modules
134{ 'include': 'include/sub-module.json' }
135
136# testing commands
137{ 'command': 'user_def_cmd', 'data': {} }
138{ 'command': 'user_def_cmd1', 'data': {'ud1a': 'UserDefOne'} }
139{ 'command': 'user_def_cmd2',
140  'data': {'ud1a': {'type': 'UserDefOne'}, '*ud1b': 'UserDefOne'},
141  'returns': 'UserDefTwo' }
142
143{ 'command': 'cmd-success-response', 'data': {}, 'success-response': false }
144
145# Returning a non-dictionary requires a name from the whitelist
146{ 'command': 'guest-get-time', 'data': {'a': 'int', '*b': 'int' },
147  'returns': 'int' }
148{ 'command': 'guest-sync', 'data': { 'arg': 'any' }, 'returns': 'any' }
149{ 'command': 'boxed-struct', 'boxed': true, 'data': 'UserDefZero' }
150{ 'command': 'boxed-union', 'data': 'UserDefNativeListUnion', 'boxed': true }
151
152# Smoke test on out-of-band and allow-preconfig-test
153{ 'command': 'test-flags-command', 'allow-oob': true, 'allow-preconfig': true }
154
155# For testing integer range flattening in opts-visitor. The following schema
156# corresponds to the option format:
157#
158# -userdef i64=3-6,i64=-5--1,u64=2,u16=1,u16=7-12
159#
160# For simplicity, this example doesn't use [type=]discriminator nor optargs
161# specific to discriminator values.
162{ 'struct': 'UserDefOptions',
163  'data': {
164    '*i64' : [ 'int'    ],
165    '*u64' : [ 'uint64' ],
166    '*u16' : [ 'uint16' ],
167    '*i64x':   'int'     ,
168    '*u64x':   'uint64'  } }
169
170# testing event
171{ 'struct': 'EventStructOne',
172  'data': { 'struct1': {'type': 'UserDefOne'}, 'string': 'str', '*enum2': 'EnumOne' } }
173
174{ 'event': 'EVENT_A' }
175{ 'event': 'EVENT_B',
176  'data': { } }
177{ 'event': 'EVENT_C',
178  'data': { '*a': 'int', '*b': 'UserDefOne', 'c': 'str' } }
179{ 'event': 'EVENT_D',
180  'data': { 'a' : 'EventStructOne', 'b' : 'str', '*c': 'str', '*enum3': 'EnumOne' } }
181{ 'event': 'EVENT_E', 'boxed': true, 'data': 'UserDefZero' }
182{ 'event': 'EVENT_F', 'boxed': true, 'data': 'UserDefAlternate' }
183
184# test that we correctly compile downstream extensions, as well as munge
185# ticklish names
186{ 'enum': '__org.qemu_x-Enum', 'data': [ '__org.qemu_x-value' ] }
187{ 'struct': '__org.qemu_x-Base',
188  'data': { '__org.qemu_x-member1': '__org.qemu_x-Enum' } }
189{ 'struct': '__org.qemu_x-Struct', 'base': '__org.qemu_x-Base',
190  'data': { '__org.qemu_x-member2': 'str', '*wchar-t': 'int' } }
191{ 'union': '__org.qemu_x-Union1', 'data': { '__org.qemu_x-branch': 'str' } }
192{ 'struct': '__org.qemu_x-Struct2',
193  'data': { 'array': ['__org.qemu_x-Union1'] } }
194{ 'union': '__org.qemu_x-Union2', 'base': '__org.qemu_x-Base',
195  'discriminator': '__org.qemu_x-member1',
196  'data': { '__org.qemu_x-value': '__org.qemu_x-Struct2' } }
197{ 'alternate': '__org.qemu_x-Alt',
198  'data': { '__org.qemu_x-branch': 'str', 'b': '__org.qemu_x-Base' } }
199{ 'event': '__ORG.QEMU_X-EVENT', 'data': '__org.qemu_x-Struct' }
200{ 'command': '__org.qemu_x-command',
201  'data': { 'a': ['__org.qemu_x-Enum'], 'b': ['__org.qemu_x-Struct'],
202            'c': '__org.qemu_x-Union2', 'd': '__org.qemu_x-Alt' },
203  'returns': '__org.qemu_x-Union1' }
204
205# test 'if' condition handling
206
207{ 'struct': 'TestIfStruct', 'data':
208  { 'foo': 'int',
209    'bar': { 'type': 'int', 'if': 'defined(TEST_IF_STRUCT_BAR)'} },
210  'if': 'defined(TEST_IF_STRUCT)' }
211
212{ 'enum': 'TestIfEnum', 'data':
213  [ 'foo', { 'name' : 'bar', 'if': 'defined(TEST_IF_ENUM_BAR)' } ],
214  'if': 'defined(TEST_IF_ENUM)' }
215
216{ 'union': 'TestIfUnion', 'data':
217  { 'foo': 'TestStruct',
218    'union_bar': { 'type': 'str', 'if': 'defined(TEST_IF_UNION_BAR)'} },
219  'if': 'defined(TEST_IF_UNION) && defined(TEST_IF_STRUCT)' }
220
221{ 'command': 'TestIfUnionCmd', 'data': { 'union_cmd_arg': 'TestIfUnion' },
222  'if': 'defined(TEST_IF_UNION)' }
223
224{ 'alternate': 'TestIfAlternate', 'data':
225  { 'foo': 'int',
226    'bar': { 'type': 'TestStruct', 'if': 'defined(TEST_IF_ALT_BAR)'} },
227  'if': 'defined(TEST_IF_ALT) && defined(TEST_IF_STRUCT)' }
228
229{ 'command': 'TestIfAlternateCmd', 'data': { 'alt_cmd_arg': 'TestIfAlternate' },
230  'if': 'defined(TEST_IF_ALT)' }
231
232{ 'command': 'TestIfCmd', 'data':
233  { 'foo': 'TestIfStruct',
234    'bar': { 'type': 'TestIfEnum', 'if': 'defined(TEST_IF_CMD_BAR)' } },
235  'returns': 'UserDefThree',
236  'if': ['defined(TEST_IF_CMD)', 'defined(TEST_IF_STRUCT)'] }
237
238{ 'command': 'TestCmdReturnDefThree', 'returns': 'UserDefThree' }
239
240{ 'event': 'TestIfEvent', 'data':
241  { 'foo': 'TestIfStruct',
242    'bar': { 'type': ['TestIfEnum'], 'if': 'defined(TEST_IF_EVT_BAR)' } },
243  'if': 'defined(TEST_IF_EVT) && defined(TEST_IF_STRUCT)' }
244