create_lua_library.py 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788
  1. import sys
  2. import CppHeaderParser
  3. import os
  4. import errno
  5. import re
  6. from zipfile import *
  7. import fnmatch
  8. import re
  9. def mkdir_p(path): # Same effect as mkdir -p, create dir and all necessary parent dirs
  10. try:
  11. os.makedirs(path)
  12. except OSError as e:
  13. if e.errno == errno.EEXIST: # Dir already exists; not really an error
  14. pass
  15. else: raise
  16. def template_returnPtrLookupArray(prefix, className, ptr):
  17. out = ""
  18. out += "%sfor i=1,count(%s) do\n" % (prefix, ptr)
  19. out += "%s\tlocal __c = _G[%s](\"__skip_ptr__\")\n" % (prefix, className)
  20. out += "%s\t__c.__ptr = %s[i]\n" % (prefix, ptr)
  21. out += "%s\t%s[i] = __c\n" % (prefix, ptr)
  22. out += "%send\n" % (prefix)
  23. out += "%sreturn %s\n" % (prefix,ptr)
  24. return out
  25. # Note we expect className to be a valid string
  26. def template_returnPtrLookup(prefix, className, ptr):
  27. out = ""
  28. out += "%slocal __c = _G[%s](\"__skip_ptr__\")\n" % (prefix, className)
  29. out += "%s__c.__ptr = %s\n" % (prefix, ptr)
  30. out += "%sreturn __c\n" % (prefix)
  31. return out
  32. def template_quote(str):
  33. return "\"%s\"" % str;
  34. def cleanDocs(docs):
  35. return docs.replace("/*", "").replace("*/", "").replace("*", "").replace("\n", "").replace("\r", "").replace("::", ".")
  36. def toLuaType(t):
  37. return t.replace("void", "nil").replace("int", "Integer").replace("bool", "Boolean")
  38. # FIXME: Some "unsigned int *" functions are still being generated on the polycode API?
  39. def typeFilter(ty):
  40. ty = ty.replace("Polycode::", "")
  41. ty = ty.replace("std::", "")
  42. ty = ty.replace("const", "")
  43. ty = ty.replace("inline", "")
  44. ty = ty.replace("static", "")
  45. ty = ty.replace("virtual", "")
  46. ty = ty.replace("&", "")
  47. ty = re.sub(r'^.*\sint\s*$', 'int', ty) # eg "unsigned int"
  48. ty = re.sub(r'^.*\slong\s*$', 'int', ty)
  49. ty = re.sub(r'^.*\sfloat\s*$', 'Number', ty)
  50. ty = re.sub(r'^.*\sdouble\s*$', 'Number', ty) # eg "long double"
  51. ty = ty.replace("unsigned", "int")
  52. ty = ty.replace("long", "int")
  53. ty = ty.replace("float", "Number")
  54. ty = ty.replace("double", "Number")
  55. ty = ty.replace(" ", "") # Not very safe!
  56. return ty
  57. def createLUABindings(inputPath, prefix, mainInclude, libSmallName, libName, apiPath, apiClassPath, includePath, sourcePath, inheritInModuleFiles):
  58. wrappersHeaderOut = "" # Def: Global C++ *LUAWrappers.h
  59. cppRegisterOut = "" # Def: Global C++ *LUA.cpp
  60. cppLoaderOut = "" # Def: Global C++ *LUA.cpp
  61. luaDocOut = ""
  62. luaIndexOut = "" # Def: Global Lua everything-gets-required-from-this-file file
  63. # Header boilerplate for wrappersHeaderOut and cppRegisterOut
  64. cppRegisterOut += "#include \"%sLUA.h\"\n" % (prefix)
  65. cppRegisterOut += "#include \"%sLUAWrappers.h\"\n" % (prefix)
  66. cppRegisterOut += "#include \"PolyCoreServices.h\"\n\n"
  67. cppRegisterOut += "using namespace Polycode;\n\n"
  68. cppRegisterOut += "int luaopen_%s(lua_State *L) {\n" % (prefix)
  69. if prefix != "Polycode":
  70. cppRegisterOut += "CoreServices *inst = (CoreServices*) *((void**)lua_touserdata(L, 1));\n"
  71. cppRegisterOut += "CoreServices::setInstance(inst);\n"
  72. cppRegisterOut += "\tstatic const struct luaL_reg %sLib [] = {" % (libSmallName)
  73. wrappersHeaderOut += "#pragma once\n\n"
  74. wrappersHeaderOut += "extern \"C\" {\n\n"
  75. wrappersHeaderOut += "#include <stdio.h>\n"
  76. wrappersHeaderOut += "#include \"lua.h\"\n"
  77. wrappersHeaderOut += "#include \"lualib.h\"\n"
  78. wrappersHeaderOut += "#include \"lauxlib.h\"\n"
  79. wrappersHeaderOut += "} // extern \"C\" \n\n"
  80. luaDocOut += "<?xml version=\"1.0\" ?>\n"
  81. luaDocOut += "<docs>\n"
  82. luaDocOut += "<classes>\n"
  83. # Get list of headers to create bindings from
  84. inputPathIsDir = os.path.isdir(inputPath)
  85. if inputPathIsDir:
  86. files = os.listdir(inputPath)
  87. else:
  88. files = []
  89. with open(inputPath) as f:
  90. for line in f.readlines():
  91. files.append(line.strip()) # Strip whitespace, path/
  92. filteredFiles = []
  93. for fileName in files:
  94. if inputPathIsDir:
  95. fileName = "%s/%s" % (inputPath, fileName)
  96. head, tail = os.path.split(fileName)
  97. ignore = ["PolyGLSLProgram", "PolyGLSLShader", "PolyGLSLShaderModule", "PolyWinCore", "PolyCocoaCore", "PolyAGLCore", "PolySDLCore", "Poly_iPhone", "PolyGLES1Renderer", "PolyGLRenderer", "tinyxml", "tinystr", "OpenGLCubemap", "PolyiPhoneCore", "PolyGLES1Texture", "PolyGLTexture", "PolyGLVertexBuffer", "PolyThreaded", "PolyGLHeaders", "GLee", "PolyPeer", "PolySocket", "PolyClient", "PolyServer", "PolyServerWorld", "OSFILE", "OSFileEntry", "OSBasics", "PolyLogger"]
  98. if tail.split(".")[1] == "h" and tail.split(".")[0] not in ignore:
  99. filteredFiles.append(fileName)
  100. wrappersHeaderOut += "#include \"%s\"\n" % (tail)
  101. wrappersHeaderOut += "\nusing namespace std;\n\n"
  102. wrappersHeaderOut += "\nnamespace Polycode {\n\n"
  103. # list of classes that don't get the garbage collection in their meta table
  104. disable_gc = ["Entity", "ScreenEntity", "ScreenShape", "ScreenMesh", "ScreenLabel", "SceneLabel", "SceneMesh", "Screen", "Scene", "Texture", "Image", "Camera", "ScreenParticleEmitter", "SceneParticleEmitter", "Mesh", "Vertex", "Polygon", "Polycode::Polygon", "Material", "ScenePrimitive", "SceneLine", "SceneLight", "SceneSound", "ScreenImage", "SceneEntity"]
  105. # Special case: If we are building the Polycode library itself, inject the LuaEventHandler class.
  106. # Note: so that event callbacks can work, any object inheriting from EventHandler will secretly
  107. # be modified to actually inherit from LuaEventHandler instead.
  108. if prefix == "Polycode":
  109. wrappersHeaderOut += "class LuaEventHandler : public EventHandler {\n"
  110. wrappersHeaderOut += "public:\n"
  111. wrappersHeaderOut += " LuaEventHandler() : EventHandler() {}\n"
  112. wrappersHeaderOut += " void handleEvent(Event *e) {\n"
  113. wrappersHeaderOut += " lua_getfield(L, LUA_GLOBALSINDEX, \"EventHandler\" );\n"
  114. wrappersHeaderOut += " lua_getfield(L, -1, \"__handleEvent\");\n"
  115. wrappersHeaderOut += " lua_rawgeti( L, LUA_REGISTRYINDEX, wrapperIndex );\n"
  116. wrappersHeaderOut += " PolyBase **userdataPtr = (PolyBase**)lua_newuserdata(L, sizeof(PolyBase*));\n"
  117. wrappersHeaderOut += " *userdataPtr = (PolyBase*)e;\n"
  118. # wrappersHeaderOut += " lua_getfield (L, LUA_GLOBALSINDEX, \"__customError\");\n"
  119. # wrappersHeaderOut += " int errH = lua_gettop(L);\n"
  120. # wrappersHeaderOut += " lua_pcall(L, 2, 0, errH);\n"
  121. wrappersHeaderOut += " lua_pcall(L, 2, 0, 0);\n"
  122. wrappersHeaderOut += " }\n"
  123. wrappersHeaderOut += " int wrapperIndex;\n"
  124. wrappersHeaderOut += " lua_State *L;\n"
  125. wrappersHeaderOut += "};\n\n"
  126. # Iterate, process each input file
  127. for fileName in filteredFiles:
  128. # "Package owned" classes that ship with Polycode
  129. inheritInModule = ["PhysicsSceneEntity", "CollisionScene", "CollisionSceneEntity"]
  130. # A file or comma-separated list of files can be given to specify classes which are "package owned"
  131. # and should not be inherited out of Polycode/. The files should contain one class name per line,
  132. # and the class name may be prefixed with a path (which will be ignored).
  133. if inheritInModuleFiles:
  134. for moduleFileName in inheritInModuleFiles.split(","):
  135. with open(moduleFileName) as f:
  136. for line in f.readlines():
  137. inheritInModule.append(line.strip().split("/",1)[-1]) # Strip whitespace, path/
  138. print "Parsing %s" % fileName
  139. try: # One input file parse.
  140. f = open(fileName) # Def: Input file handle
  141. contents = f.read().replace("_PolyExport", "") # Def: Input file contents, strip out "_PolyExport"
  142. cppHeader = CppHeaderParser.CppHeader(contents, "string") # Def: Input file contents, parsed structure
  143. ignore_classes = ["PolycodeShaderModule", "Object", "Threaded", "OpenGLCubemap", "PolyBase"]
  144. # Iterate, check each class in this file.
  145. for ckey in cppHeader.classes:
  146. print ">> Parsing class %s" % ckey
  147. c = cppHeader.classes[ckey] # Def: The class structure
  148. luaClassBindingOut = "" # Def: The local lua file to generate for this class.
  149. inherits = False
  150. parentClass = ""
  151. if len(c["inherits"]) > 0: # Does this class have parents?
  152. if c["inherits"][0]["class"] not in ignore_classes:
  153. if c["inherits"][0]["class"] in inheritInModule: # Parent class is in this module
  154. luaClassBindingOut += "require \"%s/%s\"\n\n" % (prefix, c["inherits"][0]["class"])
  155. else: # Parent class is in Polycore
  156. luaClassBindingOut += "require \"Polycode/%s\"\n\n" % (c["inherits"][0]["class"])
  157. if (ckey == "ScreenParticleEmitter" or ckey == "SceneParticleEmitter"):
  158. luaClassBindingOut += "require \"Polycode/ParticleEmitter\"\n\n"
  159. luaClassBindingOut += "class \"%s\" (%s)\n\n" % (ckey, c["inherits"][0]["class"])
  160. parentClass = c["inherits"][0]["class"]
  161. inherits = True
  162. if inherits == False: # Class does not have parents
  163. luaClassBindingOut += "class \"%s\"\n\n" % ckey
  164. if ckey in ignore_classes:
  165. continue
  166. if len(c["methods"]["public"]) < 2: # Used to, this was a continue.
  167. print("Warning: Lua-binding class with less than two methods")
  168. continue # FIXME: Remove this, move any non-compileable classes into ignore_classes
  169. luaDocOut += "\t<class name=\"%s\">\n" % (ckey)
  170. if 'doxygen' in c:
  171. luaDocOut += "\t\t<desc><![CDATA[%s]]></desc>\n" % (cleanDocs(c['doxygen']))
  172. parsed_methods = [] # Def: List of discovered methods
  173. ignore_methods = ["readByte32", "readByte16", "getCustomEntitiesByType", "Core", "Renderer", "Shader", "Texture", "handleEvent", "secondaryHandler", "getSTLString"]
  174. luaClassBindingOut += "\n\n"
  175. classProperties = [] # Def: List of found property structures ("properties" meaning "data members")
  176. for pp in c["properties"]["public"]:
  177. pp["type"] = pp["type"].replace("Polycode::", "")
  178. pp["type"] = pp["type"].replace("std::", "")
  179. if pp["type"].find("POLYIGNORE") != -1:
  180. continue
  181. if pp["type"].find("static ") != -1: # If static. FIXME: Static doesn't work?
  182. if "defaltValue" in pp: # FIXME: defaltValue is misspelled.
  183. luaClassBindingOut += "%s.%s = %s\n" % (ckey, pp["name"], pp["defaltValue"])
  184. else: # FIXME: Nonstatic method ? variable ?? found.
  185. #there are some bugs in the class parser that cause it to return junk
  186. if pp["type"].find("*") == -1 and pp["type"].find("vector") == -1 and pp["name"] != "setScale" and pp["name"] != "setPosition" and pp["name"] != "BUFFER_CACHE_PRECISION" and not pp["name"].isdigit():
  187. classProperties.append(pp)
  188. # Iterate over properties, creating getters
  189. pidx = 0 # Def: Count of properties processed so far
  190. # TODO: Remove or generalize ParticleEmitter special casing. These lines are marked with #SPEC
  191. luaDocOut += "\t\t<members>\n"
  192. numGetVars = 0
  193. if len(classProperties) > 0: # If there are properties, add index lookup to the metatable
  194. luaClassBindingOut += "function %s:__getvar(name)\n" % ckey
  195. # Iterate over property structures, creating if/else clauses for each.
  196. # TODO: Could a table be more appropriate for
  197. for pp in classProperties:
  198. if pp["name"] == "" or pp["array"] == 1:
  199. continue
  200. numGetVars = numGetVars + 1
  201. pp["type"] = typeFilter(pp["type"])
  202. if pidx == 0:
  203. luaClassBindingOut += "\tif name == \"%s\" then\n" % (pp["name"])
  204. else:
  205. luaClassBindingOut += "\telseif name == \"%s\" then\n" % (pp["name"])
  206. # Generate Lua side of binding:
  207. # If type is a primitive such as Number/String/int/bool
  208. if pp["type"] == "Number" or pp["type"] == "String" or pp["type"] == "int" or pp["type"] == "bool":
  209. luaClassBindingOut += "\t\treturn %s.%s_get_%s(self.__ptr)\n" % (libName, ckey, pp["name"])
  210. # If type is a particle emitter, specifically #SPEC
  211. elif (ckey == "ScreenParticleEmitter" or ckey == "SceneParticleEmitter") and pp["name"] == "emitter":
  212. luaClassBindingOut += "\t\tlocal ret = %s(\"__skip_ptr__\")\n" % (pp["type"])
  213. luaClassBindingOut += "\t\tret.__ptr = self.__ptr\n"
  214. luaClassBindingOut += "\t\treturn ret\n"
  215. # If type is a class
  216. else:
  217. luaClassBindingOut += "\t\tlocal retVal = %s.%s_get_%s(self.__ptr)\n" % (libName, ckey, pp["name"])
  218. luaClassBindingOut += template_returnPtrLookup("\t\t", template_quote(pp["type"]), "retVal")
  219. luaDocOut += "\t\t\t<member name=\"%s\" type=\"%s\">\n" % (pp["name"], toLuaType(typeFilter(pp["type"])))
  220. if 'doxygen' in pp:
  221. luaDocOut += "\t\t\t\t<desc><![CDATA[%s]]></desc>\n" % (cleanDocs(pp['doxygen']))
  222. luaDocOut += "\t\t\t</member>\n"
  223. # Generate C++ side of binding:
  224. if not ((ckey == "ScreenParticleEmitter" or ckey == "SceneParticleEmitter") and pp["name"] == "emitter"): #SPEC
  225. cppRegisterOut += "\t\t{\"%s_get_%s\", %s_%s_get_%s},\n" % (ckey, pp["name"], libName, ckey, pp["name"])
  226. wrappersHeaderOut += "static int %s_%s_get_%s(lua_State *L) {\n" % (libName, ckey, pp["name"])
  227. wrappersHeaderOut += "\tluaL_checktype(L, 1, LUA_TUSERDATA);\n"
  228. wrappersHeaderOut += "\t%s *inst = (%s*) *((PolyBase**)lua_touserdata(L, 1));\n" % (ckey, ckey)
  229. outfunc = "this_shouldnt_happen"
  230. retFunc = ""
  231. if pp["type"] == "Number":
  232. outfunc = "lua_pushnumber"
  233. if pp["type"] == "String":
  234. outfunc = "lua_pushstring"
  235. retFunc = ".c_str()"
  236. if pp["type"] == "int":
  237. outfunc = "lua_pushinteger"
  238. if pp["type"] == "bool":
  239. outfunc = "lua_pushboolean"
  240. if pp["type"] == "Number" or pp["type"] == "String" or pp["type"] == "int" or pp["type"] == "bool":
  241. wrappersHeaderOut += "\t%s(L, inst->%s%s);\n" % (outfunc, pp["name"], retFunc)
  242. else:
  243. wrappersHeaderOut += "\tPolyBase **userdataPtr = (PolyBase**)lua_newuserdata(L, sizeof(PolyBase*));\n"
  244. wrappersHeaderOut += "\t*userdataPtr = (PolyBase*)&inst->%s%s;\n" % (pp["name"], retFunc)
  245. wrappersHeaderOut += "\treturn 1;\n"
  246. wrappersHeaderOut += "}\n\n"
  247. # Success
  248. pidx = pidx + 1
  249. if numGetVars != 0:
  250. luaClassBindingOut += "\tend\n"
  251. if inherits:
  252. luaClassBindingOut += "\tif %s[\"__getvar\"] ~= nil then\n" % (parentClass)
  253. luaClassBindingOut += "\t\treturn %s.__getvar(self, name)\n" % (parentClass)
  254. luaClassBindingOut += "\tend\n"
  255. luaClassBindingOut += "end\n"
  256. luaDocOut += "\t\t</members>\n"
  257. luaClassBindingOut += "\n\n"
  258. # Iterate over properties again, creating setters
  259. pidx = 0 # Def: Count of
  260. if len(classProperties) > 0: # If there are properties, add index setter to the metatable
  261. luaClassBindingOut += "function %s:__setvar(name,value)\n" % ckey
  262. for pp in classProperties:
  263. if pp["name"] == "" or pp["array"] == 1:
  264. continue
  265. pp["type"] = typeFilter(pp["type"])
  266. # If type is a primitive: Create lua and C++ sides at the same time.
  267. if pp["type"] == "Number" or pp["type"] == "String" or pp["type"] == "int" or pp["type"] == "bool":
  268. if pidx == 0:
  269. luaClassBindingOut += "\tif name == \"%s\" then\n" % (pp["name"])
  270. else:
  271. luaClassBindingOut += "\telseif name == \"%s\" then\n" % (pp["name"])
  272. luaClassBindingOut += "\t\t%s.%s_set_%s(self.__ptr, value)\n" % (libName, ckey, pp["name"])
  273. luaClassBindingOut += "\t\treturn true\n"
  274. cppRegisterOut += "\t\t{\"%s_set_%s\", %s_%s_set_%s},\n" % (ckey, pp["name"], libName, ckey, pp["name"])
  275. wrappersHeaderOut += "static int %s_%s_set_%s(lua_State *L) {\n" % (libName, ckey, pp["name"])
  276. wrappersHeaderOut += "\tluaL_checktype(L, 1, LUA_TUSERDATA);\n"
  277. wrappersHeaderOut += "\t%s *inst = (%s*) *((PolyBase**)lua_touserdata(L, 1));\n" % (ckey, ckey)
  278. outfunc = "this_shouldnt_happen"
  279. if pp["type"] == "Number":
  280. outfunc = "lua_tonumber"
  281. if pp["type"] == "String":
  282. outfunc = "lua_tostring"
  283. if pp["type"] == "int":
  284. outfunc = "lua_tointeger"
  285. if pp["type"] == "bool":
  286. outfunc = "lua_toboolean"
  287. wrappersHeaderOut += "\t%s param = %s(L, 2);\n" % (pp["type"], outfunc)
  288. wrappersHeaderOut += "\tinst->%s = param;\n" % (pp["name"])
  289. wrappersHeaderOut += "\treturn 0;\n"
  290. wrappersHeaderOut += "}\n\n"
  291. pidx = pidx + 1 # Success
  292. # Notice: Setters for object types are not created.
  293. if pidx != 0:
  294. luaClassBindingOut += "\tend\n"
  295. if inherits:
  296. luaClassBindingOut += "\tif %s[\"__setvar\"] ~= nil then\n" % (parentClass)
  297. luaClassBindingOut += "\t\treturn %s.__setvar(self, name, value)\n" % (parentClass)
  298. luaClassBindingOut += "\telse\n"
  299. luaClassBindingOut += "\t\treturn false\n"
  300. luaClassBindingOut += "\tend\n"
  301. else:
  302. luaClassBindingOut += "\treturn false\n"
  303. luaClassBindingOut += "end\n"
  304. # Iterate over methods
  305. luaClassBindingOut += "\n\n"
  306. luaDocOut += "\t\t<methods>\n"
  307. for pm in c["methods"]["public"]:
  308. # Skip argument-overloaded methods and operators.
  309. # TODO: Instead of skipping arguemnt overloads, have special behavior.
  310. # TODO: Instead of skipping operators, add to metatable.
  311. if pm["name"] in parsed_methods or pm["name"].find("operator") > -1 or pm["rtnType"].find("POLYIGNORE") > -1 or pm["name"] in ignore_methods:
  312. continue
  313. # Skip destructors and methods which return templates.
  314. # TODO: Special-case certain kind of vector<>s?
  315. if pm["name"] == "~"+ckey or pm["name"] == "CoreServices":
  316. continue
  317. if pm["rtnType"].find("std::vector") > -1:
  318. vectorReturnClass = pm["rtnType"].replace("std::vector<", "").replace(">","").replace(" ", "")
  319. luaDocOut += "\t\t\t<method name=\"%s\" return_array=\"true\" return_type=\"%s\">\n" % (pm["name"], toLuaType(typeFilter(vectorReturnClass).replace("*", "")))
  320. else:
  321. luaDocOut += "\t\t\t<method name=\"%s\" return_type=\"%s\">\n" % (pm["name"], toLuaType(typeFilter(pm["rtnType"].replace("*", ""))))
  322. docs = None
  323. if 'doxygen' in pm:
  324. if pm['doxygen'].find("@return") > -1:
  325. docs = cleanDocs(pm['doxygen']).split("@return")[0].split("@param")
  326. else:
  327. docs = cleanDocs(pm['doxygen']).split("@param")
  328. luaDocOut += "\t\t\t\t<desc><![CDATA[%s]]></desc>\n" % (docs[0])
  329. if len(pm["parameters"]) > 0:
  330. luaDocOut += "\t\t\t\t<params>\n"
  331. paramIndex = 0
  332. for param in pm["parameters"]:
  333. if "name" in param:
  334. if not param.has_key("type"):
  335. continue
  336. if param["type"] == "0":
  337. continue
  338. if param["type"].find("vector<") != -1:
  339. vectorClass = param["type"].replace("std::vector<", "").replace(">","").replace(" ", "")
  340. luaDocOut += "\t\t\t\t\t<param name=\"%s\" param_array=\"true\" type=\"%s\">\n" % (param["name"], toLuaType(vectorClass.replace("*","")))
  341. else:
  342. luaDocOut += "\t\t\t\t\t<param name=\"%s\" type=\"%s\">\n" % (param["name"], toLuaType(typeFilter(param["type"]).replace("*","")))
  343. if docs != None:
  344. if len(docs) > paramIndex+1:
  345. cdoc = docs[paramIndex+1].split()
  346. cdoc.pop(0)
  347. luaDocOut += "\t\t\t\t\t\t<desc><![CDATA[%s]]></desc>\n" % (" ".join(cdoc).replace("\n", ""))
  348. luaDocOut += "\t\t\t\t\t</param>\n"
  349. paramIndex = paramIndex + 1
  350. luaDocOut += "\t\t\t\t</params>\n"
  351. luaDocOut += "\t\t\t</method>\n"
  352. basicType = False
  353. voidRet = False
  354. vectorReturn = False
  355. vectorReturnClass = ""
  356. # Def: True if method takes a lua_State* as argument (i.e.: no preprocessing by us)
  357. rawMethod = len(pm["parameters"]) > 0 and pm["parameters"][0].get("type","").find("lua_State") > -1
  358. # Basic setup, C++ side: Add function to registry and start building wrapper function.
  359. if pm["name"] == ckey: # It's a constructor
  360. cppRegisterOut += "\t\t{\"%s\", %s_%s},\n" % (ckey, libName, ckey)
  361. wrappersHeaderOut += "static int %s_%s(lua_State *L) {\n" % (libName, ckey)
  362. idx = 1 # Def: Current stack depth (TODO: Figure out, is this correct?)
  363. else: # It's not a constructor
  364. cppRegisterOut += "\t\t{\"%s_%s\", %s_%s_%s},\n" % (ckey, pm["name"], libName, ckey, pm["name"])
  365. wrappersHeaderOut += "static int %s_%s_%s(lua_State *L) {\n" % (libName, ckey, pm["name"])
  366. # Skip static methods (TODO: Figure out, why is this being done here?). # FIXME
  367. if pm["rtnType"].find("static ") == -1:
  368. wrappersHeaderOut += "\tluaL_checktype(L, 1, LUA_TUSERDATA);\n"
  369. wrappersHeaderOut += "\t%s *inst = (%s*) *((PolyBase**)lua_touserdata(L, 1));\n" % (ckey, ckey)
  370. idx = 2
  371. else:
  372. idx = 1
  373. if rawMethod:
  374. wrappersHeaderOut += "\treturn inst->%s(L);\n" % (pm["name"])
  375. else:
  376. # Generate C++ side parameter pushing
  377. paramlist = []
  378. lparamlist = []
  379. for param in pm["parameters"]:
  380. if not param.has_key("type"):
  381. continue
  382. if param["type"] == "0":
  383. continue
  384. param["type"] = typeFilter(param["type"])
  385. param["name"] = param["name"].replace("end", "_end").replace("repeat", "_repeat")
  386. if"type" in param:
  387. luatype = "LUA_TUSERDATA"
  388. checkfunc = "lua_isuserdata"
  389. if param["type"].find("*") > -1:
  390. luafunc = "(%s) *((PolyBase**)lua_touserdata" % (param["type"].replace("Polygon", "Polycode::Polygon").replace("Rectangle", "Polycode::Rectangle"))
  391. elif param["type"].find("&") > -1:
  392. luafunc = "*(%s*) *((PolyBase**)lua_touserdata" % (param["type"].replace("const", "").replace("&", "").replace("Polygon", "Polycode::Polygon").replace("Rectangle", "Polycode::Rectangle"))
  393. else:
  394. luafunc = "*(%s*) *((PolyBase**)lua_touserdata" % (param["type"].replace("Polygon", "Polycode::Polygon").replace("Rectangle", "Polycode::Rectangle"))
  395. lend = ".__ptr"
  396. luafuncsuffix = ")"
  397. if param["type"] == "int" or param["type"] == "unsigned int" or param["type"] == "short":
  398. luafunc = "lua_tointeger"
  399. luatype = "LUA_TNUMBER"
  400. checkfunc = "lua_isnumber"
  401. luafuncsuffix = ""
  402. lend = ""
  403. if param["type"] == "bool":
  404. luafunc = "lua_toboolean"
  405. luatype = "LUA_TBOOLEAN"
  406. checkfunc = "lua_isboolean"
  407. luafuncsuffix = ""
  408. lend = ""
  409. if param["type"] == "Number" or param["type"] == "float" or param["type"] == "double":
  410. luatype = "LUA_TNUMBER"
  411. luafunc = "lua_tonumber"
  412. checkfunc = "lua_isnumber"
  413. luafuncsuffix = ""
  414. lend = ""
  415. if param["type"] == "String":
  416. luatype = "LUA_TSTRING"
  417. luafunc = "lua_tostring"
  418. checkfunc = "lua_isstring"
  419. luafuncsuffix = ""
  420. lend = ""
  421. param["type"] = param["type"].replace("Polygon", "Polycode::Polygon").replace("Rectangle", "Polycode::Rectangle")
  422. if "defaltValue" in param:
  423. if checkfunc != "lua_isuserdata" or (checkfunc == "lua_isuserdata" and param["defaltValue"] == "NULL"):
  424. #param["defaltValue"] = param["defaltValue"].replace(" 0f", ".0f")
  425. param["defaltValue"] = param["defaltValue"].replace(": :", "::")
  426. #param["defaltValue"] = param["defaltValue"].replace("0 ", "0.")
  427. param["defaltValue"] = re.sub(r'([0-9]+) ([0-9])+', r'\1.\2', param["defaltValue"])
  428. wrappersHeaderOut += "\t%s %s;\n" % (param["type"], param["name"])
  429. wrappersHeaderOut += "\tif(%s(L, %d)) {\n" % (checkfunc, idx)
  430. wrappersHeaderOut += "\t\t%s = %s(L, %d)%s;\n" % (param["name"], luafunc, idx, luafuncsuffix)
  431. wrappersHeaderOut += "\t} else {\n"
  432. wrappersHeaderOut += "\t\t%s = %s;\n" % (param["name"], param["defaltValue"])
  433. wrappersHeaderOut += "\t}\n"
  434. else:
  435. wrappersHeaderOut += "\tluaL_checktype(L, %d, %s);\n" % (idx, luatype);
  436. if param["type"] == "String":
  437. wrappersHeaderOut += "\t%s %s = String(%s(L, %d));\n" % (param["type"], param["name"], luafunc, idx)
  438. else:
  439. wrappersHeaderOut += "\t%s %s = %s(L, %d)%s;\n" % (param["type"], param["name"], luafunc, idx,luafuncsuffix)
  440. else:
  441. wrappersHeaderOut += "\tluaL_checktype(L, %d, %s);\n" % (idx, luatype);
  442. if param["type"] == "String":
  443. wrappersHeaderOut += "\t%s %s = String(%s(L, %d));\n" % (param["type"], param["name"], luafunc, idx)
  444. else:
  445. wrappersHeaderOut += "\t%s %s = %s(L, %d)%s;\n" % (param["type"], param["name"], luafunc, idx, luafuncsuffix)
  446. paramlist.append(param["name"])
  447. lparamlist.append(param["name"]+lend)
  448. idx = idx +1 # Param parse success-- mark the increased stack
  449. # Generate C++-side method call / generate return value
  450. if pm["name"] == ckey: # If constructor
  451. if ckey == "EventHandler": # See LuaEventHandler above
  452. wrappersHeaderOut += "\tLuaEventHandler *inst = new LuaEventHandler();\n"
  453. wrappersHeaderOut += "\tinst->wrapperIndex = luaL_ref(L, LUA_REGISTRYINDEX );\n"
  454. wrappersHeaderOut += "\tinst->L = L;\n"
  455. else:
  456. wrappersHeaderOut += "\t%s *inst = new %s(%s);\n" % (ckey, ckey, ", ".join(paramlist))
  457. wrappersHeaderOut += "\tPolyBase **userdataPtr = (PolyBase**)lua_newuserdata(L, sizeof(PolyBase*));\n"
  458. wrappersHeaderOut += "\t*userdataPtr = (PolyBase*)inst;\n"
  459. wrappersHeaderOut += "\tluaL_getmetatable(L, \"%s.%s\");\n" % (libName, ckey)
  460. wrappersHeaderOut += "\tlua_setmetatable(L, -2);\n"
  461. wrappersHeaderOut += "\treturn 1;\n"
  462. else: #If non-constructor
  463. if pm["rtnType"].find("static ") == -1: # If non-static
  464. call = "inst->%s(%s)" % (pm["name"], ", ".join(paramlist))
  465. else: # If static (FIXME: Why doesn't this work?)
  466. call = "%s::%s(%s)" % (ckey, pm["name"], ", ".join(paramlist))
  467. #check if returning a template
  468. if pm["rtnType"].find("<") > -1:
  469. #if returning a vector, convert to lua table
  470. if pm["rtnType"].find("std::vector") > -1:
  471. vectorReturnClass = pm["rtnType"].replace("std::vector<", "").replace(">","").replace(" ", "")
  472. if vectorReturnClass.find("&") == -1 and vectorReturnClass.find("*") > -1: #FIXME: return references to std::vectors and basic types
  473. vectorReturn = True
  474. wrappersHeaderOut += "\tstd::vector<%s> retVector = %s;\n" % (vectorReturnClass,call)
  475. wrappersHeaderOut += "\tlua_newtable(L);\n"
  476. wrappersHeaderOut += "\tfor(int i=0; i < retVector.size(); i++) {\n"
  477. wrappersHeaderOut += "\t\tPolyBase **userdataPtr = (PolyBase**)lua_newuserdata(L, sizeof(PolyBase*));\n"
  478. wrappersHeaderOut += "\t\t*userdataPtr = (PolyBase*)retVector[i];\n"
  479. wrappersHeaderOut += "\t\tlua_rawseti(L, -2, i+1);\n"
  480. wrappersHeaderOut += "\t}\n"
  481. wrappersHeaderOut += "\treturn 1;\n"
  482. # else If void-typed:
  483. elif pm["rtnType"] == "void" or pm["rtnType"] == "static void" or pm["rtnType"] == "virtual void" or pm["rtnType"] == "inline void":
  484. wrappersHeaderOut += "\t%s;\n" % (call)
  485. basicType = True
  486. voidRet = True
  487. vectorReturn = False
  488. wrappersHeaderOut += "\treturn 0;\n" # 0 arguments returned
  489. else: # If there is a return value:
  490. # What type is the return value? Default to pointer
  491. outfunc = "this_shouldnt_happen"
  492. retFunc = ""
  493. basicType = False
  494. vectorReturn = False
  495. if pm["rtnType"] == "Number" or pm["rtnType"] == "inline Number":
  496. outfunc = "lua_pushnumber"
  497. basicType = True
  498. if pm["rtnType"] == "String" or pm["rtnType"] == "static String": # TODO: Path for STL strings?
  499. outfunc = "lua_pushstring"
  500. basicType = True
  501. retFunc = ".c_str()"
  502. if pm["rtnType"] == "int" or pm["rtnType"] == "unsigned int" or pm["rtnType"] == "static int" or pm["rtnType"] == "size_t" or pm["rtnType"] == "static size_t" or pm["rtnType"] == "long" or pm["rtnType"] == "unsigned int" or pm["rtnType"] == "static long" or pm["rtnType"] == "short":
  503. outfunc = "lua_pushinteger"
  504. basicType = True
  505. if pm["rtnType"] == "bool" or pm["rtnType"] == "static bool" or pm["rtnType"] == "virtual bool":
  506. outfunc = "lua_pushboolean"
  507. basicType = True
  508. if pm["rtnType"].find("*") > -1: # Returned var is definitely a pointer.
  509. wrappersHeaderOut += "\tPolyBase *ptrRetVal = (PolyBase*)%s%s;\n" % (call, retFunc)
  510. wrappersHeaderOut += "\tif(ptrRetVal == NULL) {\n"
  511. wrappersHeaderOut += "\t\tlua_pushnil(L);\n"
  512. wrappersHeaderOut += "\t} else {\n"
  513. wrappersHeaderOut += "\t\tPolyBase **userdataPtr = (PolyBase**)lua_newuserdata(L, sizeof(PolyBase*));\n"
  514. wrappersHeaderOut += "\t\t*userdataPtr = ptrRetVal;\n"
  515. wrappersHeaderOut += "\t}\n"
  516. elif basicType == True: # Returned var has been flagged as a recognized primitive type
  517. wrappersHeaderOut += "\t%s(L, %s%s);\n" % (outfunc, call, retFunc)
  518. else: # Some static object is being returned. Convert it to a pointer, then return that.
  519. className = pm["rtnType"].replace("const", "").replace("&", "").replace("inline", "").replace("virtual", "").replace("static", "")
  520. if className == "Polygon": # Deal with potential windows.h conflict
  521. className = "Polycode::Polygon"
  522. if className == "Rectangle":
  523. className = "Polycode::Rectangle"
  524. if className == "Polycode : : Rectangle":
  525. className = "Polycode::Rectangle"
  526. wrappersHeaderOut += "\t%s *retInst = new %s();\n" % (className, className)
  527. wrappersHeaderOut += "\t*retInst = %s;\n" % (call)
  528. wrappersHeaderOut += "\tPolyBase **userdataPtr = (PolyBase**)lua_newuserdata(L, sizeof(PolyBase*));\n"
  529. wrappersHeaderOut += "\tluaL_getmetatable(L, \"%s.%s\");\n" % (libName, className)
  530. wrappersHeaderOut += "\tlua_setmetatable(L, -2);\n"
  531. wrappersHeaderOut += "\t*userdataPtr = (PolyBase*)retInst;\n"
  532. wrappersHeaderOut += "\treturn 1;\n"
  533. wrappersHeaderOut += "}\n\n" # Close out C++ generation
  534. # Now generate the Lua side method.
  535. if rawMethod:
  536. luaClassBindingOut += "function %s:%s(...)\n" % (ckey, pm["name"])
  537. luaClassBindingOut += "\treturn %s.%s_%s(self.__ptr, ...)\n" % (libName, ckey, pm["name"])
  538. luaClassBindingOut += "end\n"
  539. elif pm["name"] == ckey: # Constructors
  540. luaClassBindingOut += "function %s:%s(...)\n" % (ckey, ckey)
  541. luaClassBindingOut += "\tlocal arg = {...}\n"
  542. if inherits:
  543. luaClassBindingOut += "\tif type(arg[1]) == \"table\" and count(arg) == 1 then\n"
  544. luaClassBindingOut += "\t\tif \"\"..arg[1].__classname == \"%s\" then\n" % (c["inherits"][0]["class"])
  545. luaClassBindingOut += "\t\t\tself.__ptr = arg[1].__ptr\n"
  546. luaClassBindingOut += "\t\t\treturn\n"
  547. luaClassBindingOut += "\t\tend\n"
  548. luaClassBindingOut += "\tend\n"
  549. luaClassBindingOut += "\tfor k,v in pairs(arg) do\n"
  550. luaClassBindingOut += "\t\tif type(v) == \"table\" then\n"
  551. luaClassBindingOut += "\t\t\tif v.__ptr ~= nil then\n"
  552. luaClassBindingOut += "\t\t\t\targ[k] = v.__ptr\n"
  553. luaClassBindingOut += "\t\t\tend\n"
  554. luaClassBindingOut += "\t\tend\n"
  555. luaClassBindingOut += "\tend\n"
  556. luaClassBindingOut += "\tif self.__ptr == nil and arg[1] ~= \"__skip_ptr__\" then\n"
  557. if ckey == "EventHandler": # See LuaEventHandler above
  558. luaClassBindingOut += "\t\tself.__ptr = %s.%s(self)\n" % (libName, ckey)
  559. else:
  560. luaClassBindingOut += "\t\tself.__ptr = %s.%s(unpack(arg))\n" % (libName, ckey)
  561. luaClassBindingOut += "\tend\n"
  562. luaClassBindingOut += "end\n\n"
  563. else: # Non-constructors.
  564. if pm["rtnType"].find("static ") == -1: # Non-static method
  565. luaClassBindingOut += "function %s:%s(%s)\n" % (ckey, pm["name"], ", ".join(paramlist))
  566. if len(lparamlist):
  567. luaClassBindingOut += "\tlocal retVal = %s.%s_%s(self.__ptr, %s)\n" % (libName, ckey, pm["name"], ", ".join(lparamlist))
  568. else:
  569. luaClassBindingOut += "\tlocal retVal = %s.%s_%s(self.__ptr)\n" % (libName, ckey, pm["name"])
  570. else: # Static method
  571. luaClassBindingOut += "function %s.%s(%s)\n" % (ckey, pm["name"], ", ".join(paramlist))
  572. if len(lparamlist):
  573. luaClassBindingOut += "\tlocal retVal = %s.%s_%s(%s)\n" % (libName, ckey, pm["name"], ", ".join(lparamlist))
  574. else:
  575. luaClassBindingOut += "\tlocal retVal = %s.%s_%s()\n" % (libName, ckey, pm["name"])
  576. if not voidRet: # Was there a return value?
  577. if basicType == True: # Yes, a primitive
  578. luaClassBindingOut += "\treturn retVal\n"
  579. else: # Yes, a pointer was returned
  580. luaClassBindingOut += "\tif retVal == nil then return nil end\n"
  581. if vectorReturn == True:
  582. className = vectorReturnClass.replace("*", "")
  583. luaClassBindingOut += template_returnPtrLookupArray("\t",template_quote(className),"retVal")
  584. else:
  585. className = pm["rtnType"].replace("const", "").replace("&", "").replace("inline", "").replace("virtual", "").replace("static", "").replace("*","").replace(" ", "")
  586. luaClassBindingOut += template_returnPtrLookup("\t",template_quote(className),"retVal")
  587. luaClassBindingOut += "end\n\n" # Close out Lua generation
  588. parsed_methods.append(pm["name"]) # Method parse success
  589. luaDocOut += "\t\t</methods>\n"
  590. # With methods out of the way, do some final cleanup:
  591. # user pointer metatable creation in C++
  592. cppLoaderOut += "\n\tluaL_newmetatable(L, \"%s.%s\");\n" % (libName, ckey)
  593. if ckey not in disable_gc:
  594. cppLoaderOut += "\tlua_pushstring(L, \"__gc\");\n"
  595. cppLoaderOut += "\tlua_pushcfunction(L, %s_delete_%s);\n" % (libName, ckey)
  596. cppLoaderOut += "\tlua_settable(L, -3);\n"
  597. # Delete method (C++ side)
  598. cppRegisterOut += "\t\t{\"delete_%s\", %s_delete_%s},\n" % (ckey, libName, ckey)
  599. wrappersHeaderOut += "static int %s_delete_%s(lua_State *L) {\n" % (libName, ckey)
  600. wrappersHeaderOut += "\tluaL_checktype(L, 1, LUA_TUSERDATA);\n"
  601. wrappersHeaderOut += "\t%s *inst = (%s*) *((PolyBase**)lua_touserdata(L, 1));\n" % (ckey, ckey)
  602. wrappersHeaderOut += "\tdelete inst;\n"
  603. wrappersHeaderOut += "\treturn 0;\n"
  604. wrappersHeaderOut += "}\n\n"
  605. # Delete method (Lua side)
  606. luaClassBindingOut += "function %s:__delete()\n" % (ckey)
  607. luaClassBindingOut += "\t%s.delete_%s(self.__ptr)\n" % (libName, ckey)
  608. luaClassBindingOut += "end\n"
  609. if ckey == "EventHandler": # See LuaEventHandler above
  610. luaClassBindingOut += "\n\n"
  611. luaClassBindingOut += "function EventHandler:__handleEvent(event)\n"
  612. luaClassBindingOut += "\tevt = _G[\"Event\"](\"__skip_ptr__\")\n"
  613. luaClassBindingOut += "\tevt.__ptr = event\n"
  614. luaClassBindingOut += "\tself:handleEvent(evt)\n"
  615. #luaClassBindingOut += "\tself:handleEvent(event)\n"
  616. luaClassBindingOut += "end\n\n"
  617. # Let's use this opportunity to put in some other "generated" utility functions.
  618. luaClassBindingOut += "function __ptrToTable(className, ptr)\n"
  619. luaClassBindingOut += template_returnPtrLookup("\t","className","ptr")
  620. luaClassBindingOut += "end\n\n"
  621. # Add class to lua index file
  622. luaIndexOut += "require \"%s/%s\"\n" % (prefix, ckey)
  623. # Write lua file
  624. mkdir_p(apiClassPath)
  625. fout = open("%s/%s.lua" % (apiClassPath, ckey), "w")
  626. fout.write(luaClassBindingOut)
  627. luaDocOut += "\t</class>\n"
  628. except CppHeaderParser.CppParseError, e: # One input file parse; failed.
  629. print e
  630. sys.exit(1)
  631. luaDocOut += "</classes>\n"
  632. luaDocOut += "</docs>\n"
  633. # Footer boilerplate for wrappersHeaderOut and cppRegisterOut.
  634. wrappersHeaderOut += "} // namespace Polycode\n"
  635. cppRegisterOut += "\t\t{NULL, NULL}\n"
  636. cppRegisterOut += "\t};\n"
  637. cppRegisterOut += "\tluaL_openlib(L, \"%s\", %sLib, 0);\n" % (libName, libSmallName)
  638. cppRegisterOut += cppLoaderOut
  639. cppRegisterOut += "\treturn 1;\n"
  640. cppRegisterOut += "}"
  641. cppRegisterHeaderOut = "" # Def: Global C++ *LUA.h
  642. cppRegisterHeaderOut += "#pragma once\n"
  643. cppRegisterHeaderOut += "#include <%s>\n" % (mainInclude)
  644. cppRegisterHeaderOut += "extern \"C\" {\n"
  645. cppRegisterHeaderOut += "#include <stdio.h>\n"
  646. cppRegisterHeaderOut += "#include \"lua.h\"\n"
  647. cppRegisterHeaderOut += "#include \"lualib.h\"\n"
  648. cppRegisterHeaderOut += "#include \"lauxlib.h\"\n"
  649. cppRegisterHeaderOut += "int _PolyExport luaopen_%s(lua_State *L);\n" % (prefix)
  650. cppRegisterHeaderOut += "}\n"
  651. # Write out global files
  652. mkdir_p(includePath)
  653. mkdir_p(apiPath)
  654. mkdir_p(sourcePath)
  655. fout = open("%s/%sLUA.h" % (includePath, prefix), "w")
  656. fout.write(cppRegisterHeaderOut)
  657. luaDocPath = "../../../Documentation/Lua/xml"
  658. fout = open("%s/%s.xml" % (luaDocPath, prefix), "w")
  659. fout.write(luaDocOut)
  660. fout = open("%s/%s.lua" % (apiPath, prefix), "w")
  661. fout.write(luaIndexOut)
  662. fout = open("%s/%sLUAWrappers.h" % (includePath, prefix), "w")
  663. fout.write(wrappersHeaderOut)
  664. fout = open("%s/%sLUA.cpp" % (sourcePath, prefix), "w")
  665. fout.write(cppRegisterOut)
  666. # Create .pak zip archive
  667. pattern = '*.lua'
  668. os.chdir(apiPath)
  669. if libName == "Polycore":
  670. with ZipFile("api.pak", 'w') as myzip:
  671. for root, dirs, files in os.walk("."):
  672. for filename in fnmatch.filter(files, pattern):
  673. myzip.write(os.path.join(root, filename))
  674. if len(sys.argv) < 10:
  675. print ("Usage:\n%s [input path] [prefix] [main include] [lib small name] [lib name] [api path] [api class-path] [include path] [source path] [inherit-in-module-file path (optional)]" % (sys.argv[0]))
  676. sys.exit(1)
  677. else:
  678. createLUABindings(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5], sys.argv[6], sys.argv[7], sys.argv[8], sys.argv[9], sys.argv[10] if len(sys.argv)>10 else None)