Humanizer C# (.NET) : méthodes, exemples, installation | PythonLib

Humanizer C# (.NET) : guide complet avec exemples

1. Qu'est-ce que Humanizer et pourquoi l'utiliser ?

Humanizer est une bibliothèque open source populaire pour la plateforme .NET qui résout l'un des problèmes les plus courants des développeurs : convertir des données techniques et machine en un format lisible par l'humain. Au lieu d'écrire des dizaines de méthodes auxiliaires pour formater les dates, les nombres, les énumérations et les chaînes de caractères, Humanizer offre une interface fluide (chaînage de méthodes) qui rend le code plus propre et la sortie plus conviviale.

Pourquoi en avez-vous besoin ? Imaginez que vous affichez à un utilisateur l'heure de publication d'un commentaire. Au lieu du "2024-03-15T14:30:00Z" impersonnel, il est bien préférable d'afficher "15 mars 2024, 14:30" ou, si peu de temps s'est écoulé, "à l'instant", "il y a 5 minutes". Humanizer permet ces transformations en une seule ligne de code. La bibliothèque prend en charge la localisation (plus de 30 langues, dont le français), le travail avec les nombres (nombres ordinaux, chiffres romains, octets "humains"), les énumérations (chaînes élégantes avec des espaces au lieu du CamelCase) et bien plus encore.

Humanizer est écrit en C# et est entièrement compatible avec .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5/6/7/8, ainsi qu'avec Xamarin, Unity et d'autres plateformes prenant en charge .NET Standard 2.0. Cela en fait le choix idéal pour tout projet .NET nécessitant une localisation et une amélioration de l'expérience utilisateur.

2. Installation

L'installation de Humanizer dans un projet .NET s'effectue via le gestionnaire de packages NuGet. Utilisez l'une des commandes suivantes :

# Installation via .NET CLI (recommandée)
dotnet add package Humanizer

# Installation via la console du gestionnaire de packages (Visual Studio)
Install-Package Humanizer

# Installation via le gestionnaire de packages NuGet
# Ou recherchez "Humanizer" dans l'interface graphique NuGet

Après l'installation, ajoutez la directive using Humanizer; en haut de votre fichier de code.

Remarque : Si vous n'avez besoin que d'une fonctionnalité spécifique (par exemple, uniquement la gestion des dates), il existe des packages plus légers : Humanizer.Core (de base), Humanizer.Core.fr (localisation française). Mais pour la plupart des projets, le package complet Humanizer est suffisant.