feat(scripting/cpp/utils): JSON API

Author: skuzzis

docgen/data/static/cpp/utils/json/_category_.json

@@ -0,0 +1,8 @@
+{
+    "label": "JSON",
+    "position": 1,
+    "link": {
+        "type": "generated-index",
+        "description": "A list of API functions for Swiftly JSON Utils."
+    }
+}

docgen/data/static/cpp/utils/json/create.md

@@ -0,0 +1,10 @@
+# Create
+
+This function create a JSON Object.
+
+### Syntax
+
+```cpp
+@returns JSONObject*
+json->Create()
+```

docgen/data/static/cpp/utils/json/getting-started.md

@@ -0,0 +1,18 @@
+---
+sidebar_position: 1
+---
+
+# Getting started
+
+To use the Swiftly JSON system you need the following code in your plugin.
+
+```cpp
+JSON *json = nullptr;
+
+void OnProgramLoad(const char *pluginName, const char *mainFilePath)
+{
+    ...
+    json = new JSON();
+    ...
+}
+```

docgen/data/static/cpp/utils/json/jsonobject/_category_.json

@@ -0,0 +1,8 @@
+{
+    "label": "JSON Object",
+    "position": 1,
+    "link": {
+        "type": "generated-index",
+        "description": "A list of API functions for Swiftly JSON Object."
+    }
+}

docgen/data/static/cpp/utils/json/jsonobject/api.md

@@ -0,0 +1,17 @@
+# API
+
+To access the JSON Object you need to use the following syntax:
+
+```cpp
+@returns rapidjson::Document
+jsonobject->document
+```
+
+To use the JSON API you need to use the RapidJSON's API.
+
+This can be found at the following URL: [https://rapidjson.org](https://rapidjson.org)
+
+### Useful links
+
+- [RapidJSON Features](https://rapidjson.org/md_doc_features.html)
+- [RapidJSON Tutorial](https://rapidjson.org/md_doc_tutorial.html)

docgen/data/static/cpp/utils/json/parse.md

@@ -0,0 +1,10 @@
+# Parse
+
+This function parses a JSON string and creates an object from it. If it fails it prints a message in console.
+
+### Syntax
+
+```cpp
+@returns JSONObject*
+json->Parse(std::string jsonstr)
+```

plugin_files/scripting/includes/swiftly/swiftly_scripting_utils.cpp

@@ -26,4 +26,27 @@ int GetPlayerId(const char *str, bool matchbots)
 void CreateThread(std::function<void()> fn)
 {
     std::thread(fn).detach();
+}
+
+bool JSONObject::Parse(std::string str)
+{
+    document.Parse(str.c_str());
+    return (document.HasParseError());
+}
+
+const char *JSONObject::GetParseError()
+{
+    if (document.HasParseError())
+        return GetParseError_En(document.GetParseError());
+    else
+        return "";
+}
+
+const char *JSONObject::Encode()
+{
+    rapidjson::StringBuffer buffer;
+    rapidjson::Writer<rapidjson::StringBuffer> writer(buffer);
+    document.Accept(writer);
+    const char *encoded = buffer.GetString();
+    return encoded;
 }

plugin_files/scripting/includes/swiftly/swiftly_scripting_utils.h

@@ -6,8 +6,53 @@
 
 #include <functional>
 #include <thread>
+#include <string>
+
+#include <rapidjson/document.h>
+#include <rapidjson/writer.h>
+#include <rapidjson/stringbuffer.h>
+#include <rapidjson/error/en.h>
 
 int GetPlayerId(const char *str, bool matchbots = false);
 void CreateThread(std::function<void()> fn);
 
+class JSONObject
+{
+public:
+    rapidjson::Document document;
+
+    JSONObject() {}
+    ~JSONObject()
+    {
+        document.Clear();
+    }
+
+    bool Parse(std::string str);
+    const char *GetParseError();
+    const char *Encode();
+};
+
+class JSON
+{
+private:
+public:
+    JSON() {}
+
+    JSONObject *Create()
+    {
+        return (new JSONObject());
+    }
+
+    JSONObject *Parse(std::string jsonstr)
+    {
+        JSONObject *obj = new JSONObject();
+        if (obj->Parse(jsonstr))
+            print("[Swiftly] An error has occured while trying to parse JSON.\n[Swiftly] Error: %s\n", obj->GetParseError());
+
+        return obj;
+    }
+};
+
+extern JSON *json;
+
 #endif