41 lines
2.5 KiB
C++
41 lines
2.5 KiB
C++
#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()
|
|
|
|
{}
|
|
};
|
|
|
|
// --- 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
|