1. ¿Qué es y para qué sirve?

En el lenguaje C++, las enumeraciones (enum y enum class) son una herramienta potente para crear constantes con nombre. Sin embargo, tienen una gran carencia: la ausencia de reflexión integrada. El C++ estándar no ofrece una forma sencilla de obtener la representación en cadena de un valor de enumeración, recorrer todos sus elementos o conocer la cantidad de variantes. Los desarrolladores se ven obligados a escribir funciones auxiliares manualmente, usar macros o recurrir a generadores de código externos, lo que provoca duplicación de código y posibles errores.

La librería magic_enum resuelve este problema proporcionando un conjunto potente y cómodo de herramientas para trabajar con enumeraciones tanto en tiempo de compilación como en tiempo de ejecución. Utiliza la magia de las plantillas de C++17 y mecanismos internos del compilador (como __PRETTY_FUNCTION__) para extraer automáticamente información sobre las enumeraciones. Con magic_enum puedes obtener el nombre en cadena de cualquier valor, convertir una cadena en un valor, recorrer todos los elementos de una enumeración, conocer su cantidad y mucho más, sin necesidad de escribir código auxiliar adicional.

Esta librería es indispensable para tareas como logging, serialización/deserialización, creación de archivos de configuración, análisis de entrada de usuario, testing y cualquier otra que requiera trabajar dinámicamente con enumeraciones. Hace que el código sea más limpio, seguro y reduce significativamente la cantidad de código repetitivo. magic_enum es, probablemente, la librería de reflexión de enums más popular y madura en C++, compatible con los principales compiladores (GCC, Clang, MSVC).

2. Instalación

magic_enum es una librería header-only, compuesta por un único archivo de cabecera. Esto hace que su instalación sea increíblemente sencilla. No necesitas compilarla como una librería separada; basta con copiar el archivo magic_enum.hpp en tu proyecto e incluirlo.

Sin embargo, para una gestión de dependencias más cómoda, se recomienda usar sistemas de compilación como CMake (a través de FetchContent o find_package) o gestores de paquetes como vcpkg o Conan.

Método 1: Descargar el archivo manualmente (el más simple)

1. Ve a la página de lanzamientos en GitHub: https://github.com/Neargye/magic_enum/releases
2. Descarga la última versión del archivo magic_enum.hpp.
3. Colócalo en la carpeta de tu proyecto (por ejemplo, en include/).
4. Inclúyelo en tu código: #include "magic_enum.hpp"

Método 2: A través de vcpkg (recomendado para Windows)

vcpkg install magic-enum

Método 3: A través de Conan

conan install magic_enum/0.9.5@

Método 4: A través de CMake FetchContent (recomendado para proyectos nuevos)

Añade el siguiente código a tu CMakeLists.txt:

include(FetchContent)
FetchContent_Declare(
  magic_enum
  GIT_REPOSITORY https://github.com/Neargye/magic_enum.git
  GIT_TAG v0.9.5 # O el último tag estable
)
FetchContent_MakeAvailable(magic_enum)

target_link_libraries(tu_proyecto PRIVATE magic_enum::magic_enum)

Importante: Para que magic_enum funcione, necesitas un compilador compatible con C++17. Asegúrate de haber activado el estándar correspondiente en tu proyecto (por ejemplo, set(CMAKE_CXX_STANDARD 17) o la bandera -std=c++17).

3. Inicio rápido — ejemplo mínimo funcional

Empecemos con el ejemplo más sencillo