renombrades extensions .h a .hpp

source/system_utils.hpp

@@ -0,0 +1,38 @@
+#pragma once
+
+#include <string>
+
+// --- Namespace SystemUtils: utilidades multiplataforma para operaciones del sistema ---
+namespace SystemUtils {
+// --- Enums ---
+enum class Result {  // Códigos de resultado para operaciones del sistema
+    SUCCESS = 0,
+    PERMISSION_DENIED,  // Sin permisos para crear la carpeta
+    PATH_TOO_LONG,      // Ruta demasiado larga
+    ALREADY_EXISTS,     // Ya existe (solo si se considera error)
+    INVALID_PATH,       // Ruta inválida
+    UNKNOWN_ERROR       // Error desconocido
+};
+
+// --- Estructuras ---
+struct FolderConfig {                // Configuración para creación de carpetas
+        bool create_parents{true};   // Crear carpetas padre si no existen
+        bool fail_if_exists{false};  // Fallar si la carpeta ya existe
+        int permissions{0755};       // Permisos Unix (ignorado en Windows)
+
+        // Constructor con valores por defecto
+        FolderConfig() = default;
+};
+
+// --- Funciones ---
+auto createApplicationFolder(const std::string& app_name, std::string& out_path) -> Result;                              // Crea la carpeta del sistema donde guardar datos de la aplicación
+auto createApplicationFolder(const std::string& app_name, std::string& out_path, const FolderConfig& config) -> Result;  // Crea la carpeta del sistema con configuración personalizada
+auto createFolder(const std::string& path) -> Result;                                                                    // Crea una carpeta en la ruta especificada
+auto createFolder(const std::string& path, const FolderConfig& config) -> Result;                                        // Crea una carpeta con configuración personalizada
+auto getApplicationDataPath(const std::string& app_name) -> std::string;                                                 // Obtiene la ruta de datos de la aplicación (sin crearla)
+auto folderExists(const std::string& path) -> bool;                                                                      // Verifica si una carpeta existe
+auto resultToString(Result result) -> const char*;                                                                       // Convierte un código de resultado a string descriptivo
+auto getHomeDirectory() -> std::string;                                                                                  // Obtiene el directorio home del usuario
+auto getTempDirectory() -> std::string;                                                                                  // Obtiene el directorio temporal del sistema
+
+}  // namespace SystemUtils