Publicada la versión final de DotNetCore.FeatureFlags
Introducción
Con la aparición el pasado 23 de Septiembre de 2019 de .NET Core 3.0 en su versión final, he publicado también DotNetCore.FeatureFlags como versión definitiva.
En esta entrada me gustaría aclarar y explicar algunas razones y motivaciones personales por las cuales he desarrollado esta librería, además de explicar de forma general su uso.
¿Porqué DotNetCore.FeatureFlags?
Desde que entré hace más de 2 años en la empresa en la que actualmente trabajo, llevo utilizando Feature Flags de manera efectiva.
El uso de Feature Flags en mi empresa no es nada nuevo, y se lleva utilizando con éxito desde años antes incluso de que yo entrara en ella a trabajar. Lo mismo sucede en muchas otras empresas a lo largo y ancho de todo el mundo.
Sin embargo, esta forma de trabajar no era nada nueva para mí ni para mucha gente, que como yo, ya lo usaba y conocía en esencia, pero lo hacía de otra forma y/o no lo nombraba o catalogaba con ningún término concreto como lo es Feature Toggles o Feature Flags.
El caso es que investigando un poco en la red, observé que en NuGet había alguna librería para .NET para el uso de estos mecanimos, pero echándoles un vistazo muy por encima, no encontré (disculpadme si existe y no lo ví) ninguna que fuera sencilla de utilizar. Todas me parecían demasiado farragosas y tendían incluso a la sobre ingeniería, cuando en mi opinión, este mecanismo debe ser lo más simple, sencillo, ligero y liviano posible.
Así que en las Navidades pasadas del año 2018, empecé a trabajar en mi tiempo libre en una librería que fuera completamente funcional, sencilla y útil para trabajar con Feature Toggles o Feature Flags.
Además, me había marcado como objetivo aprovechar su desarrollo para alinearlo con .NET Core 3.0 que debería aparecer en Septiembre de 2019.
Algunos de los objetivos que me marqué es que no tuviera dependencias con ninguna otra librería, y que su uso fuera extensivo en aplicaciones móviles, de consola, web, IoT, Azure, etc.
Estuve desde entonces trabajando con ella, probándola, utilizándola, mejorándola y refactorizándola hasta que la dejé como a mí me gustaba, momento en la que la publiqué en GitHub y la hice pública como paquete NuGet para su descarga y prueba.
Quería que la librería fuera lo más minimalista posible de forma que cualquier desarrollador pudiera extenderla y usarla como le pareciera oportuno.
En ese mismo mes de Mayo, publiqué un par de entradas en mi blog sobre Feature Toggles o Feature Flags.
- Uso de FeatureToggles o FeatureFlags
- FeatureToggles o FeatureFlags en nuestras aplicaciones de .Net Core
Debemos tener siempre presente que Feature Toggles o Feature Flags puede ser usado para muchísimos propósitos.
Por poner un sencillo ejemplo, debemos tener claro que aunque los A/B Testing pueda utilizar Feature Toggles o Feature Flags, el mecanimo de Feature Toggles o Feature Flags no tienen sólo cabida para A/B Testing.
De ahí, si cabe, la importancia de hacerlo lo más abierto y flexible posible.
Otros paquetes
Quiera la coincidencia o la Ley de Murphy (según cada uno quiera), que cuando uno hace algo, a veces otros han pensado lo mismo o algo parecido. Tal es lo que sucedió con esta librería, ya que en el momento en el que estaba meditante si publicarla o no como versión preliminar en NuGet (Mayo 2019), Microsoft publicó también Microsoft.FeatureManagement. Una librería para exponer funcionalidad basándonos en features.
Reconozco que dudé en su momento si seguir adelante o no con el proyecto, pero continué y me apresuré a publicarla en NuGet y continuar trabajando en ella. Lo cierto es que creo que no me equivoqué, ya que la librería de Microsoft a día de hoy continua en versión preview, y desconozco los planes de Microsoft para finalizarla. Es incluso hasta probable que se quede como preview por los tiempos de los tiempos.
Sea como sea, desconozco realmente las ventajas y desventajas de utilizar esta librería en lugar de la que yo he hecho, ya que honestamente no la he prestado demasiado atención ni me he fijado en otras librerías para desarrollar la que yo he hecho.
Simplemente me he centrado en agregar funcionalidad a algo que sé que funciona y hace lo que se espera de ello.
Ejemplos de uso
Para utilizar la librería, deberás disponer de .NET Core 3.0 e instalar el paquete NuGet como es lógico.
A partir de aquí, su uso es realmente sencillo.
Te debes centrar en tres cosas (más adelante se explica un poco más en detalle):
- ToggleSettings
- Toggle
- IToggleService
El diagrama de clases de la librería puede ser encontrado en GitHub.
A día de hoy, existe dentro de GitHub, una carpeta con un ejemplo de aplicación de Consola y de Web App utilizando esta librería.
La librería tiene una entrada principal que es la clase Toggle, que utiliza a su vez la implementación de IToggleService. Nuestro servicio es una parte fundamental que nos permitirá gestionar nuestros Toggles, encargándose esta clase de cargar los Toggles de un archivo de configuración, una base de datos, etc. (de donde queramos) y de gestionar los mismos de acuerdo a nuestras necesidades e intereses.
Luego, por comodidad y flexibilidad, utilizaremos la clase Toggle para a través de ella acceder al servicio y gestionar, manejar y administrar las acciones con los Toggles.
Un Toggle tiene tres sencillas propiedades (ToggleSettings):
- Feature (característica del Toggle y parte principal del Toggle para identificarlo. Su valor debería ser único)
- Description (descripción del Toggle)
- IsEnable (que indica si el Toggle está habilitado o no. Por defecto estará a false)
Las acciones generales que podemos realizar sobre los Toggles son (IToggleService):
- Extraer el número de Toggles disponibles en el servicio (Count).
- Preguntar si un Toggle concreto existe o no (ExistsToggle).
- Listar y obtener todos los Toggles que tiene dados de alta el servicio (GetAllTogglesSettings).
- Obtener los datos e información de un Toggle concreto (GetToggleSettingsBy).
- Recargar todos los Toggles (ReloadToggles).
- Eliminar todos los Toggles en bloque. Se trata de una forma de deshabilitar cualquier Toggle existente (ReleaseToggles).
Existe una acción adicional, sólo accesible a través de la clase Toggle que nos permite preguntar si un Toggle determinado, está habilitado o no (IsEnabled).
Como siempre, podriamos acceder a los Toggles directamente a través de nuestro servicio que implementa la interfaz IToggleService o a través de la clase Toggle, que hará uso de nuestro servicio por detrás.
Mi recomendación es tratar de utilizar la clase Toggle siempre que sea posible.
Historia de versiones
Por último, comentar que puedes acceder al histórico de versiones Release History – aquí
Espero que esta librería y su uso sea útil e interesante para la Comunidad.
Happy Coding!
One Responseso far
¿Y para .NET Framework?