Implementación de Librería Humanizer en .NET para Números en Palabras

Clase 20 de 21Curso de Fundamentos de .NET

Resumen

¿Cómo integrar un paquete NuGet en tu aplicación?

Integrar un paquete NuGet en tu aplicación puede simplificar enormemente la implementación de funcionalidades complejas. En este caso, vamos a explicar cómo usar un paquete NuGet para mostrar la edad en palabras, en lugar de números, dentro de una aplicación .NET. Esto te permitirá comprender la fluidez y potencia que proporciona el ecosistema de NuGet en el desarrollo.

¿Cómo aseguramos que nuestra aplicación .NET esté lista?

Antes de comenzar con la integración, es crucial asegurarse de que nuestra aplicación .NET compile y funcione correctamente. Para esto, utilizamos el comando dotnet build. A veces, pueden surgir errores debido a la versión del framework configurada en el archivo global.json. Es necesario:

  1. Revisar el archivo global.json para verificar la versión correcta del framework.
  2. Cambiar o eliminar este archivo si es necesario.
  3. Asegurar que la versión del framework coincida con la que el proyecto necesita en su target framework.

Con este ajuste, deberías poder compilar satisfactoriamente la aplicación.

¿Cómo integramos una librería NuGet para extender funcionalidades?

Para cumplir con el nuevo requerimiento de mostrar la edad en palabras, no es necesario desarrollar un componente desde cero. Existen librerías, como Humanizer para .NET, que facilitan la conversión de números a palabras. Aquí te mostramos cómo integrarla:

  1. Visita NuGet.org: Encuentra la librería Humanizer que permite manipular diferentes tipos de datos y convertirlos a texto, haciéndolos accesibles a las interacciones humanas.

  2. Agrega el paquete con .NET CLI:

    • Copia el comando indicado para .NET CLI desde NuGet.org.
    • Ejecuta este comando en tu consola de comandos, lo que añadirá el paquete a tu proyecto.
    • Revisa el archivo console.app.csproj y observa cómo aparece una nueva sección ItemGroup que contiene el paquete.
  3. Invoca la librería Humanizer: Dirígete al archivo program.cs. Usa la sentencia using para invocar la librería Humanizer y poder utilizar sus métodos.

¿Cómo transformamos datos utilizando la librería?

Para transformar la edad del usuario de números a palabras:

  • Asegúrate de que la variable que contiene la edad sea de tipo entero, ya que el método ToWords necesita esta conversión para funcionar.
  • Usa el método ToWords para convertir números a palabras.

Ejemplo de código:

using Humanizer;

int edad = Int32.Parse(edadString);
string edadEnLetras = edad.ToWords();

¿Cómo cambiamos el idioma de salida a español?

Es común que los sistemas operativos preconfigurados en inglés generen respuestas en dicho idioma. Sin embargo, podemos configurar la librería para que utilice español:

  1. Usa System.Globalization.CultureInfo para especificar la cultura del texto.
  2. Crea un objeto CultureInfo indicando es para español.
  3. Integra este objeto en el método ToWords para personalizar el idioma.

Ejemplo de código con cultura:

int edad = Int32.Parse(edadString);
var cultura = new System.Globalization.CultureInfo("es");
string edadEnLetras = edad.ToWords(cultura);

Con estos pasos implementados, la aplicación mostrará correctamente la edad en palabras en español. Codificar en .NET se convierte en una experiencia enriquecedora gracias a librerías como Humanizer, promoviendo soluciones rápidas y eficaces. ¡Sigue explorando el mundo de .NET para descubrir todo su potencial!