generate-binding-glue.py

   1 #!/usr/bin/python3
   2
   3 #
   4 # Copyright (C) 2017 Mentor Graphics Development (Deutschland) GmbH
   5 #
   6 # Licensed under the Apache License, Version 2.0 (the "License");
   7 # you may not use this file except in compliance with the License.
   8 # You may obtain a copy of the License at
   9 #
  10 #      http://www.apache.org/licenses/LICENSE-2.0
  11 #
  12 # Unless required by applicable law or agreed to in writing, software
  13 # distributed under the License is distributed on an "AS IS" BASIS,
  14 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15 # See the License for the specific language governing permissions and
  16 # limitations under the License.
  17 #
  18
  19 import sys
  20
  21 OUT = sys.stdout
  22
  23 def set_output(f):
  24     global OUT
  25     OUT = f
  26
  27 def p(*args):
  28     OUT.write('\n'.join(args))
  29     OUT.write('\n')
  30
  31 def emit_func_impl(api, f):
  32     args = f.get('args', [])
  33     if len(args) > 0:
  34         p('   json_object *jreq = afb_req_json(req);', '')
  35         for arg in args:
  36             arg['jtype'] = arg.get('jtype', arg['type']) # add jtype default
  37             p('   json_object *j_%(name)s = nullptr;' % arg,
  38               '   if (! json_object_object_get_ex(jreq, "%(name)s", &j_%(name)s)) {' % arg,
  39               '      afb_req_fail(req, "failed", "Need %(type)s argument %(name)s");' % arg,
  40               '      return;',
  41               '   }',
  42               '   %(type)s a_%(name)s = json_object_get_%(jtype)s(j_%(name)s);' % arg, '')
  43     p('   auto ret = %(api)s' % api + '%(name)s(' % f + ', '.join(map(lambda x: 'a_' + x['name'], args)) + ');')
  44     p('   if (ret.is_err()) {',
  45       '      afb_req_fail(req, "failed", ret.unwrap_err());',
  46       '      return;',
  47       '   }', '')
  48     p('   afb_req_success(req, ret.unwrap(), "success");')
  49
  50 def emit_func(api, f):
  51     p('void %(impl_name)s(afb_req req) noexcept {' % f)
  52     p('   std::lock_guard<std::mutex> guard(binding_m);')
  53     p('   if (g_afb_instance == nullptr) {',
  54       '      afb_req_fail(req, "failed", "Binding not initialized, did the compositor die?");',
  55       '      return;',
  56       '   }', '',
  57       '   try {', '   // BEGIN impl')
  58     emit_func_impl(api, f)
  59     p('   // END impl',
  60       '   } catch (std::exception &e) {',
  61       '      afb_req_fail_f(req, "failed", "Uncaught exception while calling %(name)s: %%s", e.what());' % f,
  62       '      return;',
  63       '   }', '')
  64     p('}', '')
  65
  66 def emit_afb_verbs(api):
  67     p('const struct afb_verb_v2 %(name)s_verbs[] = {' % api)
  68     for f in api['functions']:
  69         p('   { "%(name)s", %(impl_name)s, nullptr, nullptr, AFB_SESSION_NONE },' % f)
  70     p('   {}', '};')
  71
  72 def emit_binding(api):
  73     p('namespace {', '')
  74     for func in api['functions']:
  75         emit_func(api, func)
  76     p('} // namespace', '')
  77     emit_afb_verbs(api)
  78
  79 def generate_names(api):
  80     for f in api['functions']:
  81         f['impl_name'] = '%s_%s_thunk' % (api['name'], f['name'])
  82
  83 def emit_afb_api(api):
  84     p('#include "result.hpp"', '')
  85     p('#include <json-c/json.h>', '')
  86     p('namespace wm {', '')
  87     p('struct App;', '')
  88     p('struct binding_api {')
  89     p('   typedef wm::result<json_object *> result_type;')
  90     p('   struct wm::App *app;')
  91     p('   void send_event(char const *evname, char const *label);')
  92     for f in api['functions']:
  93         p('   result_type %(name)s(' % f + ', '.join(map(lambda x: '%(type)s %(name)s' % x, f.get('args', []))) + ');')
  94     p('};', '')
  95     p('} // namespace wm')
  96
  97 # names must always be valid in c and unique for each function (that is its arguments)
  98 # arguments will be looked up from json request, range checking needs to be implemented
  99 # by the actual API call
 100 API = {
 101         'name': 'winman',
 102         'api': 'g_afb_instance->app.api.', # where are our API functions
 103         'functions': [
 104             {
 105                 'name': 'request_surface',
 106                 #'return_type': 'int', # Or do they return all just some json?
 107                 'args': [ # describes the functions arguments, and their names as found in the json request
 108                     { 'name': 'drawing_name', 'type': 'char const*', 'jtype': 'string' },
 109                 ],
 110             },
 111             {
 112                 'name': 'activate_surface',
 113                 'args': [
 114                     { 'name': 'drawing_name', 'type': 'char const*', 'jtype': 'string' },
 115                 ],
 116             },
 117             {
 118                 'name': 'deactivate_surface',
 119                 'args': [
 120                     { 'name': 'drawing_name', 'type': 'char const*', 'jtype': 'string' },
 121                 ],
 122             },
 123             {
 124                 'name': 'enddraw',
 125                 'args': [
 126                     { 'name': 'drawing_name', 'type': 'char const*', 'jtype': 'string' },
 127                 ],
 128             },
 129             { 'name': 'list_drawing_names', },
 130
 131             { 'name': 'debug_status', },
 132             { 'name': 'debug_layers', },
 133             { 'name': 'debug_surfaces', },
 134             { 'name': 'debug_terminate' },
 135         ]
 136 }
 137
 138 def main():
 139     with open('afb_binding_glue.inl', 'w') as out:
 140         set_output(out)
 141         p('// This file was generated, do not edit', '')
 142         generate_names(API)
 143         emit_binding(API)
 144     with open('afb_binding_api.hpp', 'w') as out:
 145         set_output(out)
 146         p('// This file was generated, do not edit', '')
 147         emit_afb_api(API)
 148
 149 __name__ == '__main__' and main()