Archive/TombEngine
0
0
Fork 0
mirror of https://github.com/TombEngine/TombEngine.git synced 2025-05-01 01:08:01 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions
TombEngine/TR5Main/Scripting/ScriptAssert.cpp

57 lines
1.2 KiB
C++
Raw Normal View History

Add ScriptAssert. This is to be used when an error is discovered in a Lua Script. The var ScriptErrorMode refers to the error mode the user has chosen (silent, warn, terminate). At the moment this is hardcoded but will soon become editable to a LD via settings. ScriptAssert will read this variable and take the appropriate action when an assert is failed. IGNORE will do nothing (we should make a note in the documentation that this should almost certainly not be used by the LD if they can avoid it). WARN will call TENLog with LogLevel::Warn. TERMINATE will throw a TENScriptException, where it will be caught at GameMain, where TENLog will be called. There are circumstances where we will HAVE to terminate, even if the user has opted not to (i.e. errors where there is nothing sensible that can be done, such as syntax errors that would terminate Lua anyway). For these, we can pass in ERROR_MODE::TERMINATE as the last variable.
2021-08-04 16:18:52 +01:00
#include "framework.h"
#include "ScriptAssert.h"
Make ScriptErrorMode static.
2021-08-04 16:51:58 +01:00
static ERROR_MODE ScriptErrorMode = ERROR_MODE::WARN;
Add ScriptAssert. This is to be used when an error is discovered in a Lua Script. The var ScriptErrorMode refers to the error mode the user has chosen (silent, warn, terminate). At the moment this is hardcoded but will soon become editable to a LD via settings. ScriptAssert will read this variable and take the appropriate action when an assert is failed. IGNORE will do nothing (we should make a note in the documentation that this should almost certainly not be used by the LD if they can avoid it). WARN will call TENLog with LogLevel::Warn. TERMINATE will throw a TENScriptException, where it will be caught at GameMain, where TENLog will be called. There are circumstances where we will HAVE to terminate, even if the user has opted not to (i.e. errors where there is nothing sensible that can be done, such as syntax errors that would terminate Lua anyway). For these, we can pass in ERROR_MODE::TERMINATE as the last variable.
2021-08-04 16:18:52 +01:00
Add ScriptWarn and SetErrorMode. SetErrorMode is called via Lua in settings.lua to allow us or the LD to choose between the three ERROR_MODEs for script asserts. ScriptWarn is for when we want to follow up on a failed assert in ERROR_MODE::WARN. e.g. if the player gives in an invalid HP value, we would ScriptWarn to tell them that the HP is being set to zero instead. If we added this information in ScriptAssert, we would end up displaying this message in TERMINATE mode, too - which is incorrect, since we won't have set the HP to zero, as we will have terminated the game.
2021-08-06 16:43:01 +01:00
void ScriptWarn(std::string const& msg)
{
switch (ScriptErrorMode)
{
case ERROR_MODE::TERMINATE:
case ERROR_MODE::WARN:
TENLog(msg, LogLevel::Warning, LogConfig::All);
break;
}
}
Add ScriptAssert. This is to be used when an error is discovered in a Lua Script. The var ScriptErrorMode refers to the error mode the user has chosen (silent, warn, terminate). At the moment this is hardcoded but will soon become editable to a LD via settings. ScriptAssert will read this variable and take the appropriate action when an assert is failed. IGNORE will do nothing (we should make a note in the documentation that this should almost certainly not be used by the LD if they can avoid it). WARN will call TENLog with LogLevel::Warn. TERMINATE will throw a TENScriptException, where it will be caught at GameMain, where TENLog will be called. There are circumstances where we will HAVE to terminate, even if the user has opted not to (i.e. errors where there is nothing sensible that can be done, such as syntax errors that would terminate Lua anyway). For these, we can pass in ERROR_MODE::TERMINATE as the last variable.
2021-08-04 16:18:52 +01:00
bool ScriptAssert(bool cond, std::string const& msg, std::optional<ERROR_MODE> forceMode)
{
if (!cond)
{
ERROR_MODE mode = forceMode ? *forceMode : ScriptErrorMode;
switch (mode)
{
case ERROR_MODE::WARN:
TENLog(msg, LogLevel::Warning, LogConfig::All);
break;
case ERROR_MODE::TERMINATE:
throw TENScriptException(msg);
break;
}
}
return cond;
}
Add ScriptWarn and SetErrorMode. SetErrorMode is called via Lua in settings.lua to allow us or the LD to choose between the three ERROR_MODEs for script asserts. ScriptWarn is for when we want to follow up on a failed assert in ERROR_MODE::WARN. e.g. if the player gives in an invalid HP value, we would ScriptWarn to tell them that the HP is being set to zero instead. If we added this information in ScriptAssert, we would end up displaying this message in TERMINATE mode, too - which is incorrect, since we won't have set the HP to zero, as we will have terminated the game.
2021-08-06 16:43:01 +01:00
void SetErrorMode(std::string const& mode)
{
std::string noCase{ mode };
std::transform(std::cbegin(noCase), std::cend(noCase), std::begin(noCase), [](unsigned char c) {return std::tolower(c); });
if (noCase == "silent")
{
ScriptErrorMode = ERROR_MODE::SILENT;
}
else if (noCase == "warn")
{
ScriptErrorMode = ERROR_MODE::WARN;
}
else if (noCase == "terminate")
{
ScriptErrorMode = ERROR_MODE::TERMINATE;
}
else
{
TENLog("Wrong error mode set - valid settings are \"silent\", \"warn\" and \"terminate\"; defaulting to \"warn\".", LogLevel::Warning);
}
}
Reference in a new issue Copy permalink