blob: 26a348f3910454374adb49177ef65879c078363c [file] [log] [blame]
Ole Troandf87f802020-11-18 19:17:48 +01001#
2# Copyright (c) 2020 Cisco and/or its affiliates.
3# Licensed under the Apache License, Version 2.0 (the "License");
4# you may not use this file except in compliance with the License.
5# You may obtain a copy of the License at:
6#
7# http://www.apache.org/licenses/LICENSE-2.0
8#
9# Unless required by applicable law or agreed to in writing, software
10# distributed under the License is distributed on an "AS IS" BASIS,
11# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12# See the License for the specific language governing permissions and
13# limitations under the License.
14#
15
16#
17# Provide two classes FromJSON and TOJSON that converts between JSON and VPP's
18# binary API format
19#
20
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020021"""
Ole Troandf87f802020-11-18 19:17:48 +010022This module creates C code for core VPP, VPP plugins and client side VAT and
23VAT2 tests.
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020024"""
Ole Troandf87f802020-11-18 19:17:48 +010025
Ole Troan9d420872017-10-12 13:06:35 +020026import datetime
Klement Sekera0eb83f42021-12-02 16:36:34 +000027import itertools
Ole Troan9d420872017-10-12 13:06:35 +020028import os
Nirmoy Dasc9f40222018-06-28 10:18:43 +020029import time
Ole Troan33a58172019-09-04 09:12:29 +020030import sys
31from io import StringIO
Ole Troan2a1ca782019-09-19 01:08:30 +020032import shutil
Ole Troan9d420872017-10-12 13:06:35 +020033
Paul Vinciguerra9046e442020-11-20 23:10:09 -050034process_imports = False
35
Paul Vinciguerraa51f9b32020-11-24 23:26:06 -050036
Ole Troandf87f802020-11-18 19:17:48 +010037###############################################################################
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020038class ToJSON:
39 """Class to generate functions converting from VPP binary API to JSON."""
40
Ole Troandf87f802020-11-18 19:17:48 +010041 _dispatch = {}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020042 noprint_fields = {"_vl_msg_id": None, "client_index": None, "context": None}
43 is_number = {
44 "u8": None,
45 "i8": None,
46 "u16": None,
47 "i16": None,
48 "u32": None,
49 "i32": None,
50 "u64": None,
51 "i64": None,
52 "f64": None,
53 }
Ole Troandf87f802020-11-18 19:17:48 +010054
55 def __init__(self, module, types, defines, imported_types, stream):
56 self.stream = stream
57 self.module = module
58 self.defines = defines
59 self.types = types
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020060 self.types_hash = {"vl_api_" + d.name + "_t": d for d in types + imported_types}
Ole Troandf87f802020-11-18 19:17:48 +010061 self.defines_hash = {d.name: d for d in defines}
62
63 def header(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020064 """Output the top boilerplate."""
Ole Troandf87f802020-11-18 19:17:48 +010065 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020066 write("#ifndef included_{}_api_tojson_h\n".format(self.module))
67 write("#define included_{}_api_tojson_h\n".format(self.module))
68 write("#include <vppinfra/cJSON.h>\n\n")
69 write("#include <vppinfra/jsonformat.h>\n\n")
70 if self.module == "interface_types":
71 write("#define vl_printfun\n")
72 write("#include <vnet/interface_types.api.h>\n\n")
Ole Troandf87f802020-11-18 19:17:48 +010073
74 def footer(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020075 """Output the bottom boilerplate."""
Ole Troandf87f802020-11-18 19:17:48 +010076 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020077 write("#endif\n")
Ole Troandf87f802020-11-18 19:17:48 +010078
Ole Troan18327be2021-01-12 21:49:38 +010079 def get_base_type(self, t):
Ole Troandf87f802020-11-18 19:17:48 +010080 vt_type = None
81 try:
82 vt = self.types_hash[t]
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020083 if vt.type == "Using" and "length" not in vt.alias:
84 vt_type = vt.alias["type"]
Ole Troandf87f802020-11-18 19:17:48 +010085 except KeyError:
86 vt = t
Ole Troan18327be2021-01-12 21:49:38 +010087 return vt, vt_type
88
89 def get_json_func(self, t):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020090 """Given the type, returns the function to use to create a
91 cJSON object"""
Ole Troan18327be2021-01-12 21:49:38 +010092 vt, vt_type = self.get_base_type(t)
Ole Troandf87f802020-11-18 19:17:48 +010093
94 if t in self.is_number or vt_type in self.is_number:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +020095 return "cJSON_AddNumberToObject", "", False
96 if t == "bool":
97 return "cJSON_AddBoolToObject", "", False
Ole Troandf87f802020-11-18 19:17:48 +010098
99 # Lookup type name check if it's enum
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200100 if vt.type == "Enum" or vt.type == "EnumFlag":
101 return "{t}_tojson".format(t=t), "", True
102 return "{t}_tojson".format(t=t), "&", True
Ole Troandf87f802020-11-18 19:17:48 +0100103
104 def get_json_array_func(self, t):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200105 """Given a type returns the function to create a cJSON object
106 for arrays."""
Ole Troandf87f802020-11-18 19:17:48 +0100107 if t in self.is_number:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200108 return "cJSON_CreateNumber", ""
109 if t == "bool":
110 return "cJSON_CreateBool", ""
Ole Troan18327be2021-01-12 21:49:38 +0100111 vt, vt_type = self.get_base_type(t)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200112 if vt.type == "Enum" or vt.type == "EnumFlag":
113 return "{t}_tojson".format(t=t), ""
114 return "{t}_tojson".format(t=t), "&"
Ole Troandf87f802020-11-18 19:17:48 +0100115
116 def print_string(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200117 """Create cJSON object from vl_api_string_t"""
Ole Troandf87f802020-11-18 19:17:48 +0100118 write = self.stream.write
119 if o.modern_vla:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200120 write(
121 ' vl_api_string_cJSON_AddToObject(o, "{n}", &a->{n});\n'.format(
122 n=o.fieldname
123 )
124 )
Ole Troandf87f802020-11-18 19:17:48 +0100125 else:
126
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200127 write(
128 ' cJSON_AddStringToObject(o, "{n}", (char *)a->{n});\n'.format(
129 n=o.fieldname
130 )
131 )
Ole Troandf87f802020-11-18 19:17:48 +0100132
133 def print_field(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200134 """Called for every field in a typedef or define."""
Ole Troandf87f802020-11-18 19:17:48 +0100135 write = self.stream.write
136 if o.fieldname in self.noprint_fields:
137 return
138
139 f, p, newobj = self.get_json_func(o.fieldtype)
140
141 if newobj:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200142 write(
143 ' cJSON_AddItemToObject(o, "{n}", {f}({p}a->{n}));\n'.format(
144 f=f, p=p, n=o.fieldname
145 )
146 )
Ole Troandf87f802020-11-18 19:17:48 +0100147 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200148 write(' {f}(o, "{n}", {p}a->{n});\n'.format(f=f, p=p, n=o.fieldname))
Ole Troandf87f802020-11-18 19:17:48 +0100149
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200150 _dispatch["Field"] = print_field
Ole Troandf87f802020-11-18 19:17:48 +0100151
152 def print_array(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200153 """Converts a VPP API array to cJSON array."""
Ole Troandf87f802020-11-18 19:17:48 +0100154 write = self.stream.write
155
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200156 forloop = """\
Ole Troandf87f802020-11-18 19:17:48 +0100157 {{
158 int i;
159 cJSON *array = cJSON_AddArrayToObject(o, "{n}");
160 for (i = 0; i < {lfield}; i++) {{
161 cJSON_AddItemToArray(array, {f}({p}a->{n}[i]));
162 }}
163 }}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200164"""
Ole Troandf87f802020-11-18 19:17:48 +0100165
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200166 if o.fieldtype == "string":
Ole Troandf87f802020-11-18 19:17:48 +0100167 self.print_string(o)
168 return
169
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200170 lfield = "a->" + o.lengthfield if o.lengthfield else o.length
171 if o.fieldtype == "u8":
172 write(" {\n")
Ole Troandf87f802020-11-18 19:17:48 +0100173 # What is length field doing here?
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200174 write(
175 ' u8 *s = format(0, "0x%U", format_hex_bytes, '
176 "&a->{n}, {lfield});\n".format(n=o.fieldname, lfield=lfield)
177 )
178 write(
179 ' cJSON_AddStringToObject(o, "{n}", (char *)s);\n'.format(
180 n=o.fieldname
181 )
182 )
183 write(" vec_free(s);\n")
184 write(" }\n")
Ole Troandf87f802020-11-18 19:17:48 +0100185 return
186
187 f, p = self.get_json_array_func(o.fieldtype)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200188 write(forloop.format(lfield=lfield, t=o.fieldtype, n=o.fieldname, f=f, p=p))
Ole Troandf87f802020-11-18 19:17:48 +0100189
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200190 _dispatch["Array"] = print_array
Ole Troandf87f802020-11-18 19:17:48 +0100191
192 def print_enum(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200193 """Create cJSON object (string) for VPP API enum"""
Ole Troandf87f802020-11-18 19:17:48 +0100194 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200195 write(
196 "static inline cJSON *vl_api_{name}_t_tojson "
197 "(vl_api_{name}_t a) {{\n".format(name=o.name)
198 )
Ole Troandf87f802020-11-18 19:17:48 +0100199
200 write(" switch(a) {\n")
201 for b in o.block:
202 write(" case %s:\n" % b[1])
203 write(' return cJSON_CreateString("{}");\n'.format(b[0]))
204 write(' default: return cJSON_CreateString("Invalid ENUM");\n')
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200205 write(" }\n")
206 write(" return 0;\n")
207 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100208
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200209 _dispatch["Enum"] = print_enum
Ole Troan793be462020-12-04 13:15:30 +0100210
211 def print_enum_flag(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200212 """Create cJSON object (string) for VPP API enum"""
Ole Troan793be462020-12-04 13:15:30 +0100213 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200214 write(
215 "static inline cJSON *vl_api_{name}_t_tojson "
216 "(vl_api_{name}_t a) {{\n".format(name=o.name)
217 )
218 write(" cJSON *array = cJSON_CreateArray();\n")
Ole Troan793be462020-12-04 13:15:30 +0100219
220 for b in o.block:
Ole Troan45517152021-11-23 10:49:36 +0100221 if b[1] == 0:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200222 continue
223 write(" if (a & {})\n".format(b[0]))
Klement Sekera9b7e8ac2021-11-22 21:26:20 +0100224 write(
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200225 ' cJSON_AddItemToArray(array, cJSON_CreateString("{}"));\n'.format(
226 b[0]
227 )
228 )
229 write(" return array;\n")
230 write("}\n")
Ole Troan793be462020-12-04 13:15:30 +0100231
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200232 _dispatch["EnumFlag"] = print_enum_flag
Ole Troandf87f802020-11-18 19:17:48 +0100233
234 def print_typedef(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200235 """Create cJSON (dictionary) object from VPP API typedef"""
Ole Troandf87f802020-11-18 19:17:48 +0100236 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200237 write(
238 "static inline cJSON *vl_api_{name}_t_tojson "
239 "(vl_api_{name}_t *a) {{\n".format(name=o.name)
240 )
241 write(" cJSON *o = cJSON_CreateObject();\n")
Ole Troandf87f802020-11-18 19:17:48 +0100242
243 for t in o.block:
244 self._dispatch[t.type](self, t)
245
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200246 write(" return o;\n")
247 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100248
249 def print_define(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200250 """Create cJSON (dictionary) object from VPP API define"""
Ole Troandf87f802020-11-18 19:17:48 +0100251 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200252 write(
253 "static inline cJSON *vl_api_{name}_t_tojson "
254 "(vl_api_{name}_t *a) {{\n".format(name=o.name)
255 )
256 write(" cJSON *o = cJSON_CreateObject();\n")
257 write(' cJSON_AddStringToObject(o, "_msgname", "{}");\n'.format(o.name))
258 write(
259 ' cJSON_AddStringToObject(o, "_crc", "{crc:08x}");\n'.format(crc=o.crc)
260 )
Ole Troandf87f802020-11-18 19:17:48 +0100261
262 for t in o.block:
263 self._dispatch[t.type](self, t)
264
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200265 write(" return o;\n")
266 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100267
268 def print_using(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200269 """Create cJSON (dictionary) object from VPP API aliased type"""
Ole Troandf87f802020-11-18 19:17:48 +0100270 if o.manual_print:
271 return
272
273 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200274 write(
275 "static inline cJSON *vl_api_{name}_t_tojson "
276 "(vl_api_{name}_t *a) {{\n".format(name=o.name)
277 )
Ole Troandf87f802020-11-18 19:17:48 +0100278
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200279 write(' u8 *s = format(0, "%U", format_vl_api_{}_t, a);\n'.format(o.name))
280 write(" cJSON *o = cJSON_CreateString((char *)s);\n")
281 write(" vec_free(s);\n")
282 write(" return o;\n")
283 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100284
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200285 _dispatch["Typedef"] = print_typedef
286 _dispatch["Define"] = print_define
287 _dispatch["Using"] = print_using
288 _dispatch["Union"] = print_typedef
Ole Troandf87f802020-11-18 19:17:48 +0100289
290 def generate_function(self, t):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200291 """Main entry point"""
Ole Troandf87f802020-11-18 19:17:48 +0100292 write = self.stream.write
293 if t.manual_print:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200294 write("/* Manual print {} */\n".format(t.name))
Ole Troandf87f802020-11-18 19:17:48 +0100295 return
296 self._dispatch[t.type](self, t)
297
298 def generate_types(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200299 """Main entry point"""
Ole Troandf87f802020-11-18 19:17:48 +0100300 for t in self.types:
301 self.generate_function(t)
302
303 def generate_defines(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200304 """Main entry point"""
Ole Troandf87f802020-11-18 19:17:48 +0100305 for t in self.defines:
306 self.generate_function(t)
307
308
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200309class FromJSON:
310 """
Ole Troandf87f802020-11-18 19:17:48 +0100311 Parse JSON objects into VPP API binary message structures.
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200312 """
313
Ole Troandf87f802020-11-18 19:17:48 +0100314 _dispatch = {}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200315 noprint_fields = {"_vl_msg_id": None, "client_index": None, "context": None}
316 is_number = {
317 "u8": None,
318 "i8": None,
319 "u16": None,
320 "i16": None,
321 "u32": None,
322 "i32": None,
323 "u64": None,
324 "i64": None,
325 "f64": None,
326 }
Ole Troandf87f802020-11-18 19:17:48 +0100327
328 def __init__(self, module, types, defines, imported_types, stream):
329 self.stream = stream
330 self.module = module
331 self.defines = defines
332 self.types = types
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200333 self.types_hash = {"vl_api_" + d.name + "_t": d for d in types + imported_types}
Ole Troandf87f802020-11-18 19:17:48 +0100334 self.defines_hash = {d.name: d for d in defines}
335
336 def header(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200337 """Output the top boilerplate."""
Ole Troandf87f802020-11-18 19:17:48 +0100338 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200339 write("#ifndef included_{}_api_fromjson_h\n".format(self.module))
340 write("#define included_{}_api_fromjson_h\n".format(self.module))
341 write("#include <vppinfra/cJSON.h>\n\n")
342 write("#include <vppinfra/jsonformat.h>\n\n")
Ole Troanfb0afab2021-02-11 11:13:46 +0100343 write('#pragma GCC diagnostic ignored "-Wunused-label"\n')
Ole Troandf87f802020-11-18 19:17:48 +0100344
345 def is_base_type(self, t):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200346 """Check if a type is one of the VPP API base types"""
Ole Troandf87f802020-11-18 19:17:48 +0100347 if t in self.is_number:
348 return True
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200349 if t == "bool":
Ole Troandf87f802020-11-18 19:17:48 +0100350 return True
351 return False
352
353 def footer(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200354 """Output the bottom boilerplate."""
Ole Troandf87f802020-11-18 19:17:48 +0100355 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200356 write("#endif\n")
Ole Troandf87f802020-11-18 19:17:48 +0100357
358 def print_string(self, o, toplevel=False):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200359 """Convert JSON string to vl_api_string_t"""
Ole Troandf87f802020-11-18 19:17:48 +0100360 write = self.stream.write
361
Ole Troanfb0afab2021-02-11 11:13:46 +0100362 msgvar = "a" if toplevel else "*mp"
Ole Troandf87f802020-11-18 19:17:48 +0100363 msgsize = "l" if toplevel else "*len"
364
365 if o.modern_vla:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200366 write(" char *p = cJSON_GetStringValue(item);\n")
367 write(" size_t plen = strlen(p);\n")
368 write(
369 " {msgvar} = cJSON_realloc({msgvar}, {msgsize} + plen, {msgsize});\n".format(
370 msgvar=msgvar, msgsize=msgsize
371 )
372 )
373 write(" if ({msgvar} == 0) goto error;\n".format(msgvar=msgvar))
374 write(
375 " vl_api_c_string_to_api_string(p, (void *){msgvar} + "
376 "{msgsize} - sizeof(vl_api_string_t));\n".format(
377 msgvar=msgvar, msgsize=msgsize
378 )
379 )
380 write(" {msgsize} += plen;\n".format(msgsize=msgsize))
Ole Troandf87f802020-11-18 19:17:48 +0100381 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200382 write(
383 " strncpy_s((char *)a->{n}, sizeof(a->{n}), "
384 "cJSON_GetStringValue(item), sizeof(a->{n}) - 1);\n".format(
385 n=o.fieldname
386 )
387 )
Ole Troandf87f802020-11-18 19:17:48 +0100388
389 def print_field(self, o, toplevel=False):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200390 """Called for every field in a typedef or define."""
Ole Troandf87f802020-11-18 19:17:48 +0100391 write = self.stream.write
Ole Troandf87f802020-11-18 19:17:48 +0100392 if o.fieldname in self.noprint_fields:
393 return
394 is_bt = self.is_base_type(o.fieldtype)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200395 t = "vl_api_{}".format(o.fieldtype) if is_bt else o.fieldtype
Ole Troandf87f802020-11-18 19:17:48 +0100396
Ole Troanfb0afab2021-02-11 11:13:46 +0100397 msgvar = "(void **)&a" if toplevel else "mp"
Ole Troandf87f802020-11-18 19:17:48 +0100398 msgsize = "&l" if toplevel else "len"
399
400 if is_bt:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200401 write(
402 " vl_api_{t}_fromjson(item, &a->{n});\n".format(
403 t=o.fieldtype, n=o.fieldname
404 )
405 )
Ole Troandf87f802020-11-18 19:17:48 +0100406 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200407 write(
408 " if ({t}_fromjson({msgvar}, "
409 "{msgsize}, item, &a->{n}) < 0) goto error;\n".format(
410 t=t, n=o.fieldname, msgvar=msgvar, msgsize=msgsize
411 )
412 )
Ole Troandf87f802020-11-18 19:17:48 +0100413
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200414 _dispatch["Field"] = print_field
Ole Troandf87f802020-11-18 19:17:48 +0100415
416 def print_array(self, o, toplevel=False):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200417 """Convert JSON array to VPP API array"""
Ole Troandf87f802020-11-18 19:17:48 +0100418 write = self.stream.write
419
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200420 forloop = """\
Ole Troandf87f802020-11-18 19:17:48 +0100421 {{
422 int i;
423 cJSON *array = cJSON_GetObjectItem(o, "{n}");
424 int size = cJSON_GetArraySize(array);
Ole Troan384c72f2021-02-17 13:46:54 +0100425 if (size != {lfield}) goto error;
Ole Troandf87f802020-11-18 19:17:48 +0100426 for (i = 0; i < size; i++) {{
427 cJSON *e = cJSON_GetArrayItem(array, i);
428 {call}
429 }}
430 }}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200431"""
432 forloop_vla = """\
Ole Troandf87f802020-11-18 19:17:48 +0100433 {{
434 int i;
435 cJSON *array = cJSON_GetObjectItem(o, "{n}");
436 int size = cJSON_GetArraySize(array);
437 {lfield} = size;
Filip Tehlar36217e32021-07-23 08:51:10 +0000438 {realloc} = cJSON_realloc({realloc}, {msgsize} + sizeof({t}) * size, {msgsize});
Ole Troancf0102b2021-02-12 11:48:12 +0100439 {t} *d = (void *){realloc} + {msgsize};
Ole Troandf87f802020-11-18 19:17:48 +0100440 {msgsize} += sizeof({t}) * size;
441 for (i = 0; i < size; i++) {{
442 cJSON *e = cJSON_GetArrayItem(array, i);
443 {call}
444 }}
445 }}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200446"""
Ole Troandf87f802020-11-18 19:17:48 +0100447 t = o.fieldtype
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200448 if o.fieldtype == "string":
Ole Troandf87f802020-11-18 19:17:48 +0100449 self.print_string(o, toplevel)
450 return
451
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200452 lfield = "a->" + o.lengthfield if o.lengthfield else o.length
Ole Troanfb0afab2021-02-11 11:13:46 +0100453 msgvar = "(void **)&a" if toplevel else "mp"
Ole Troancf0102b2021-02-12 11:48:12 +0100454 realloc = "a" if toplevel else "*mp"
Ole Troandf87f802020-11-18 19:17:48 +0100455 msgsize = "l" if toplevel else "*len"
456
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200457 if o.fieldtype == "u8":
Ole Troandf87f802020-11-18 19:17:48 +0100458 if o.lengthfield:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200459 write(' s = u8string_fromjson(o, "{}");\n'.format(o.fieldname))
460 write(" if (!s) goto error;\n")
461 write(" {} = vec_len(s);\n".format(lfield))
Ole Troandf87f802020-11-18 19:17:48 +0100462
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200463 write(
464 " {realloc} = cJSON_realloc({realloc}, {msgsize} + "
465 "vec_len(s), {msgsize});\n".format(
466 msgvar=msgvar, msgsize=msgsize, realloc=realloc
467 )
468 )
469 write(
470 " memcpy((void *){realloc} + {msgsize}, s, "
471 "vec_len(s));\n".format(realloc=realloc, msgsize=msgsize)
472 )
473 write(" {msgsize} += vec_len(s);\n".format(msgsize=msgsize))
Ole Troandf87f802020-11-18 19:17:48 +0100474
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200475 write(" vec_free(s);\n")
Ole Troandf87f802020-11-18 19:17:48 +0100476 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200477 write(
478 ' if (u8string_fromjson2(o, "{n}", a->{n}) < 0) goto error;\n'.format(
479 n=o.fieldname
480 )
481 )
Ole Troandf87f802020-11-18 19:17:48 +0100482 return
483
484 is_bt = self.is_base_type(o.fieldtype)
485
486 if o.lengthfield:
487 if is_bt:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200488 call = "vl_api_{t}_fromjson(e, &d[i]);".format(t=o.fieldtype)
Ole Troandf87f802020-11-18 19:17:48 +0100489 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200490 call = "if ({t}_fromjson({msgvar}, len, e, &d[i]) < 0) goto error; ".format(
491 t=o.fieldtype, msgvar=msgvar
492 )
493 write(
494 forloop_vla.format(
495 lfield=lfield,
496 t=o.fieldtype,
497 n=o.fieldname,
498 call=call,
499 realloc=realloc,
500 msgsize=msgsize,
501 )
502 )
Ole Troandf87f802020-11-18 19:17:48 +0100503 else:
504 if is_bt:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200505 call = "vl_api_{t}_fromjson(e, &a->{n}[i]);".format(t=t, n=o.fieldname)
Ole Troandf87f802020-11-18 19:17:48 +0100506 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200507 call = "if ({}_fromjson({}, len, e, &a->{}[i]) < 0) goto error;".format(
508 t, msgvar, o.fieldname
509 )
510 write(
511 forloop.format(
512 lfield=lfield,
513 t=t,
514 n=o.fieldname,
515 call=call,
516 msgvar=msgvar,
517 realloc=realloc,
518 msgsize=msgsize,
519 )
520 )
Ole Troandf87f802020-11-18 19:17:48 +0100521
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200522 _dispatch["Array"] = print_array
Ole Troandf87f802020-11-18 19:17:48 +0100523
524 def print_enum(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200525 """Convert to JSON enum(string) to VPP API enum (int)"""
Ole Troandf87f802020-11-18 19:17:48 +0100526 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200527 write(
528 "static inline int vl_api_{n}_t_fromjson"
529 "(void **mp, int *len, cJSON *o, vl_api_{n}_t *a) {{\n".format(n=o.name)
530 )
531 write(" char *p = cJSON_GetStringValue(o);\n")
Ole Troandf87f802020-11-18 19:17:48 +0100532 for b in o.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200533 write(
534 ' if (strcmp(p, "{}") == 0) {{*a = {}; return 0;}}\n'.format(
535 b[0], b[1]
536 )
537 )
538 write(" *a = 0;\n")
539 write(" return -1;\n")
540 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100541
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200542 _dispatch["Enum"] = print_enum
Ole Troan793be462020-12-04 13:15:30 +0100543
544 def print_enum_flag(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200545 """Convert to JSON enum(string) to VPP API enum (int)"""
Ole Troan793be462020-12-04 13:15:30 +0100546 write = self.stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200547 write(
548 "static inline int vl_api_{n}_t_fromjson "
549 "(void **mp, int *len, cJSON *o, vl_api_{n}_t *a) {{\n".format(n=o.name)
550 )
551 write(" int i;\n")
552 write(" *a = 0;\n")
553 write(" for (i = 0; i < cJSON_GetArraySize(o); i++) {\n")
554 write(" cJSON *e = cJSON_GetArrayItem(o, i);\n")
555 write(" char *p = cJSON_GetStringValue(e);\n")
556 write(" if (!p) return -1;\n")
Ole Troan793be462020-12-04 13:15:30 +0100557 for b in o.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200558 write(' if (strcmp(p, "{}") == 0) *a |= {};\n'.format(b[0], b[1]))
559 write(" }\n")
560 write(" return 0;\n")
561 write("}\n")
Ole Troan793be462020-12-04 13:15:30 +0100562
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200563 _dispatch["EnumFlag"] = print_enum_flag
Ole Troandf87f802020-11-18 19:17:48 +0100564
565 def print_typedef(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200566 """Convert from JSON object to VPP API binary representation"""
Ole Troandf87f802020-11-18 19:17:48 +0100567 write = self.stream.write
568
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200569 write(
570 "static inline int vl_api_{name}_t_fromjson (void **mp, "
571 "int *len, cJSON *o, vl_api_{name}_t *a) {{\n".format(name=o.name)
572 )
573 write(" cJSON *item __attribute__ ((unused));\n")
574 write(" u8 *s __attribute__ ((unused));\n")
Ole Troandf87f802020-11-18 19:17:48 +0100575 for t in o.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200576 if t.type == "Field" and t.is_lengthfield:
Ole Troandf87f802020-11-18 19:17:48 +0100577 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200578 write('\n item = cJSON_GetObjectItem(o, "{}");\n'.format(t.fieldname))
579 write(" if (!item) goto error;\n")
Ole Troandf87f802020-11-18 19:17:48 +0100580 self._dispatch[t.type](self, t)
581
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200582 write("\n return 0;\n")
583 write("\n error:\n")
584 write(" return -1;\n")
585 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100586
587 def print_union(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200588 """Convert JSON object to VPP API binary union"""
Ole Troandf87f802020-11-18 19:17:48 +0100589 write = self.stream.write
590
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200591 write(
592 "static inline int vl_api_{name}_t_fromjson (void **mp, "
593 "int *len, cJSON *o, vl_api_{name}_t *a) {{\n".format(name=o.name)
594 )
595 write(" cJSON *item __attribute__ ((unused));\n")
596 write(" u8 *s __attribute__ ((unused));\n")
Ole Troandf87f802020-11-18 19:17:48 +0100597 for t in o.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200598 if t.type == "Field" and t.is_lengthfield:
Ole Troandf87f802020-11-18 19:17:48 +0100599 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200600 write(' item = cJSON_GetObjectItem(o, "{}");\n'.format(t.fieldname))
601 write(" if (item) {\n")
Ole Troandf87f802020-11-18 19:17:48 +0100602 self._dispatch[t.type](self, t)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200603 write(" };\n")
604 write("\n return 0;\n")
605 write("\n error:\n")
606 write(" return -1;\n")
607 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100608
609 def print_define(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200610 """Convert JSON object to VPP API message"""
Ole Troandf87f802020-11-18 19:17:48 +0100611 write = self.stream.write
Ole Troan93c4b1b2021-02-16 18:09:51 +0100612 error = 0
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200613 write(
614 "static inline vl_api_{name}_t *vl_api_{name}_t_fromjson "
615 "(cJSON *o, int *len) {{\n".format(name=o.name)
616 )
617 write(" cJSON *item __attribute__ ((unused));\n")
618 write(" u8 *s __attribute__ ((unused));\n")
619 write(" int l = sizeof(vl_api_{}_t);\n".format(o.name))
620 write(" vl_api_{}_t *a = cJSON_malloc(l);\n".format(o.name))
621 write("\n")
Ole Troandf87f802020-11-18 19:17:48 +0100622
623 for t in o.block:
624 if t.fieldname in self.noprint_fields:
625 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200626 if t.type == "Field" and t.is_lengthfield:
Ole Troandf87f802020-11-18 19:17:48 +0100627 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200628 write(' item = cJSON_GetObjectItem(o, "{}");\n'.format(t.fieldname))
629 write(" if (!item) goto error;\n")
Ole Troan93c4b1b2021-02-16 18:09:51 +0100630 error += 1
Ole Troandf87f802020-11-18 19:17:48 +0100631 self._dispatch[t.type](self, t, toplevel=True)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200632 write("\n")
Ole Troandf87f802020-11-18 19:17:48 +0100633
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200634 write(" *len = l;\n")
635 write(" return a;\n")
Ole Troan93c4b1b2021-02-16 18:09:51 +0100636
637 if error:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200638 write("\n error:\n")
639 write(" cJSON_free(a);\n")
640 write(" return 0;\n")
641 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100642
643 def print_using(self, o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200644 """Convert JSON field to VPP type alias"""
Ole Troandf87f802020-11-18 19:17:48 +0100645 write = self.stream.write
646
647 if o.manual_print:
648 return
649
650 t = o.using
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200651 write(
652 "static inline int vl_api_{name}_t_fromjson (void **mp, "
653 "int *len, cJSON *o, vl_api_{name}_t *a) {{\n".format(name=o.name)
654 )
655 if "length" in o.alias:
656 if t.fieldtype != "u8":
657 raise ValueError(
658 "Error in processing type {} for {}".format(t.fieldtype, o.name)
659 )
660 write(
661 " vl_api_u8_string_fromjson(o, (u8 *)a, {});\n".format(
662 o.alias["length"]
663 )
664 )
Ole Troandf87f802020-11-18 19:17:48 +0100665 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200666 write(" vl_api_{t}_fromjson(o, ({t} *)a);\n".format(t=t.fieldtype))
Ole Troandf87f802020-11-18 19:17:48 +0100667
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200668 write(" return 0;\n")
669 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +0100670
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200671 _dispatch["Typedef"] = print_typedef
672 _dispatch["Define"] = print_define
673 _dispatch["Using"] = print_using
674 _dispatch["Union"] = print_union
Ole Troandf87f802020-11-18 19:17:48 +0100675
676 def generate_function(self, t):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200677 """Main entry point"""
Ole Troandf87f802020-11-18 19:17:48 +0100678 write = self.stream.write
679 if t.manual_print:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200680 write("/* Manual print {} */\n".format(t.name))
Ole Troandf87f802020-11-18 19:17:48 +0100681 return
682 self._dispatch[t.type](self, t)
683
684 def generate_types(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200685 """Main entry point"""
Ole Troandf87f802020-11-18 19:17:48 +0100686 for t in self.types:
687 self.generate_function(t)
688
689 def generate_defines(self):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200690 """Main entry point"""
Ole Troandf87f802020-11-18 19:17:48 +0100691 for t in self.defines:
692 self.generate_function(t)
693
694
695def generate_tojson(s, modulename, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200696 """Generate all functions to convert from API to JSON"""
Ole Troandf87f802020-11-18 19:17:48 +0100697 write = stream.write
698
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200699 write("/* Imported API files */\n")
700 for i in s["Import"]:
701 f = i.filename.replace("plugins/", "")
702 write("#include <{}_tojson.h>\n".format(f))
Ole Troandf87f802020-11-18 19:17:48 +0100703
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200704 pp = ToJSON(modulename, s["types"], s["Define"], s["imported"]["types"], stream)
Ole Troandf87f802020-11-18 19:17:48 +0100705 pp.header()
706 pp.generate_types()
707 pp.generate_defines()
708 pp.footer()
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200709 return ""
Ole Troandf87f802020-11-18 19:17:48 +0100710
711
712def generate_fromjson(s, modulename, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200713 """Generate all functions to convert from JSON to API"""
Ole Troandf87f802020-11-18 19:17:48 +0100714 write = stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200715 write("/* Imported API files */\n")
716 for i in s["Import"]:
717 f = i.filename.replace("plugins/", "")
718 write("#include <{}_fromjson.h>\n".format(f))
Ole Troandf87f802020-11-18 19:17:48 +0100719
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200720 pp = FromJSON(modulename, s["types"], s["Define"], s["imported"]["types"], stream)
Ole Troandf87f802020-11-18 19:17:48 +0100721 pp.header()
722 pp.generate_types()
723 pp.generate_defines()
724 pp.footer()
725
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200726 return ""
727
Ole Troandf87f802020-11-18 19:17:48 +0100728
729###############################################################################
730
731
732DATESTRING = datetime.datetime.utcfromtimestamp(
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200733 int(os.environ.get("SOURCE_DATE_EPOCH", time.time()))
734)
735TOP_BOILERPLATE = """\
Ole Troan9d420872017-10-12 13:06:35 +0200736/*
737 * VLIB API definitions {datestring}
738 * Input file: {input_filename}
739 * Automatically generated: please edit the input file NOT this file!
740 */
741
Ole Troan288e0932019-05-29 12:30:05 +0200742#include <stdbool.h>
Ole Troan9d420872017-10-12 13:06:35 +0200743#if defined(vl_msg_id)||defined(vl_union_id) \\
744 || defined(vl_printfun) ||defined(vl_endianfun) \\
745 || defined(vl_api_version)||defined(vl_typedefs) \\
746 || defined(vl_msg_name)||defined(vl_msg_name_crc_list) \\
Klement Sekera9b7e8ac2021-11-22 21:26:20 +0100747 || defined(vl_api_version_tuple) || defined(vl_calcsizefun)
Ole Troan9d420872017-10-12 13:06:35 +0200748/* ok, something was selected */
749#else
750#warning no content included from {input_filename}
751#endif
752
753#define VL_API_PACKED(x) x __attribute__ ((packed))
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200754"""
Ole Troan9d420872017-10-12 13:06:35 +0200755
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200756BOTTOM_BOILERPLATE = """\
Ole Troan9d420872017-10-12 13:06:35 +0200757/****** API CRC (whole file) *****/
758
759#ifdef vl_api_version
760vl_api_version({input_filename}, {file_crc:#08x})
761
762#endif
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200763"""
Ole Troan9d420872017-10-12 13:06:35 +0200764
765
766def msg_ids(s):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200767 """Generate macro to map API message id to handler"""
768 output = """\
Ole Troan9d420872017-10-12 13:06:35 +0200769
770/****** Message ID / handler enum ******/
771
772#ifdef vl_msg_id
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200773"""
Ole Troan9d420872017-10-12 13:06:35 +0200774
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200775 for t in s["Define"]:
776 output += "vl_msg_id(VL_API_%s, vl_api_%s_t_handler)\n" % (
777 t.name.upper(),
778 t.name,
779 )
Ole Troan9d420872017-10-12 13:06:35 +0200780 output += "#endif"
781
782 return output
783
784
785def msg_names(s):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200786 """Generate calls to name mapping macro"""
787 output = """\
Ole Troan9d420872017-10-12 13:06:35 +0200788
789/****** Message names ******/
790
791#ifdef vl_msg_name
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200792"""
Ole Troan9d420872017-10-12 13:06:35 +0200793
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200794 for t in s["Define"]:
Ole Troan9d420872017-10-12 13:06:35 +0200795 dont_trace = 0 if t.dont_trace else 1
796 output += "vl_msg_name(vl_api_%s_t, %d)\n" % (t.name, dont_trace)
797 output += "#endif"
798
799 return output
800
801
802def msg_name_crc_list(s, suffix):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200803 """Generate list of names to CRC mappings"""
804 output = """\
Ole Troan9d420872017-10-12 13:06:35 +0200805
806/****** Message name, crc list ******/
807
808#ifdef vl_msg_name_crc_list
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200809"""
Ole Troan9d420872017-10-12 13:06:35 +0200810 output += "#define foreach_vl_msg_name_crc_%s " % suffix
811
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200812 for t in s["Define"]:
813 output += "\\\n_(VL_API_%s, %s, %08x) " % (t.name.upper(), t.name, t.crc)
Ole Troan9d420872017-10-12 13:06:35 +0200814 output += "\n#endif"
815
816 return output
817
818
Ole Troan413f4a52018-11-28 11:36:05 +0100819def api2c(fieldtype):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200820 """Map between API type names and internal VPP type names"""
821 mappingtable = {
822 "string": "vl_api_string_t",
823 }
Ole Troan413f4a52018-11-28 11:36:05 +0100824 if fieldtype in mappingtable:
825 return mappingtable[fieldtype]
826 return fieldtype
827
828
Ole Troan2a1ca782019-09-19 01:08:30 +0200829def typedefs(filename):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200830 """Include in the main files to the types file"""
831 output = """\
Ole Troan9d420872017-10-12 13:06:35 +0200832
833/****** Typedefs ******/
834
835#ifdef vl_typedefs
Ole Troan2a1ca782019-09-19 01:08:30 +0200836#include "{include}.api_types.h"
837#endif
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200838""".format(
839 include=filename
840 )
Ole Troan9d420872017-10-12 13:06:35 +0200841 return output
842
843
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200844FORMAT_STRINGS = {
845 "u8": "%u",
846 "bool": "%u",
847 "i8": "%d",
848 "u16": "%u",
849 "i16": "%d",
850 "u32": "%u",
851 "i32": "%ld",
852 "u64": "%llu",
853 "i64": "%lld",
854 "f64": "%.2f",
855}
Ole Troan33a58172019-09-04 09:12:29 +0200856
Ole Troan9d420872017-10-12 13:06:35 +0200857
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200858class Printfun:
859 """Functions for pretty printing VPP API messages"""
860
Ole Troan33a58172019-09-04 09:12:29 +0200861 _dispatch = {}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200862 noprint_fields = {"_vl_msg_id": None, "client_index": None, "context": None}
Ole Troan33a58172019-09-04 09:12:29 +0200863
864 def __init__(self, stream):
865 self.stream = stream
866
Ole Troandf87f802020-11-18 19:17:48 +0100867 @staticmethod
868 def print_string(o, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200869 """Pretty print a vl_api_string_t"""
Ole Troan33a58172019-09-04 09:12:29 +0200870 write = stream.write
871 if o.modern_vla:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200872 write(" if (vl_api_string_len(&a->{f}) > 0) {{\n".format(f=o.fieldname))
873 write(
874 ' s = format(s, "\\n%U{f}: %U", '
875 "format_white_space, indent, "
876 "vl_api_format_string, (&a->{f}));\n".format(f=o.fieldname)
877 )
878 write(" } else {\n")
879 write(
880 ' s = format(s, "\\n%U{f}:", '
881 "format_white_space, indent);\n".format(f=o.fieldname)
882 )
883 write(" }\n")
Ole Troan33a58172019-09-04 09:12:29 +0200884 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200885 write(
886 ' s = format(s, "\\n%U{f}: %s", '
887 "format_white_space, indent, a->{f});\n".format(f=o.fieldname)
888 )
Ole Troan33a58172019-09-04 09:12:29 +0200889
890 def print_field(self, o, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200891 """Pretty print API field"""
Ole Troan33a58172019-09-04 09:12:29 +0200892 write = stream.write
Ole Troandf87f802020-11-18 19:17:48 +0100893 if o.fieldname in self.noprint_fields:
Ole Troan33a58172019-09-04 09:12:29 +0200894 return
Ole Troandf87f802020-11-18 19:17:48 +0100895 if o.fieldtype in FORMAT_STRINGS:
896 f = FORMAT_STRINGS[o.fieldtype]
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200897 write(
898 ' s = format(s, "\\n%U{n}: {f}", '
899 "format_white_space, indent, a->{n});\n".format(n=o.fieldname, f=f)
900 )
Ole Troan33a58172019-09-04 09:12:29 +0200901 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200902 write(
903 ' s = format(s, "\\n%U{n}: %U", '
904 "format_white_space, indent, "
905 "format_{t}, &a->{n}, indent);\n".format(n=o.fieldname, t=o.fieldtype)
906 )
Ole Troan33a58172019-09-04 09:12:29 +0200907
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200908 _dispatch["Field"] = print_field
Ole Troan33a58172019-09-04 09:12:29 +0200909
910 def print_array(self, o, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200911 """Pretty print API array"""
Ole Troan33a58172019-09-04 09:12:29 +0200912 write = stream.write
913
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200914 forloop = """\
Ole Troan33a58172019-09-04 09:12:29 +0200915 for (i = 0; i < {lfield}; i++) {{
916 s = format(s, "\\n%U{n}: %U",
917 format_white_space, indent, format_{t}, &a->{n}[i], indent);
918 }}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200919"""
Ole Troan33a58172019-09-04 09:12:29 +0200920
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200921 forloop_format = """\
Ole Troan33a58172019-09-04 09:12:29 +0200922 for (i = 0; i < {lfield}; i++) {{
923 s = format(s, "\\n%U{n}: {t}",
924 format_white_space, indent, a->{n}[i]);
925 }}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200926"""
Ole Troan33a58172019-09-04 09:12:29 +0200927
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200928 if o.fieldtype == "string":
Ole Troandf87f802020-11-18 19:17:48 +0100929 self.print_string(o, stream)
930 return
Ole Troan33a58172019-09-04 09:12:29 +0200931
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200932 if o.fieldtype == "u8":
Ole Troan33a58172019-09-04 09:12:29 +0200933 if o.lengthfield:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200934 write(
935 ' s = format(s, "\\n%U{n}: %U", format_white_space, '
936 "indent, format_hex_bytes, a->{n}, a->{lfield});\n".format(
937 n=o.fieldname, lfield=o.lengthfield
938 )
939 )
Ole Troan33a58172019-09-04 09:12:29 +0200940 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200941 write(
942 ' s = format(s, "\\n%U{n}: %U", format_white_space, '
943 "indent, format_hex_bytes, a, {lfield});\n".format(
944 n=o.fieldname, lfield=o.length
945 )
946 )
Ole Troan33a58172019-09-04 09:12:29 +0200947 return
948
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200949 lfield = "a->" + o.lengthfield if o.lengthfield else o.length
Ole Troandf87f802020-11-18 19:17:48 +0100950 if o.fieldtype in FORMAT_STRINGS:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200951 write(
952 forloop_format.format(
953 lfield=lfield, t=FORMAT_STRINGS[o.fieldtype], n=o.fieldname
954 )
955 )
Ole Troan33a58172019-09-04 09:12:29 +0200956 else:
957 write(forloop.format(lfield=lfield, t=o.fieldtype, n=o.fieldname))
958
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200959 _dispatch["Array"] = print_array
Ole Troan33a58172019-09-04 09:12:29 +0200960
Ole Troandf87f802020-11-18 19:17:48 +0100961 @staticmethod
962 def print_alias(k, v, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200963 """Pretty print type alias"""
Ole Troan33a58172019-09-04 09:12:29 +0200964 write = stream.write
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200965 if "length" in v.alias and v.alias["length"] and v.alias["type"] == "u8":
966 write(
967 ' return format(s, "%U", format_hex_bytes, a, {});\n'.format(
968 v.alias["length"]
969 )
970 )
971 elif v.alias["type"] in FORMAT_STRINGS:
972 write(
973 ' return format(s, "{}", *a);\n'.format(
974 FORMAT_STRINGS[v.alias["type"]]
975 )
976 )
Ole Troan33a58172019-09-04 09:12:29 +0200977 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200978 write(' return format(s, "{} (print not implemented)");\n'.format(k))
Ole Troan33a58172019-09-04 09:12:29 +0200979
Ole Troandf87f802020-11-18 19:17:48 +0100980 @staticmethod
981 def print_enum(o, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200982 """Pretty print API enum"""
Ole Troan33a58172019-09-04 09:12:29 +0200983 write = stream.write
984 write(" switch(*a) {\n")
985 for b in o:
986 write(" case %s:\n" % b[1])
987 write(' return format(s, "{}");\n'.format(b[0]))
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200988 write(" }\n")
Ole Troan33a58172019-09-04 09:12:29 +0200989
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200990 _dispatch["Enum"] = print_enum
991 _dispatch["EnumFlag"] = print_enum
Ole Troan33a58172019-09-04 09:12:29 +0200992
993 def print_obj(self, o, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +0200994 """Entry point"""
Ole Troan33a58172019-09-04 09:12:29 +0200995 write = stream.write
996
997 if o.type in self._dispatch:
998 self._dispatch[o.type](self, o, stream)
999 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001000 write(
1001 ' s = format(s, "\\n{} {} {} (print not implemented");\n'.format(
1002 o.type, o.fieldtype, o.fieldname
1003 )
1004 )
Ole Troan33a58172019-09-04 09:12:29 +02001005
1006
1007def printfun(objs, stream, modulename):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001008 """Main entry point for pretty print function generation"""
Ole Troan33a58172019-09-04 09:12:29 +02001009 write = stream.write
1010
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001011 h = """\
Ole Troan9d420872017-10-12 13:06:35 +02001012/****** Print functions *****/
1013#ifdef vl_printfun
Ole Troan33a58172019-09-04 09:12:29 +02001014#ifndef included_{module}_printfun
1015#define included_{module}_printfun
Ole Troan9d420872017-10-12 13:06:35 +02001016
1017#ifdef LP64
1018#define _uword_fmt \"%lld\"
1019#define _uword_cast (long long)
1020#else
1021#define _uword_fmt \"%ld\"
1022#define _uword_cast long
1023#endif
1024
Filip Tehlar36217e32021-07-23 08:51:10 +00001025#include "{module}.api_tojson.h"
1026#include "{module}.api_fromjson.h"
1027
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001028"""
Ole Troan33a58172019-09-04 09:12:29 +02001029
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001030 signature = """\
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001031static inline u8 *vl_api_{name}_t_format (u8 *s, va_list *args)
Ole Troan33a58172019-09-04 09:12:29 +02001032{{
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001033 __attribute__((unused)) vl_api_{name}_t *a = va_arg (*args, vl_api_{name}_t *);
Ole Troan33a58172019-09-04 09:12:29 +02001034 u32 indent __attribute__((unused)) = 2;
1035 int i __attribute__((unused));
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001036"""
Ole Troan33a58172019-09-04 09:12:29 +02001037
1038 h = h.format(module=modulename)
1039 write(h)
1040
1041 pp = Printfun(stream)
1042 for t in objs:
1043 if t.manual_print:
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001044 write("/***** manual: vl_api_%s_t_format *****/\n\n" % t.name)
Ole Troan33a58172019-09-04 09:12:29 +02001045 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001046 write(signature.format(name=t.name, suffix=""))
1047 write(" /* Message definition: vl_api_{}_t: */\n".format(t.name))
1048 write(' s = format(s, "vl_api_%s_t:");\n' % t.name)
Ole Troan33a58172019-09-04 09:12:29 +02001049 for o in t.block:
1050 pp.print_obj(o, stream)
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001051 write(" return s;\n")
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001052 write("}\n\n")
Filip Tehlar36217e32021-07-23 08:51:10 +00001053
Ole Troan33a58172019-09-04 09:12:29 +02001054 write("\n#endif")
1055 write("\n#endif /* vl_printfun */\n")
1056
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001057 return ""
Ole Troan33a58172019-09-04 09:12:29 +02001058
1059
Ole Troan75761b92019-09-11 17:49:08 +02001060def printfun_types(objs, stream, modulename):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001061 """Pretty print API types"""
Ole Troan33a58172019-09-04 09:12:29 +02001062 write = stream.write
1063 pp = Printfun(stream)
1064
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001065 h = """\
Ole Troan33a58172019-09-04 09:12:29 +02001066/****** Print functions *****/
1067#ifdef vl_printfun
1068#ifndef included_{module}_printfun_types
1069#define included_{module}_printfun_types
1070
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001071"""
Ole Troan33a58172019-09-04 09:12:29 +02001072 h = h.format(module=modulename)
1073 write(h)
1074
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001075 signature = """\
Ole Troan33a58172019-09-04 09:12:29 +02001076static inline u8 *format_vl_api_{name}_t (u8 *s, va_list * args)
1077{{
1078 vl_api_{name}_t *a = va_arg (*args, vl_api_{name}_t *);
1079 u32 indent __attribute__((unused)) = va_arg (*args, u32);
1080 int i __attribute__((unused));
1081 indent += 2;
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001082"""
Ole Troan33a58172019-09-04 09:12:29 +02001083
Ole Troan2c2feab2018-04-24 00:02:37 -04001084 for t in objs:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001085 if t.__class__.__name__ == "Enum" or t.__class__.__name__ == "EnumFlag":
Ole Troan33a58172019-09-04 09:12:29 +02001086 write(signature.format(name=t.name))
1087 pp.print_enum(t.block, stream)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001088 write(" return s;\n")
1089 write("}\n\n")
Ole Troan2c2feab2018-04-24 00:02:37 -04001090 continue
Ole Troan33a58172019-09-04 09:12:29 +02001091
Ole Troan9d420872017-10-12 13:06:35 +02001092 if t.manual_print:
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001093 write("/***** manual: vl_api_%s_t_format *****/\n\n" % t.name)
Ole Troan9d420872017-10-12 13:06:35 +02001094 continue
Ole Troan9d420872017-10-12 13:06:35 +02001095
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001096 if t.__class__.__name__ == "Using":
Ole Troan75761b92019-09-11 17:49:08 +02001097 write(signature.format(name=t.name))
1098 pp.print_alias(t.name, t, stream)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001099 write("}\n\n")
Ole Troan75761b92019-09-11 17:49:08 +02001100 continue
1101
Ole Troan33a58172019-09-04 09:12:29 +02001102 write(signature.format(name=t.name))
Ole Troan9d420872017-10-12 13:06:35 +02001103 for o in t.block:
Ole Troan33a58172019-09-04 09:12:29 +02001104 pp.print_obj(o, stream)
Ole Troan9d420872017-10-12 13:06:35 +02001105
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001106 write(" return s;\n")
1107 write("}\n\n")
Ole Troan9d420872017-10-12 13:06:35 +02001108
Ole Troan33a58172019-09-04 09:12:29 +02001109 write("\n#endif")
1110 write("\n#endif /* vl_printfun_types */\n")
Ole Troan9d420872017-10-12 13:06:35 +02001111
Ole Troan33a58172019-09-04 09:12:29 +02001112
Ole Troandf87f802020-11-18 19:17:48 +01001113def generate_imports(imports):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001114 """Add #include matching the API import statements"""
1115 output = "/* Imported API files */\n"
1116 output += "#ifndef vl_api_version\n"
Ole Troan33a58172019-09-04 09:12:29 +02001117
1118 for i in imports:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001119 s = i.filename.replace("plugins/", "")
1120 output += "#include <{}.h>\n".format(s)
1121 output += "#endif\n"
Ole Troan9d420872017-10-12 13:06:35 +02001122 return output
1123
1124
Ole Troandf87f802020-11-18 19:17:48 +01001125ENDIAN_STRINGS = {
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001126 "u16": "clib_net_to_host_u16",
1127 "u32": "clib_net_to_host_u32",
1128 "u64": "clib_net_to_host_u64",
1129 "i16": "clib_net_to_host_i16",
1130 "i32": "clib_net_to_host_i32",
1131 "i64": "clib_net_to_host_i64",
1132 "f64": "clib_net_to_host_f64",
Ole Troan9d420872017-10-12 13:06:35 +02001133}
1134
1135
Ole Troan33a58172019-09-04 09:12:29 +02001136def endianfun_array(o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001137 """Generate endian functions for arrays"""
1138 forloop = """\
Ole Troan33a58172019-09-04 09:12:29 +02001139 for (i = 0; i < {length}; i++) {{
1140 a->{name}[i] = {format}(a->{name}[i]);
1141 }}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001142"""
Ole Troan33a58172019-09-04 09:12:29 +02001143
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001144 forloop_format = """\
Ole Troan33a58172019-09-04 09:12:29 +02001145 for (i = 0; i < {length}; i++) {{
1146 {type}_endian(&a->{name}[i]);
1147 }}
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001148"""
Ole Troan33a58172019-09-04 09:12:29 +02001149
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001150 output = ""
1151 if o.fieldtype == "u8" or o.fieldtype == "string" or o.fieldtype == "bool":
1152 output += " /* a->{n} = a->{n} (no-op) */\n".format(n=o.fieldname)
Ole Troan33a58172019-09-04 09:12:29 +02001153 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001154 lfield = "a->" + o.lengthfield if o.lengthfield else o.length
Ole Troandf87f802020-11-18 19:17:48 +01001155 if o.fieldtype in ENDIAN_STRINGS:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001156 output += forloop.format(
1157 length=lfield, format=ENDIAN_STRINGS[o.fieldtype], name=o.fieldname
1158 )
Ole Troan33a58172019-09-04 09:12:29 +02001159 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001160 output += forloop_format.format(
1161 length=lfield, type=o.fieldtype, name=o.fieldname
1162 )
Ole Troan33a58172019-09-04 09:12:29 +02001163 return output
1164
Ole Troandf87f802020-11-18 19:17:48 +01001165
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001166NO_ENDIAN_CONVERSION = {"client_index": None}
Ole Troandf87f802020-11-18 19:17:48 +01001167
Ole Troan33a58172019-09-04 09:12:29 +02001168
1169def endianfun_obj(o):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001170 """Generate endian conversion function for type"""
1171 output = ""
1172 if o.type == "Array":
Ole Troan33a58172019-09-04 09:12:29 +02001173 return endianfun_array(o)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001174 if o.type != "Field":
1175 output += ' s = format(s, "\\n{} {} {} (print not implemented");\n'.format(
1176 o.type, o.fieldtype, o.fieldname
1177 )
Ole Troan33a58172019-09-04 09:12:29 +02001178 return output
Ole Troandf87f802020-11-18 19:17:48 +01001179 if o.fieldname in NO_ENDIAN_CONVERSION:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001180 output += " /* a->{n} = a->{n} (no-op) */\n".format(n=o.fieldname)
Ole Troane796a182020-05-18 11:14:05 +02001181 return output
Ole Troandf87f802020-11-18 19:17:48 +01001182 if o.fieldtype in ENDIAN_STRINGS:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001183 output += " a->{name} = {format}(a->{name});\n".format(
1184 name=o.fieldname, format=ENDIAN_STRINGS[o.fieldtype]
1185 )
1186 elif o.fieldtype.startswith("vl_api_"):
1187 output += " {type}_endian(&a->{name});\n".format(
1188 type=o.fieldtype, name=o.fieldname
1189 )
Ole Troan33a58172019-09-04 09:12:29 +02001190 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001191 output += " /* a->{n} = a->{n} (no-op) */\n".format(n=o.fieldname)
Ole Troan33a58172019-09-04 09:12:29 +02001192
1193 return output
1194
1195
Ole Troan75761b92019-09-11 17:49:08 +02001196def endianfun(objs, modulename):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001197 """Main entry point for endian function generation"""
1198 output = """\
Ole Troan9d420872017-10-12 13:06:35 +02001199
1200/****** Endian swap functions *****/\n\
1201#ifdef vl_endianfun
Ole Troan33a58172019-09-04 09:12:29 +02001202#ifndef included_{module}_endianfun
1203#define included_{module}_endianfun
Ole Troan9d420872017-10-12 13:06:35 +02001204
1205#undef clib_net_to_host_uword
1206#ifdef LP64
1207#define clib_net_to_host_uword clib_net_to_host_u64
1208#else
1209#define clib_net_to_host_uword clib_net_to_host_u32
1210#endif
1211
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001212"""
Ole Troan33a58172019-09-04 09:12:29 +02001213 output = output.format(module=modulename)
1214
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001215 signature = """\
Ole Troan33a58172019-09-04 09:12:29 +02001216static inline void vl_api_{name}_t_endian (vl_api_{name}_t *a)
1217{{
1218 int i __attribute__((unused));
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001219"""
Ole Troan33a58172019-09-04 09:12:29 +02001220
Ole Troan2c2feab2018-04-24 00:02:37 -04001221 for t in objs:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001222 if t.__class__.__name__ == "Enum" or t.__class__.__name__ == "EnumFlag":
Ole Troan33a58172019-09-04 09:12:29 +02001223 output += signature.format(name=t.name)
Ole Troandf87f802020-11-18 19:17:48 +01001224 if t.enumtype in ENDIAN_STRINGS:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001225 output += " *a = {}(*a);\n".format(ENDIAN_STRINGS[t.enumtype])
Ole Troan33a58172019-09-04 09:12:29 +02001226 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001227 output += " /* a->{name} = a->{name} (no-op) */\n".format(
1228 name=t.name
1229 )
Ole Troan33a58172019-09-04 09:12:29 +02001230
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001231 output += "}\n\n"
Ole Troan2c2feab2018-04-24 00:02:37 -04001232 continue
Ole Troan33a58172019-09-04 09:12:29 +02001233
Ole Troan9d420872017-10-12 13:06:35 +02001234 if t.manual_endian:
1235 output += "/***** manual: vl_api_%s_t_endian *****/\n\n" % t.name
1236 continue
Ole Troan33a58172019-09-04 09:12:29 +02001237
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001238 if t.__class__.__name__ == "Using":
Ole Troan75761b92019-09-11 17:49:08 +02001239 output += signature.format(name=t.name)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001240 if "length" in t.alias and t.alias["length"] and t.alias["type"] == "u8":
1241 output += " /* a->{name} = a->{name} (no-op) */\n".format(
1242 name=t.name
1243 )
1244 elif t.alias["type"] in FORMAT_STRINGS:
1245 output += " *a = {}(*a);\n".format(ENDIAN_STRINGS[t.alias["type"]])
Ole Troan75761b92019-09-11 17:49:08 +02001246 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001247 output += " /* Not Implemented yet {} */".format(t.name)
1248 output += "}\n\n"
Ole Troan75761b92019-09-11 17:49:08 +02001249 continue
1250
Ole Troan33a58172019-09-04 09:12:29 +02001251 output += signature.format(name=t.name)
Ole Troan9d420872017-10-12 13:06:35 +02001252
Stanislav Zaikin139b2da2022-07-21 19:06:26 +02001253 # make Array type appear before the others:
1254 # some arrays have dynamic length, and we want to iterate over
1255 # them before changing endiann for the length field
1256 t.block.sort(key=lambda x: x.type)
1257
Ole Troan9d420872017-10-12 13:06:35 +02001258 for o in t.block:
Ole Troan33a58172019-09-04 09:12:29 +02001259 output += endianfun_obj(o)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001260 output += "}\n\n"
Ole Troan33a58172019-09-04 09:12:29 +02001261
1262 output += "\n#endif"
Ole Troan9d420872017-10-12 13:06:35 +02001263 output += "\n#endif /* vl_endianfun */\n\n"
1264
1265 return output
1266
1267
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001268def calc_size_fun(objs, modulename):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001269 """Main entry point for calculate size function generation"""
1270 output = """\
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001271
1272/****** Calculate size functions *****/\n\
1273#ifdef vl_calcsizefun
1274#ifndef included_{module}_calcsizefun
1275#define included_{module}_calcsizefun
1276
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001277"""
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001278 output = output.format(module=modulename)
1279
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001280 signature = """\
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001281/* calculate message size of message in network byte order */
1282static inline uword vl_api_{name}_t_calc_size (vl_api_{name}_t *a)
1283{{
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001284"""
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001285
1286 for o in objs:
1287 tname = o.__class__.__name__
1288
1289 output += signature.format(name=o.name)
1290 output += f" return sizeof(*a)"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001291 if tname == "Using":
1292 if "length" in o.alias:
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001293 try:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001294 tmp = int(o.alias["length"])
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001295 if tmp == 0:
1296 raise (f"Unexpected length '0' for alias {o}")
1297 except:
1298 # output += f" + vl_api_{o.alias.name}_t_calc_size({o.name})"
1299 print("culprit:")
1300 print(o)
1301 print(dir(o.alias))
1302 print(o.alias)
1303 raise
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001304 elif tname == "Enum" or tname == "EnumFlag":
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001305 pass
1306 else:
1307 for b in o.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001308 if b.type == "Option":
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001309 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001310 elif b.type == "Field":
1311 if b.fieldtype.startswith("vl_api_"):
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001312 output += f" - sizeof(a->{b.fieldname})"
1313 output += f" + {b.fieldtype}_calc_size(&a->{b.fieldname})"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001314 elif b.type == "Array":
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001315 if b.lengthfield:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001316 m = list(
1317 filter(lambda x: x.fieldname == b.lengthfield, o.block)
1318 )
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001319 if len(m) != 1:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001320 raise Exception(
1321 f"Expected 1 match for field '{b.lengthfield}', got '{m}'"
1322 )
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001323 lf = m[0]
1324 if lf.fieldtype in ENDIAN_STRINGS:
1325 output += f" + {ENDIAN_STRINGS[lf.fieldtype]}(a->{b.lengthfield}) * sizeof(a->{b.fieldname}[0])"
1326 elif lf.fieldtype == "u8":
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001327 output += (
1328 f" + a->{b.lengthfield} * sizeof(a->{b.fieldname}[0])"
1329 )
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001330 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001331 raise Exception(
1332 f"Don't know how to endian swap {lf.fieldtype}"
1333 )
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001334 else:
1335 # Fixed length strings decay to nul terminated u8
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001336 if b.fieldtype == "string":
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001337 if b.modern_vla:
1338 output += f" + vl_api_string_len(&a->{b.fieldname})"
1339
1340 output += ";\n"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001341 output += "}\n\n"
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001342 output += "\n#endif"
1343 output += "\n#endif /* vl_calcsizefun */\n\n"
1344
1345 return output
1346
1347
Ole Troan9d420872017-10-12 13:06:35 +02001348def version_tuple(s, module):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001349 """Generate semantic version string"""
1350 output = """\
Ole Troan9d420872017-10-12 13:06:35 +02001351/****** Version tuple *****/
1352
1353#ifdef vl_api_version_tuple
1354
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001355"""
1356 if "version" in s["Option"]:
1357 v = s["Option"]["version"]
1358 (major, minor, patch) = v.split(".")
1359 output += "vl_api_version_tuple(%s, %s, %s, %s)\n" % (
1360 module,
1361 major,
1362 minor,
1363 patch,
1364 )
Ole Troan9d420872017-10-12 13:06:35 +02001365
1366 output += "\n#endif /* vl_api_version_tuple */\n\n"
1367
1368 return output
1369
1370
Ole Troan2a1ca782019-09-19 01:08:30 +02001371def generate_include_enum(s, module, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001372 """Generate <name>.api_enum.h"""
Ole Troan2a1ca782019-09-19 01:08:30 +02001373 write = stream.write
1374
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001375 if "Define" in s:
1376 write("typedef enum {\n")
1377 for t in s["Define"]:
1378 write(" VL_API_{},\n".format(t.name.upper()))
1379 write(" VL_MSG_{}_LAST\n".format(module.upper()))
1380 write("}} vl_api_{}_enum_t;\n".format(module))
Ole Troan2a1ca782019-09-19 01:08:30 +02001381
Paul Vinciguerra7c8803d2019-11-21 17:16:18 -05001382
Ole Troandf87f802020-11-18 19:17:48 +01001383def generate_include_counters(s, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001384 """Include file for the counter data model types."""
Ole Troan148c7b72020-10-07 18:05:37 +02001385 write = stream.write
1386
1387 for counters in s:
1388 csetname = counters.name
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001389 write("typedef enum {\n")
Ole Troan148c7b72020-10-07 18:05:37 +02001390 for c in counters.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001391 write(" {}_ERROR_{},\n".format(csetname.upper(), c["name"].upper()))
1392 write(" {}_N_ERROR\n".format(csetname.upper()))
1393 write("}} vl_counter_{}_enum_t;\n".format(csetname))
Ole Troan148c7b72020-10-07 18:05:37 +02001394
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001395 write("extern vlib_error_desc_t {}_error_counters[];\n".format(csetname))
Ole Troan148c7b72020-10-07 18:05:37 +02001396
Ole Troandf87f802020-11-18 19:17:48 +01001397
Ole Troan2a1ca782019-09-19 01:08:30 +02001398def generate_include_types(s, module, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001399 """Generate separate API _types file."""
Ole Troan2a1ca782019-09-19 01:08:30 +02001400 write = stream.write
1401
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001402 write("#ifndef included_{module}_api_types_h\n".format(module=module))
1403 write("#define included_{module}_api_types_h\n".format(module=module))
Ole Troan2a1ca782019-09-19 01:08:30 +02001404
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001405 if "version" in s["Option"]:
1406 v = s["Option"]["version"]
1407 (major, minor, patch) = v.split(".")
1408 write(
1409 "#define VL_API_{m}_API_VERSION_MAJOR {v}\n".format(
1410 m=module.upper(), v=major
1411 )
1412 )
1413 write(
1414 "#define VL_API_{m}_API_VERSION_MINOR {v}\n".format(
1415 m=module.upper(), v=minor
1416 )
1417 )
1418 write(
1419 "#define VL_API_{m}_API_VERSION_PATCH {v}\n".format(
1420 m=module.upper(), v=patch
1421 )
1422 )
Ole Troanf92bfb12020-02-28 13:45:42 +01001423
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001424 if "Import" in s:
1425 write("/* Imported API files */\n")
1426 for i in s["Import"]:
1427 filename = i.filename.replace("plugins/", "")
1428 write("#include <{}_types.h>\n".format(filename))
Ole Troan2a1ca782019-09-19 01:08:30 +02001429
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001430 for o in itertools.chain(s["types"], s["Define"]):
Ole Troan2a1ca782019-09-19 01:08:30 +02001431 tname = o.__class__.__name__
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001432 if tname == "Using":
1433 if "length" in o.alias:
1434 write(
1435 "typedef %s vl_api_%s_t[%s];\n"
1436 % (o.alias["type"], o.name, o.alias["length"])
1437 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001438 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001439 write("typedef %s vl_api_%s_t;\n" % (o.alias["type"], o.name))
1440 elif tname == "Enum" or tname == "EnumFlag":
1441 if o.enumtype == "u32":
Ole Troan2a1ca782019-09-19 01:08:30 +02001442 write("typedef enum {\n")
1443 else:
1444 write("typedef enum __attribute__((packed)) {\n")
1445
1446 for b in o.block:
1447 write(" %s = %s,\n" % (b[0], b[1]))
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001448 write("} vl_api_%s_t;\n" % o.name)
1449 if o.enumtype != "u32":
1450 size1 = "sizeof(vl_api_%s_t)" % o.name
1451 size2 = "sizeof(%s)" % o.enumtype
1452 err_str = "size of API enum %s is wrong" % o.name
1453 write('STATIC_ASSERT(%s == %s, "%s");\n' % (size1, size2, err_str))
Ole Troan2a1ca782019-09-19 01:08:30 +02001454 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001455 if tname == "Union":
1456 write("typedef union __attribute__ ((packed)) _vl_api_%s {\n" % o.name)
Ole Troan2a1ca782019-09-19 01:08:30 +02001457 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001458 write(
1459 ("typedef struct __attribute__ ((packed)) _vl_api_%s {\n") % o.name
1460 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001461 for b in o.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001462 if b.type == "Option":
Ole Troan2a1ca782019-09-19 01:08:30 +02001463 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001464 if b.type == "Field":
1465 write(" %s %s;\n" % (api2c(b.fieldtype), b.fieldname))
1466 elif b.type == "Array":
Ole Troan2a1ca782019-09-19 01:08:30 +02001467 if b.lengthfield:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001468 write(" %s %s[0];\n" % (api2c(b.fieldtype), b.fieldname))
Ole Troan2a1ca782019-09-19 01:08:30 +02001469 else:
1470 # Fixed length strings decay to nul terminated u8
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001471 if b.fieldtype == "string":
Ole Troan2a1ca782019-09-19 01:08:30 +02001472 if b.modern_vla:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001473 write(
1474 " {} {};\n".format(
1475 api2c(b.fieldtype), b.fieldname
1476 )
1477 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001478 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001479 write(" u8 {}[{}];\n".format(b.fieldname, b.length))
Ole Troan2a1ca782019-09-19 01:08:30 +02001480 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001481 write(
1482 " %s %s[%s];\n"
1483 % (api2c(b.fieldtype), b.fieldname, b.length)
1484 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001485 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001486 raise ValueError(
1487 "Error in processing type {} for {}".format(b, o.name)
1488 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001489
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001490 write("} vl_api_%s_t;\n" % o.name)
1491 write(
1492 f"#define VL_API_{o.name.upper()}_IS_CONSTANT_SIZE ({0 if o.vla else 1})\n\n"
1493 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001494
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001495 for t in s["Define"]:
1496 write(
1497 '#define VL_API_{ID}_CRC "{n}_{crc:08x}"\n'.format(
1498 n=t.name, ID=t.name.upper(), crc=t.crc
1499 )
1500 )
Ole Troan3f2d5712019-12-07 00:39:49 +01001501
Ole Troan2a1ca782019-09-19 01:08:30 +02001502 write("\n#endif\n")
1503
1504
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001505def generate_c_boilerplate(services, defines, counters, file_crc, module, stream):
1506 """VPP side plugin."""
Ole Troan2a1ca782019-09-19 01:08:30 +02001507 write = stream.write
Ole Troan148c7b72020-10-07 18:05:37 +02001508 define_hash = {d.name: d for d in defines}
Ole Troan2a1ca782019-09-19 01:08:30 +02001509
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001510 hdr = """\
Ole Troan2a1ca782019-09-19 01:08:30 +02001511#define vl_endianfun /* define message structures */
1512#include "{module}.api.h"
1513#undef vl_endianfun
1514
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001515#define vl_calcsizefun
1516#include "{module}.api.h"
1517#undef vl_calsizefun
1518
Ole Troan2a1ca782019-09-19 01:08:30 +02001519/* instantiate all the print functions we know about */
Ole Troan2a1ca782019-09-19 01:08:30 +02001520#define vl_printfun
1521#include "{module}.api.h"
1522#undef vl_printfun
1523
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001524"""
Ole Troan2a1ca782019-09-19 01:08:30 +02001525
1526 write(hdr.format(module=module))
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001527 write("static u16\n")
1528 write("setup_message_id_table (void) {\n")
1529 write(" api_main_t *am = my_api_main;\n")
1530 write(" vl_msg_api_msg_config_t c;\n")
1531 write(
1532 ' u16 msg_id_base = vl_msg_api_get_msg_ids ("{}_{crc:08x}", '
1533 "VL_MSG_{m}_LAST);\n".format(module, crc=file_crc, m=module.upper())
1534 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001535
Ole Troan2a1ca782019-09-19 01:08:30 +02001536 for d in defines:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001537 write(
1538 ' vl_msg_api_add_msg_name_crc (am, "{n}_{crc:08x}",\n'
1539 " VL_API_{ID} + msg_id_base);\n".format(
1540 n=d.name, ID=d.name.upper(), crc=d.crc
1541 )
1542 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001543 for s in services:
Ole Troane796a182020-05-18 11:14:05 +02001544 d = define_hash[s.caller]
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001545 write(
1546 " c = (vl_msg_api_msg_config_t) "
1547 " {{.id = VL_API_{ID} + msg_id_base,\n"
1548 ' .name = "{n}",\n'
1549 " .handler = vl_api_{n}_t_handler,\n"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001550 " .endian = vl_api_{n}_t_endian,\n"
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001551 " .format_fn = vl_api_{n}_t_format,\n"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001552 " .traced = 1,\n"
1553 " .replay = 1,\n"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001554 " .tojson = vl_api_{n}_t_tojson,\n"
1555 " .fromjson = vl_api_{n}_t_fromjson,\n"
1556 " .calc_size = vl_api_{n}_t_calc_size,\n"
1557 " .is_autoendian = {auto}}};\n".format(
1558 n=s.caller, ID=s.caller.upper(), auto=d.autoendian
1559 )
1560 )
1561 write(" vl_msg_api_config (&c);\n")
Ole Troanbad67922020-08-24 12:22:01 +02001562 try:
1563 d = define_hash[s.reply]
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001564 write(
1565 " c = (vl_msg_api_msg_config_t) "
1566 "{{.id = VL_API_{ID} + msg_id_base,\n"
1567 ' .name = "{n}",\n'
1568 " .handler = 0,\n"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001569 " .endian = vl_api_{n}_t_endian,\n"
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001570 " .format_fn = vl_api_{n}_t_format,\n"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001571 " .traced = 1,\n"
1572 " .replay = 1,\n"
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001573 " .tojson = vl_api_{n}_t_tojson,\n"
1574 " .fromjson = vl_api_{n}_t_fromjson,\n"
1575 " .calc_size = vl_api_{n}_t_calc_size,\n"
1576 " .is_autoendian = {auto}}};\n".format(
1577 n=s.reply, ID=s.reply.upper(), auto=d.autoendian
1578 )
1579 )
1580 write(" vl_msg_api_config (&c);\n")
Ole Troanbad67922020-08-24 12:22:01 +02001581 except KeyError:
1582 pass
Ole Troan2a1ca782019-09-19 01:08:30 +02001583
Stanislav Zaikin139b2da2022-07-21 19:06:26 +02001584 try:
1585 if s.stream:
1586 d = define_hash[s.stream_message]
1587 write(
1588 " c = (vl_msg_api_msg_config_t) "
1589 "{{.id = VL_API_{ID} + msg_id_base,\n"
1590 ' .name = "{n}",\n'
1591 " .handler = 0,\n"
1592 " .endian = vl_api_{n}_t_endian,\n"
1593 " .format_fn = vl_api_{n}_t_format,\n"
1594 " .traced = 1,\n"
1595 " .replay = 1,\n"
1596 " .tojson = vl_api_{n}_t_tojson,\n"
1597 " .fromjson = vl_api_{n}_t_fromjson,\n"
1598 " .calc_size = vl_api_{n}_t_calc_size,\n"
1599 " .is_autoendian = {auto}}};\n".format(
1600 n=s.stream_message,
1601 ID=s.stream_message.upper(),
1602 auto=d.autoendian,
1603 )
1604 )
1605 write(" vl_msg_api_config (&c);\n")
1606 except KeyError:
1607 pass
1608
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001609 write(" return msg_id_base;\n")
1610 write("}\n")
Ole Troan2a1ca782019-09-19 01:08:30 +02001611
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001612 severity = {
1613 "error": "VL_COUNTER_SEVERITY_ERROR",
1614 "info": "VL_COUNTER_SEVERITY_INFO",
1615 "warn": "VL_COUNTER_SEVERITY_WARN",
1616 }
Ole Troan148c7b72020-10-07 18:05:37 +02001617
1618 for cnt in counters:
1619 csetname = cnt.name
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001620 write("vlib_error_desc_t {}_error_counters[] = {{\n".format(csetname))
Ole Troan148c7b72020-10-07 18:05:37 +02001621 for c in cnt.block:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001622 write(" {\n")
1623 write(' .name = "{}",\n'.format(c["name"]))
1624 write(' .desc = "{}",\n'.format(c["description"]))
1625 write(" .severity = {},\n".format(severity[c["severity"]]))
1626 write(" },\n")
1627 write("};\n")
Ole Troan2a1ca782019-09-19 01:08:30 +02001628
Ole Troandf87f802020-11-18 19:17:48 +01001629
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001630def generate_c_test_boilerplate(services, defines, file_crc, module, plugin, stream):
1631 """Generate code for legacy style VAT. To be deleted."""
Ole Troan2a1ca782019-09-19 01:08:30 +02001632 write = stream.write
1633
Ole Troandf87f802020-11-18 19:17:48 +01001634 define_hash = {d.name: d for d in defines}
Ole Troan2a1ca782019-09-19 01:08:30 +02001635
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001636 hdr = """\
Ole Troandf87f802020-11-18 19:17:48 +01001637#define vl_endianfun /* define message structures */
Ole Troan2a1ca782019-09-19 01:08:30 +02001638#include "{module}.api.h"
1639#undef vl_endianfun
1640
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001641#define vl_calcsizefun
1642#include "{module}.api.h"
1643#undef vl_calsizefun
1644
Ole Troan2a1ca782019-09-19 01:08:30 +02001645/* instantiate all the print functions we know about */
Ole Troan2a1ca782019-09-19 01:08:30 +02001646#define vl_printfun
1647#include "{module}.api.h"
1648#undef vl_printfun
1649
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001650"""
Ole Troan2a1ca782019-09-19 01:08:30 +02001651
1652 write(hdr.format(module=module))
1653 for s in services:
1654 try:
1655 d = define_hash[s.reply]
Ole Troandf87f802020-11-18 19:17:48 +01001656 except KeyError:
Ole Troan2a1ca782019-09-19 01:08:30 +02001657 continue
1658 if d.manual_print:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001659 write(
1660 "/*\n"
1661 " * Manual definition requested for: \n"
1662 " * vl_api_{n}_t_handler()\n"
1663 " */\n".format(n=s.reply)
1664 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001665 continue
1666 if not define_hash[s.caller].autoreply:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001667 write(
1668 "/* Generation not supported (vl_api_{n}_t_handler()) */\n".format(
1669 n=s.reply
1670 )
1671 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001672 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001673 write("#ifndef VL_API_{n}_T_HANDLER\n".format(n=s.reply.upper()))
1674 write("static void\n")
1675 write("vl_api_{n}_t_handler (vl_api_{n}_t * mp) {{\n".format(n=s.reply))
1676 write(" vat_main_t * vam = {}_test_main.vat_main;\n".format(module))
1677 write(" i32 retval = ntohl(mp->retval);\n")
1678 write(" if (vam->async_mode) {\n")
1679 write(" vam->async_errors += (retval < 0);\n")
1680 write(" } else {\n")
1681 write(" vam->retval = retval;\n")
1682 write(" vam->result_ready = 1;\n")
1683 write(" }\n")
1684 write("}\n")
1685 write("#endif\n")
Ole Troan2a1ca782019-09-19 01:08:30 +02001686
Ole Troanb126ebc2019-10-07 16:22:00 +02001687 for e in s.events:
1688 if define_hash[e].manual_print:
1689 continue
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001690 write("static void\n")
1691 write("vl_api_{n}_t_handler (vl_api_{n}_t * mp) {{\n".format(n=e))
Damjan Marionfe45f8f2022-05-20 16:01:22 +02001692 write(' vlib_cli_output(0, "{n} event called:");\n'.format(n=e))
1693 write(
1694 ' vlib_cli_output(0, "%U", vl_api_{n}_t_format, mp);\n'.format(n=e)
1695 )
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001696 write("}\n")
Ole Troanb126ebc2019-10-07 16:22:00 +02001697
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001698 write("static void\n")
1699 write("setup_message_id_table (vat_main_t * vam, u16 msg_id_base) {\n")
Ole Troan2a1ca782019-09-19 01:08:30 +02001700 for s in services:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001701 write(
Damjan Mariona2eb5072022-05-20 20:06:01 +02001702 " vl_msg_api_config (&(vl_msg_api_msg_config_t){{\n"
1703 " .id = VL_API_{ID} + msg_id_base,\n"
1704 ' .name = "{n}",\n'
1705 " .handler = vl_api_{n}_t_handler,\n"
1706 " .endian = vl_api_{n}_t_endian,\n"
1707 " .format_fn = vl_api_{n}_t_format,\n"
1708 " .size = sizeof(vl_api_{n}_t),\n"
1709 " .traced = 1,\n"
1710 " .tojson = vl_api_{n}_t_tojson,\n"
1711 " .fromjson = vl_api_{n}_t_fromjson,\n"
1712 " .calc_size = vl_api_{n}_t_calc_size,\n"
1713 " }});".format(n=s.reply, ID=s.reply.upper())
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001714 )
1715 write(
1716 ' hash_set_mem (vam->function_by_name, "{n}", api_{n});\n'.format(
1717 n=s.caller
1718 )
1719 )
Ole Troan2a1ca782019-09-19 01:08:30 +02001720 try:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001721 write(
1722 ' hash_set_mem (vam->help_by_name, "{n}", "{help}");\n'.format(
1723 n=s.caller, help=define_hash[s.caller].options["vat_help"]
1724 )
1725 )
Ole Troandf87f802020-11-18 19:17:48 +01001726 except KeyError:
Ole Troan2a1ca782019-09-19 01:08:30 +02001727 pass
1728
Ole Troanb126ebc2019-10-07 16:22:00 +02001729 # Events
1730 for e in s.events:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001731 write(
Damjan Mariona2eb5072022-05-20 20:06:01 +02001732 " vl_msg_api_config (&(vl_msg_api_msg_config_t){{\n"
1733 " .id = VL_API_{ID} + msg_id_base,\n"
1734 ' .name = "{n}",\n'
1735 " .handler = vl_api_{n}_t_handler,\n"
1736 " .endian = vl_api_{n}_t_endian,\n"
1737 " .format_fn = vl_api_{n}_t_format,\n"
1738 " .size = sizeof(vl_api_{n}_t),\n"
1739 " .traced = 1,\n"
1740 " .tojson = vl_api_{n}_t_tojson,\n"
1741 " .fromjson = vl_api_{n}_t_fromjson,\n"
1742 " .calc_size = vl_api_{n}_t_calc_size,\n"
1743 " }});".format(n=e, ID=e.upper())
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001744 )
Ole Troanb126ebc2019-10-07 16:22:00 +02001745
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001746 write("}\n")
1747 write("clib_error_t * vat_plugin_register (vat_main_t *vam)\n")
1748 write("{\n")
1749 write(" {n}_test_main_t * mainp = &{n}_test_main;\n".format(n=module))
1750 write(" mainp->vat_main = vam;\n")
1751 write(
1752 " mainp->msg_id_base = vl_client_get_first_plugin_msg_id "
1753 ' ("{n}_{crc:08x}");\n'.format(n=module, crc=file_crc)
1754 )
1755 write(" if (mainp->msg_id_base == (u16) ~0)\n")
1756 write(
1757 ' return clib_error_return (0, "{} plugin not loaded...");\n'.format(
1758 module
1759 )
1760 )
1761 write(" setup_message_id_table (vam, mainp->msg_id_base);\n")
1762 write("#ifdef VL_API_LOCAL_SETUP_MESSAGE_ID_TABLE\n")
1763 write(" VL_API_LOCAL_SETUP_MESSAGE_ID_TABLE(vam);\n")
1764 write("#endif\n")
1765 write(" return 0;\n")
1766 write("}\n")
Ole Troan2a1ca782019-09-19 01:08:30 +02001767
Ole Troandf87f802020-11-18 19:17:48 +01001768
1769def apifunc(func):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001770 """Check if a method is generated already."""
1771
Ole Troandf87f802020-11-18 19:17:48 +01001772 def _f(module, d, processed, *args):
1773 if d.name in processed:
1774 return None
1775 processed[d.name] = True
1776 return func(module, d, *args)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001777
Ole Troandf87f802020-11-18 19:17:48 +01001778 return _f
1779
1780
1781def c_test_api_service(s, dump, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001782 """Generate JSON code for a service."""
Ole Troandf87f802020-11-18 19:17:48 +01001783 write = stream.write
1784
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001785 req_reply_template = """\
Ole Troandf87f802020-11-18 19:17:48 +01001786static cJSON *
1787api_{n} (cJSON *o)
1788{{
1789 vl_api_{n}_t *mp;
1790 int len;
1791 if (!o) return 0;
1792 mp = vl_api_{n}_t_fromjson(o, &len);
1793 if (!mp) {{
1794 fprintf(stderr, "Failed converting JSON to API\\n");
1795 return 0;
1796 }}
1797
1798 mp->_vl_msg_id = vac_get_msg_index(VL_API_{N}_CRC);
1799 vl_api_{n}_t_endian(mp);
1800 vac_write((char *)mp, len);
Filip Tehlar36217e32021-07-23 08:51:10 +00001801 cJSON_free(mp);
Ole Troandf87f802020-11-18 19:17:48 +01001802
1803 /* Read reply */
1804 char *p;
1805 int l;
1806 vac_read(&p, &l, 5); // XXX: Fix timeout
Ole Troanedc73fd2021-02-17 13:26:53 +01001807 if (p == 0 || l == 0) return 0;
Ole Troandf87f802020-11-18 19:17:48 +01001808 // XXX Will fail in case of event received. Do loop
1809 if (ntohs(*((u16 *)p)) != vac_get_msg_index(VL_API_{R}_CRC)) {{
1810 fprintf(stderr, "Mismatched reply\\n");
1811 return 0;
1812 }}
1813 vl_api_{r}_t *rmp = (vl_api_{r}_t *)p;
1814 vl_api_{r}_t_endian(rmp);
1815 return vl_api_{r}_t_tojson(rmp);
1816}}
1817
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001818"""
1819 dump_details_template = """\
Ole Troandf87f802020-11-18 19:17:48 +01001820static cJSON *
1821api_{n} (cJSON *o)
1822{{
1823 u16 msg_id = vac_get_msg_index(VL_API_{N}_CRC);
1824 int len;
1825 if (!o) return 0;
1826 vl_api_{n}_t *mp = vl_api_{n}_t_fromjson(o, &len);
1827 if (!mp) {{
1828 fprintf(stderr, "Failed converting JSON to API\\n");
1829 return 0;
1830 }}
1831 mp->_vl_msg_id = msg_id;
1832 vl_api_{n}_t_endian(mp);
1833 vac_write((char *)mp, len);
Filip Tehlar36217e32021-07-23 08:51:10 +00001834 cJSON_free(mp);
Ole Troandf87f802020-11-18 19:17:48 +01001835
1836 vat2_control_ping(123); // FIX CONTEXT
1837 cJSON *reply = cJSON_CreateArray();
1838
1839 u16 ping_reply_msg_id = vac_get_msg_index(VL_API_CONTROL_PING_REPLY_CRC);
1840 u16 details_msg_id = vac_get_msg_index(VL_API_{R}_CRC);
1841
1842 while (1) {{
1843 /* Read reply */
1844 char *p;
1845 int l;
1846 vac_read(&p, &l, 5); // XXX: Fix timeout
Ole Troanedc73fd2021-02-17 13:26:53 +01001847 if (p == 0 || l == 0) {{
1848 cJSON_free(reply);
1849 return 0;
1850 }}
Ole Troandf87f802020-11-18 19:17:48 +01001851
1852 /* Message can be one of [_details, control_ping_reply
1853 * or unrelated event]
1854 */
1855 u16 reply_msg_id = ntohs(*((u16 *)p));
1856 if (reply_msg_id == ping_reply_msg_id) {{
1857 break;
1858 }}
1859
1860 if (reply_msg_id == details_msg_id) {{
Ole Troanedc73fd2021-02-17 13:26:53 +01001861 if (l < sizeof(vl_api_{r}_t)) {{
1862 cJSON_free(reply);
1863 return 0;
1864 }}
Ole Troandf87f802020-11-18 19:17:48 +01001865 vl_api_{r}_t *rmp = (vl_api_{r}_t *)p;
1866 vl_api_{r}_t_endian(rmp);
1867 cJSON_AddItemToArray(reply, vl_api_{r}_t_tojson(rmp));
1868 }}
1869 }}
1870 return reply;
1871}}
1872
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001873"""
1874 gets_details_reply_template = """\
Ole Troandf87f802020-11-18 19:17:48 +01001875static cJSON *
1876api_{n} (cJSON *o)
1877{{
1878 u16 msg_id = vac_get_msg_index(VL_API_{N}_CRC);
1879 int len = 0;
1880 if (!o) return 0;
1881 vl_api_{n}_t *mp = vl_api_{n}_t_fromjson(o, &len);
1882 if (!mp) {{
1883 fprintf(stderr, "Failed converting JSON to API\\n");
1884 return 0;
1885 }}
1886 mp->_vl_msg_id = msg_id;
1887
1888 vl_api_{n}_t_endian(mp);
1889 vac_write((char *)mp, len);
Filip Tehlar36217e32021-07-23 08:51:10 +00001890 cJSON_free(mp);
Ole Troandf87f802020-11-18 19:17:48 +01001891
1892 cJSON *reply = cJSON_CreateArray();
1893
1894 u16 reply_msg_id = vac_get_msg_index(VL_API_{R}_CRC);
1895 u16 details_msg_id = vac_get_msg_index(VL_API_{D}_CRC);
1896
1897 while (1) {{
1898 /* Read reply */
1899 char *p;
1900 int l;
1901 vac_read(&p, &l, 5); // XXX: Fix timeout
1902
1903 /* Message can be one of [_details, control_ping_reply
1904 * or unrelated event]
1905 */
1906 u16 msg_id = ntohs(*((u16 *)p));
1907 if (msg_id == reply_msg_id) {{
1908 vl_api_{r}_t *rmp = (vl_api_{r}_t *)p;
1909 vl_api_{r}_t_endian(rmp);
1910 cJSON_AddItemToArray(reply, vl_api_{r}_t_tojson(rmp));
1911 break;
1912 }}
1913
1914 if (msg_id == details_msg_id) {{
1915 vl_api_{d}_t *rmp = (vl_api_{d}_t *)p;
1916 vl_api_{d}_t_endian(rmp);
1917 cJSON_AddItemToArray(reply, vl_api_{d}_t_tojson(rmp));
1918 }}
1919 }}
1920 return reply;
1921}}
1922
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001923"""
Ole Troandf87f802020-11-18 19:17:48 +01001924
1925 if dump:
1926 if s.stream_message:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001927 write(
1928 gets_details_reply_template.format(
1929 n=s.caller,
1930 r=s.reply,
1931 N=s.caller.upper(),
1932 R=s.reply.upper(),
1933 d=s.stream_message,
1934 D=s.stream_message.upper(),
1935 )
1936 )
Ole Troandf87f802020-11-18 19:17:48 +01001937 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001938 write(
1939 dump_details_template.format(
1940 n=s.caller, r=s.reply, N=s.caller.upper(), R=s.reply.upper()
1941 )
1942 )
Ole Troandf87f802020-11-18 19:17:48 +01001943 else:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001944 write(
1945 req_reply_template.format(
1946 n=s.caller, r=s.reply, N=s.caller.upper(), R=s.reply.upper()
1947 )
1948 )
Ole Troandf87f802020-11-18 19:17:48 +01001949
1950
1951def generate_c_test2_boilerplate(services, defines, module, stream):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001952 """Generate code for VAT2 plugin."""
Ole Troandf87f802020-11-18 19:17:48 +01001953 write = stream.write
1954
1955 define_hash = {d.name: d for d in defines}
1956 # replies = {}
1957
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001958 hdr = """\
Ole Troandf87f802020-11-18 19:17:48 +01001959#include <vlibapi/api.h>
1960#include <vlibmemory/api.h>
1961#include <vppinfra/error.h>
1962#include <vnet/ip/ip_format_fns.h>
1963#include <vnet/ethernet/ethernet_format_fns.h>
1964
1965#define vl_typedefs /* define message structures */
Filip Tehlarb7e4d442021-07-08 18:44:19 +00001966#include <vlibmemory/vl_memory_api_h.h>
Florin Corasa1400ce2021-09-15 09:02:08 -07001967#include <vlibmemory/vlib.api_types.h>
1968#include <vlibmemory/vlib.api.h>
Ole Troandf87f802020-11-18 19:17:48 +01001969#undef vl_typedefs
1970
1971#include "{module}.api_enum.h"
1972#include "{module}.api_types.h"
1973
1974#define vl_endianfun /* define message structures */
1975#include "{module}.api.h"
1976#undef vl_endianfun
1977
Klement Sekera9b7e8ac2021-11-22 21:26:20 +01001978#define vl_calcsizefun
1979#include "{module}.api.h"
1980#undef vl_calsizefun
1981
Ole Troandf87f802020-11-18 19:17:48 +01001982#define vl_printfun
1983#include "{module}.api.h"
1984#undef vl_printfun
1985
1986#include "{module}.api_tojson.h"
1987#include "{module}.api_fromjson.h"
1988#include <vpp-api/client/vppapiclient.h>
1989
1990#include <vat2/vat2_helpers.h>
1991
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02001992"""
Ole Troandf87f802020-11-18 19:17:48 +01001993
1994 write(hdr.format(module=module))
1995
1996 for s in services:
1997 if s.reply not in define_hash:
1998 continue
1999 c_test_api_service(s, s.stream, stream)
2000
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002001 write(
2002 "void vat2_register_function(char *, cJSON * (*)(cJSON *), cJSON * (*)(void *), u32);\n"
2003 )
Ole Troandf87f802020-11-18 19:17:48 +01002004 # write('__attribute__((constructor))')
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002005 write("clib_error_t *\n")
2006 write("vat2_register_plugin (void) {\n")
Ole Troandf87f802020-11-18 19:17:48 +01002007 for s in services:
Filip Tehlar36217e32021-07-23 08:51:10 +00002008 if s.reply not in define_hash:
2009 continue
2010 crc = define_hash[s.caller].crc
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002011 write(
2012 ' vat2_register_function("{n}", api_{n}, (cJSON * (*)(void *))vl_api_{n}_t_tojson, 0x{crc:08x});\n'.format(
2013 n=s.caller, crc=crc
2014 )
2015 )
2016 write(" return 0;\n")
2017 write("}\n")
Ole Troandf87f802020-11-18 19:17:48 +01002018
2019
Ole Troan9d420872017-10-12 13:06:35 +02002020#
2021# Plugin entry point
2022#
Nathan Skrzypczak1b299fa2022-06-16 17:00:02 +02002023def run(output_dir, apifilename, s):
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002024 """Main plugin entry point."""
Ole Troan33a58172019-09-04 09:12:29 +02002025 stream = StringIO()
Ole Troan2a1ca782019-09-19 01:08:30 +02002026
Nathan Skrzypczak1b299fa2022-06-16 17:00:02 +02002027 if not output_dir:
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002028 sys.stderr.write("Missing --outputdir argument")
Ole Troan2a1ca782019-09-19 01:08:30 +02002029 return None
2030
Ole Troandf87f802020-11-18 19:17:48 +01002031 basename = os.path.basename(apifilename)
2032 filename, _ = os.path.splitext(basename)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002033 modulename = filename.replace(".", "_")
Nathan Skrzypczak1b299fa2022-06-16 17:00:02 +02002034 filename_enum = os.path.join(output_dir + "/" + basename + "_enum.h")
2035 filename_types = os.path.join(output_dir + "/" + basename + "_types.h")
2036 filename_c = os.path.join(output_dir + "/" + basename + ".c")
2037 filename_c_test = os.path.join(output_dir + "/" + basename + "_test.c")
2038 filename_c_test2 = os.path.join(output_dir + "/" + basename + "_test2.c")
2039 filename_c_tojson = os.path.join(output_dir + "/" + basename + "_tojson.h")
2040 filename_c_fromjson = os.path.join(output_dir + "/" + basename + "_fromjson.h")
Ole Troan2a1ca782019-09-19 01:08:30 +02002041
2042 # Generate separate types file
2043 st = StringIO()
2044 generate_include_types(s, modulename, st)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002045 with open(filename_types, "w") as fd:
Ole Troandf87f802020-11-18 19:17:48 +01002046 st.seek(0)
2047 shutil.copyfileobj(st, fd)
Ole Troan2a1ca782019-09-19 01:08:30 +02002048 st.close()
2049
2050 # Generate separate enum file
2051 st = StringIO()
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002052 st.write("#ifndef included_{}_api_enum_h\n".format(modulename))
2053 st.write("#define included_{}_api_enum_h\n".format(modulename))
Ole Troan2a1ca782019-09-19 01:08:30 +02002054 generate_include_enum(s, modulename, st)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002055 generate_include_counters(s["Counters"], st)
2056 st.write("#endif\n")
2057 with open(filename_enum, "w") as fd:
Ole Troandf87f802020-11-18 19:17:48 +01002058 st.seek(0)
2059 shutil.copyfileobj(st, fd)
Ole Troan2a1ca782019-09-19 01:08:30 +02002060 st.close()
2061
2062 # Generate separate C file
2063 st = StringIO()
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002064 generate_c_boilerplate(
2065 s["Service"], s["Define"], s["Counters"], s["file_crc"], modulename, st
2066 )
2067 with open(filename_c, "w") as fd:
Ole Troandf87f802020-11-18 19:17:48 +01002068 st.seek(0)
Ole Troan2a1ca782019-09-19 01:08:30 +02002069 shutil.copyfileobj(st, fd)
2070 st.close()
2071
2072 # Generate separate C test file
Ole Troan2a1ca782019-09-19 01:08:30 +02002073 st = StringIO()
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002074 plugin = bool("plugin" in apifilename)
2075 generate_c_test_boilerplate(
2076 s["Service"], s["Define"], s["file_crc"], modulename, plugin, st
2077 )
2078 with open(filename_c_test, "w") as fd:
Ole Troandf87f802020-11-18 19:17:48 +01002079 st.seek(0)
Ole Troan2a1ca782019-09-19 01:08:30 +02002080 shutil.copyfileobj(st, fd)
2081 st.close()
Ole Troan33a58172019-09-04 09:12:29 +02002082
Ole Troandf87f802020-11-18 19:17:48 +01002083 # Fully autogenerated VATv2 C test file
2084 st = StringIO()
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002085 generate_c_test2_boilerplate(s["Service"], s["Define"], modulename, st)
2086 with open(filename_c_test2, "w") as fd:
Ole Troandf87f802020-11-18 19:17:48 +01002087 st.seek(0)
2088 shutil.copyfileobj(st, fd)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002089 st.close() #
Ole Troandf87f802020-11-18 19:17:48 +01002090
2091 # Generate separate JSON file
2092 st = StringIO()
2093 generate_tojson(s, modulename, st)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002094 with open(filename_c_tojson, "w") as fd:
Ole Troandf87f802020-11-18 19:17:48 +01002095 st.seek(0)
2096 shutil.copyfileobj(st, fd)
2097 st.close()
2098 st = StringIO()
2099 generate_fromjson(s, modulename, st)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002100 with open(filename_c_fromjson, "w") as fd:
Ole Troandf87f802020-11-18 19:17:48 +01002101 st.seek(0)
2102 shutil.copyfileobj(st, fd)
2103 st.close()
2104
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002105 output = TOP_BOILERPLATE.format(datestring=DATESTRING, input_filename=basename)
2106 output += generate_imports(s["Import"])
Ole Troan9d420872017-10-12 13:06:35 +02002107 output += msg_ids(s)
2108 output += msg_names(s)
2109 output += msg_name_crc_list(s, filename)
Ole Troan2a1ca782019-09-19 01:08:30 +02002110 output += typedefs(modulename)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002111 printfun_types(s["types"], stream, modulename)
2112 printfun(s["Define"], stream, modulename)
Ole Troan33a58172019-09-04 09:12:29 +02002113 output += stream.getvalue()
Ole Troan2a1ca782019-09-19 01:08:30 +02002114 stream.close()
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002115 output += endianfun(s["types"] + s["Define"], modulename)
2116 output += calc_size_fun(s["types"] + s["Define"], modulename)
Ole Troan9d420872017-10-12 13:06:35 +02002117 output += version_tuple(s, basename)
Klement Sekerad9b0c6f2022-04-26 19:02:15 +02002118 output += BOTTOM_BOILERPLATE.format(input_filename=basename, file_crc=s["file_crc"])
Ole Troan9d420872017-10-12 13:06:35 +02002119
2120 return output