src/script/lua_api/l_base.cpp

   1 /*
   2 Minetest
   3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #include "lua_api/l_base.h"
  21 #include "lua_api/l_internal.h"
  22 #include "cpp_api/s_base.h"
  23 #include "content/mods.h"
  24 #include "profiler.h"
  25 #include "server.h"
  26 #include <algorithm>
  27 #include <cmath>
  28
  29 ScriptApiBase *ModApiBase::getScriptApiBase(lua_State *L)
  30 {
  31         // Get server from registry
  32         lua_rawgeti(L, LUA_REGISTRYINDEX, CUSTOM_RIDX_SCRIPTAPI);
  33         ScriptApiBase *sapi_ptr = (ScriptApiBase*) lua_touserdata(L, -1);
  34         lua_pop(L, 1);
  35         return sapi_ptr;
  36 }
  37
  38 Server *ModApiBase::getServer(lua_State *L)
  39 {
  40         return getScriptApiBase(L)->getServer();
  41 }
  42
  43 #ifndef SERVER
  44 Client *ModApiBase::getClient(lua_State *L)
  45 {
  46         return getScriptApiBase(L)->getClient();
  47 }
  48
  49 Game *ModApiBase::getGame(lua_State *L)
  50 {
  51         return getScriptApiBase(L)->getGame();
  52 }
  53 #endif
  54
  55 IGameDef *ModApiBase::getGameDef(lua_State *L)
  56 {
  57         return getScriptApiBase(L)->getGameDef();
  58 }
  59
  60 Environment *ModApiBase::getEnv(lua_State *L)
  61 {
  62         return getScriptApiBase(L)->getEnv();
  63 }
  64
  65 GUIEngine *ModApiBase::getGuiEngine(lua_State *L)
  66 {
  67         return getScriptApiBase(L)->getGuiEngine();
  68 }
  69
  70 std::string ModApiBase::getCurrentModPath(lua_State *L)
  71 {
  72         lua_rawgeti(L, LUA_REGISTRYINDEX, CUSTOM_RIDX_CURRENT_MOD_NAME);
  73         std::string current_mod_name = readParam<std::string>(L, -1, "");
  74         if (current_mod_name.empty())
  75                 return ".";
  76
  77         const ModSpec *mod = getServer(L)->getModSpec(current_mod_name);
  78         if (!mod)
  79                 return ".";
  80
  81         return mod->path;
  82 }
  83
  84
  85 bool ModApiBase::registerFunction(lua_State *L, const char *name,
  86                 lua_CFunction func, int top)
  87 {
  88         // TODO: Check presence first!
  89
  90         lua_pushcfunction(L, func);
  91         lua_setfield(L, top, name);
  92
  93         return true;
  94 }
  95
  96 std::unordered_map<std::string, luaL_Reg> ModApiBase::m_deprecated_wrappers;
  97 bool ModApiBase::m_error_deprecated_calls = false;
  98
  99 int ModApiBase::l_deprecated_function(lua_State *L)
 100 {
 101         thread_local std::vector<u64> deprecated_logged;
 102
 103         u64 start_time = porting::getTimeUs();
 104         lua_Debug ar;
 105
 106         // Get function name for lookup
 107         FATAL_ERROR_IF(!lua_getstack(L, 0, &ar), "lua_getstack() failed");
 108         FATAL_ERROR_IF(!lua_getinfo(L, "n", &ar), "lua_getinfo() failed");
 109
 110         // Combine name with line and script backtrace
 111         FATAL_ERROR_IF(!lua_getstack(L, 1, &ar), "lua_getstack() failed");
 112         FATAL_ERROR_IF(!lua_getinfo(L, "Sl", &ar), "lua_getinfo() failed");
 113
 114         // Get parent class to get the wrappers map
 115         luaL_checktype(L, 1, LUA_TUSERDATA);
 116         void *ud = lua_touserdata(L, 1);
 117         ModApiBase *o = *(ModApiBase**)ud;
 118
 119         // New function and new function name
 120         auto it = o->m_deprecated_wrappers.find(ar.name);
 121
 122         // Get backtrace and hash it to reduce the warning flood
 123         std::string backtrace = ar.short_src;
 124         backtrace.append(":").append(std::to_string(ar.currentline));
 125         u64 hash = murmur_hash_64_ua(backtrace.data(), backtrace.length(), 0xBADBABE);
 126
 127         if (std::find(deprecated_logged.begin(), deprecated_logged.end(), hash)
 128                         == deprecated_logged.end()) {
 129
 130                 deprecated_logged.emplace_back(hash);
 131                 warningstream << "Call to deprecated function '"  << ar.name << "', please use '"
 132                         << it->second.name << "' at " << backtrace << std::endl;
 133
 134                 if (m_error_deprecated_calls)
 135                         script_error(L, LUA_ERRRUN, NULL, NULL);
 136         }
 137
 138         u64 end_time = porting::getTimeUs();
 139         g_profiler->avg("l_deprecated_function", end_time - start_time);
 140
 141         return it->second.func(L);
 142 }
 143
 144 void ModApiBase::markAliasDeprecated(luaL_Reg *reg)
 145 {
 146         std::string value = g_settings->get("deprecated_lua_api_handling");
 147         m_error_deprecated_calls = value == "error";
 148
 149         if (!m_error_deprecated_calls && value != "log")
 150                 return;
 151
 152         const char *last_name = nullptr;
 153         lua_CFunction last_func = nullptr;
 154
 155         // ! Null termination !
 156         while (reg->func) {
 157                 if (last_func == reg->func) {
 158                         // Duplicate found
 159                         luaL_Reg original_reg;
 160                         // Do not inline struct. Breaks MSVC or is error-prone
 161                         original_reg.name = last_name;
 162                         original_reg.func = reg->func;
 163                         m_deprecated_wrappers.emplace(
 164                                 std::pair<std::string, luaL_Reg>(reg->name, original_reg));
 165                         reg->func = l_deprecated_function;
 166                 }
 167
 168                 last_func = reg->func;
 169                 last_name = reg->name;
 170                 ++reg;
 171         }
 172 }