refactor(lua2dox): format with stylua

scripts/lua2dox.lua

@@ -132,26 +132,24 @@ function TCore_Clock.getTimeStamp(this,T0)
   return os.date('%c %Z', t0)
 end
 
-
 --! \brief write to stdout
 local function TCore_IO_write(Str)
-  if (Str) then
+  if Str then
     io.write(Str)
   end
 end
 
 --! \brief write to stdout
 local function TCore_IO_writeln(Str)
-  if (Str) then
+  if Str then
     io.write(Str)
   end
-  io.write("\n")
+  io.write('\n')
 end
 
-
 --! \brief trims a string
 local function string_trim(Str)
-  return Str:match("^%s*(.-)%s*$")
+  return Str:match('^%s*(.-)%s*$')
 end
 
 --! \brief split a string
@@ -162,11 +160,11 @@ end
 ---@return string[]
 local function string_split(Str, Pattern)
   local splitStr = {}
-  local fpat = "(.-)" .. Pattern
+  local fpat = '(.-)' .. Pattern
   local last_end = 1
   local str, e, cap = string.find(Str, fpat, 1)
   while str do
-    if str ~= 1 or cap ~= "" then
+    if str ~= 1 or cap ~= '' then
       table.insert(splitStr, cap)
     end
     last_end = e + 1
@@ -179,7 +177,6 @@ local function string_split(Str, Pattern)
   return splitStr
 end
 
-
 --! \class TCore_Commandline
 --! \brief reads/parses commandline
 local TCore_Commandline = class()
@@ -371,7 +368,7 @@ local function checkComment4fn(Fn_magic,MagicLines)
   return fn_magic
 end
 
-local types = {"number", "string", "table", "list", "boolean", "function"}
+local types = { 'number', 'string', 'table', 'list', 'boolean', 'function' }
 
 --! \brief run the filter
 function TLua2DoX_filter.readfile(this, AppStamp, Filename)
@@ -379,7 +376,7 @@ function TLua2DoX_filter.readfile(this,AppStamp,Filename)
   local outStream = TStream_Write()
   this.outStream = outStream -- save to this obj
 
-  if (inStream:getContents(Filename)) then
+  if inStream:getContents(Filename) then
     -- output the file
     local line
     local fn_magic -- function name/def from  magic comment
@@ -414,22 +411,23 @@ function TLua2DoX_filter.readfile(this,AppStamp,Filename)
           local magic_split = string_split(magic, ' ')
           if magic_split[1] == 'param' then
             for _, type in ipairs(types) do
-              magic = magic:gsub("^param%s+([a-zA-Z_?]+)%s+.*%((" .. type .. ")%)", "param %1 %2" )
+              magic = magic:gsub('^param%s+([a-zA-Z_?]+)%s+.*%((' .. type .. ')%)', 'param %1 %2')
-              magic = magic:gsub("^param%s+([a-zA-Z_?]+)%s+.*%((" .. type .. "|nil)%)", "param %1 %2" )
+              magic =
+                magic:gsub('^param%s+([a-zA-Z_?]+)%s+.*%((' .. type .. '|nil)%)', 'param %1 %2')
             end
             magic_split = string_split(magic, ' ')
           elseif magic_split[1] == 'return' then
             for _, type in ipairs(types) do
-              magic = magic:gsub("^return%s+.*%((" .. type .. ")%)", "return %1" )
+              magic = magic:gsub('^return%s+.*%((' .. type .. ')%)', 'return %1')
-              magic = magic:gsub("^return%s+.*%((" .. type .. "|nil)%)", "return %1" )
+              magic = magic:gsub('^return%s+.*%((' .. type .. '|nil)%)', 'return %1')
             end
             magic_split = string_split(magic, ' ')
           end
 
-          if magic_split[1] == "generic" then
+          if magic_split[1] == 'generic' then
-            local generic_name, generic_type = line:match("@generic%s*(%w+)%s*:?%s*(.*)")
+            local generic_name, generic_type = line:match('@generic%s*(%w+)%s*:?%s*(.*)')
-            if generic_type == "" then
+            if generic_type == '' then
-              generic_type = "any"
+              generic_type = 'any'
             end
             generic[generic_name] = generic_type
           else
@@ -440,9 +438,9 @@ function TLua2DoX_filter.readfile(this,AppStamp,Filename)
 
             if magic_split[type_index] then
               -- fix optional parameters
-              if magic_split[type_index] and magic_split[2]:find("%?$") then
+              if magic_split[type_index] and magic_split[2]:find('%?$') then
-                if not magic_split[type_index]:find("nil") then
+                if not magic_split[type_index]:find('nil') then
-                  magic_split[type_index] = magic_split[type_index] .. "|nil"
+                  magic_split[type_index] = magic_split[type_index] .. '|nil'
                 end
                 magic_split[2] = magic_split[2]:sub(1, -2)
               end
@@ -454,8 +452,10 @@ function TLua2DoX_filter.readfile(this,AppStamp,Filename)
               end
               -- surround some types by ()
               for _, type in ipairs(types) do
-                magic_split[type_index] = magic_split[type_index]:gsub("^(" .. type .. "|nil):?$", "(%1)")
+                magic_split[type_index] =
-                magic_split[type_index] = magic_split[type_index]:gsub("^(" .. type .. "):?$", "(%1)")
+                  magic_split[type_index]:gsub('^(' .. type .. '|nil):?$', '(%1)')
+                magic_split[type_index] =
+                  magic_split[type_index]:gsub('^(' .. type .. '):?$', '(%1)')
               end
             end
 
@@ -471,7 +471,7 @@ function TLua2DoX_filter.readfile(this,AppStamp,Filename)
           line = string.sub(line, 5) -- nibble head
           local comment = ''
           local closeSquare, hitend, thisComment
-          while (not hitend) and (not inStream:eof()) do
+          while not hitend and (not inStream:eof()) do
             closeSquare = string.find(line, ']]')
             if not closeSquare then -- need to look on another line
               thisComment = line .. '\n'
@@ -537,24 +537,27 @@ function TLua2DoX_filter.readfile(this,AppStamp,Filename)
             end
 
             -- Big hax
-            if string.find(fn, ":") then
+            if string.find(fn, ':') then
               -- TODO: We need to add a first parameter of "SELF" here
               -- local colon_place = string.find(fn, ":")
               -- local name = string.sub(fn, 1, colon_place)
-              fn = fn:gsub(":", ".", 1)
+              fn = fn:gsub(':', '.', 1)
-              outStream:writeln("/// @param self")
+              outStream:writeln('/// @param self')
 
-              local paren_start = string.find(fn, "(", 1, true)
+              local paren_start = string.find(fn, '(', 1, true)
-              local paren_finish = string.find(fn, ")", 1, true)
+              local paren_finish = string.find(fn, ')', 1, true)
 
               -- Nothing in between the parens
               local comma
               if paren_finish == paren_start + 1 then
-                comma = ""
+                comma = ''
               else
-                comma = ", "
+                comma = ', '
               end
-              fn = string.sub(fn, 1, paren_start) .. "self" .. comma .. string.sub(fn, paren_start + 1)
+              fn = string.sub(fn, 1, paren_start)
+                .. 'self'
+                .. comma
+                .. string.sub(fn, paren_start + 1)
             end
 
             -- add vanilla function
@@ -601,8 +604,7 @@ function TApp.init(this)
 end
 
 function TApp.getRunStamp(this)
-  return this.name .. ' (' .. this.version .. ') '
+  return this.name .. ' (' .. this.version .. ') ' .. this.timestamp
-  .. this.timestamp
 end
 
 function TApp.getVersion(this)
@@ -642,5 +644,4 @@ else
   filter:readfile(appStamp, filename)
 end
 
-
 --eof