Remove json component

components/nspanel_ha_blueprint/json.h

@@ -0,0 +1,88 @@
+// json.h
+#pragma once
+
+#include "cJSON.h"
+#include <cmath>
+#include <cstdio>
+#include <cstring>
+
+// The `nspanel_ha_blueprint` namespace encapsulates utility functions for JSON manipulation
+// tailored for the NSPanel Home Assistant Blueprint project.
+namespace nspanel_ha_blueprint {
+
+    /**
+     * Compares the string value of a cJSON object with a target C-string.
+     * 
+     * This function checks if the given cJSON object is not NULL, is a string type,
+     * and its value matches the target string provided.
+     * 
+     * @param json_item The cJSON object whose string value is to be compared.
+     * @param target_str The target C-string to compare against the cJSON object's value.
+     * @return True if the cJSON object's string value matches the target string, false otherwise.
+     */
+    bool json_cmp_string(const cJSON* json_item, const char* target_str) {
+        if (json_item != NULL && cJSON_IsString(json_item) && json_item->valuestring != NULL) {
+            return strcmp(json_item->valuestring, target_str) == 0;
+        }
+        return false;
+    }
+
+    /**
+     * Compares the integer value of a cJSON object with a target unsigned integer.
+     * 
+     * This function checks if the given cJSON object is not NULL, represents a number,
+     * and its integer value matches the target unsigned integer provided. It's particularly
+     * useful for JSON fields that are expected to contain numeric boolean values (e.g., 0 or 1)
+     * or other unsigned integer values.
+     * 
+     * @param json_item The cJSON object whose integer value is to be compared.
+     * @param target_uint The target unsigned integer to compare against the cJSON object's value.
+     * @return True if the cJSON object's integer value matches the target unsigned integer, false otherwise.
+     */
+    bool json_cmp_uint(const cJSON* json_item, unsigned int target_uint) {
+        if (json_item != NULL && cJSON_IsNumber(json_item)) {
+            return (unsigned int)json_item->valueint == target_uint;
+        }
+        return false;
+    }
+
+    /**
+     * Retrieves a floating-point value from a cJSON object.
+     *
+     * @param json_item The cJSON object from which to retrieve the value.
+     * @return The floating-point value of the cJSON object if it is a number, NaN otherwise.
+     */
+    float json_get_float(const cJSON* json_item) {
+        if (json_item != NULL && cJSON_IsNumber(json_item)) {
+            return static_cast<float>(json_item->valuedouble);
+        }
+        return std::nan(""); // Return NaN if not a valid number
+    }
+
+    /**
+    * Converts a JSON integer percentage value to a string representing a floating-point number between 0.00 and 1.00.
+    *
+    * @param json_item The cJSON object containing the integer percentage value.
+    * @return A string representation of the floating-point number, or an empty string if the input is invalid.
+    */
+    std::string json_percentage_to_float_string(const cJSON* json_item) {
+        // Ensure the item is a valid number
+        if (json_item != NULL && cJSON_IsNumber(json_item)) {
+            // Convert the integer percentage to a float between 0.00 and 1.00
+            float percentage = static_cast<float>(json_item->valueint) / 100.0f;
+            
+            // Buffer to hold the formatted string, large enough for "0.00" plus null terminator
+            char buffer[8];
+            
+            // Format the floating-point number with two decimal places
+            snprintf(buffer, sizeof(buffer), "%.2f", percentage);
+            
+            // Return the formatted string
+            return std::string(buffer);
+        }
+        
+        // Return an empty string to indicate invalid input or non-numeric JSON item
+        return "";
+    }
+
+}  // namespace nspanel_ha_blueprint