Add SQL module

Author: oblivioncth

lib/sql/CMakeLists.txt

@@ -0,0 +1,12 @@
+#================= Add Component ==========================
+qx_add_component("Sql"
+    HEADERS_API
+        qx-common-sql.h
+    IMPLEMENTATION
+        qx-common-sql.cpp
+    #DOC_ONLY
+    LINKS
+        PUBLIC
+            ${Qt}::Sql
+            Qx::Core
+)

lib/sql/cmake/depends_qt

@@ -0,0 +1,2 @@
+Core
+Sql

lib/sql/cmake/depends_siblings

@@ -0,0 +1 @@
+Core

lib/sql/doc/general/declarativesql.md

@@ -0,0 +1,73 @@
+Qx Declarative JSON {#declarativejson}
+======================================
+
+FIXME
+
+Qx features a highly flexible, simple to use, declarative mechanism for parsing/serializing JSON data into user structs and other types.
+
+For example, the following JSON data:
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.json}
+{
+    "title": "Sample JSON Data",
+    "info": {
+        "rating": 10,
+        "cool": true
+    },
+    "reviews": [
+        "Wicked!",
+        "Awesome!",
+        "Fantastic!"
+    ]
+}
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+can easily be parsed into a corresponding set of C++ data structures like so:
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
+#include <qx/core/qx-json.h>
+
+struct Info
+{
+    int rating;
+    bool cool;
+
+    QX_JSON_STRUCT(rating, cool);
+};
+
+struct MyJson
+{
+    QString title;
+    Info info;
+    QList<QString> reviews;
+
+    QX_JSON_STRUCT(title, info, reviews);
+};
+
+int main()
+{
+    QFile jsonFile("data.json");
+    MyJson myJsonDoc;
+
+    // Parse into custom structures
+    Qx::JsonError je = Qx::parseJson(myJsonDoc, jsonFile);
+    Q_ASSERT(!je.isValid());
+
+    ...
+}
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Likewise, the structure can be serialized back out into textual JSON data with:
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
+int main()
+{
+    ...
+
+    // Serialize to JSON
+    je = Qx::serializeJson(jsonFile, myJsonDoc);
+    Q_ASSERT(!je.isValid());
+}
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This system is accessed through the qx-json.h header, predominantly with QX_JSON_STRUCT().

lib/sql/doc/general/sql.dox

@@ -0,0 +1,10 @@
+/*!
+ *  @defgroup qx-sql Qx SQL
+ *
+ *  @brief The SQL component is a module dedicated to interacting with SQL relational databases.
+ *
+ *  @component{Sql,sql.h}
+ *
+ *  Qx SQL extends the Qt SQL module to allow for easier use of databases for some of the most
+ *  common use-cases.
+ */

lib/sql/include/qx/sql/qx-common-sql.h

@@ -0,0 +1,27 @@
+#ifndef QX_SQL_COMMON_H
+#define QX_SQL_COMMON_H
+
+// Shared Lib Support
+#include "qx/sql/qx_sql_export.h"
+
+// Qt Includes
+
+
+//Intra-component Includes
+
+
+// Extra-component Includes
+
+
+namespace Qx
+{
+//-Namespace Enums-----------------------------------------------------------------------------------------------------
+
+
+//-Namespace Variables-------------------------------------------------------------------------------------------------
+
+//-Namespace Functions-------------------------------------------------------------------------------------------------
+
+}
+
+#endif // QX_SQL_COMMON_H

lib/sql/src/qx-common-sql.cpp

@@ -0,0 +1,22 @@
+// Unit Includes
+#include "qx/io/qx-common-sql.h"
+
+// Qt Includes
+
+// Intra-component Includes
+
+// Extra-component Includes
+
+/*!
+ *  @file qx-common-sql.h
+ *  @ingroup qx-sql
+ *
+ *  @brief The qx-common-sql header file
+ *
+ *  ...
+ */
+
+namespace Qx
+{
+
+}