Test de l'application console C# (Comment ça marche pour le développeur)

Les tests jouent un rôle essentiel dans le domaine du développement de logiciels, car ils constituent un élément crucial pour garantir la qualité des applications. Parmi la pléthore de Frameworks disponibles, .NET se distingue comme un choix largement adopté pour la création d'applications basées sur Windows. Cet article se penche sur les subtilités de .NET TestConsole, un outil spécialement conçu pour tester les applications .NET.

Tout au long de cette exploration, nous rédigerons un exemple de code complet illustrant la mise en œuvre pratique de .NET TestConsole. En outre, nous ferons la lumière sur IronPDF, une bibliothèque PDF C# exemplaire intégrée de manière transparente à .NET TestConsole. Cette bibliothèque s'avère inestimable, car elle permet aux développeurs d'accéder aux PDF et de les générer sans effort au sein du système .NET Environnement TestConsole. Rejoignez-nous pour découvrir les fonctionnalités et les possibilités qui découlent de la synergie entre .NET TestConsole et IronPDF.

1. Introduction : TestConsole

TestConsole est une bibliothèque de test polyvalente qui présente une approche distinctive des tests unitaires dans le langage de programmation C#. Les méthodes traditionnelles de tests unitaires sont souvent confrontées à des défis lorsqu'elles traitent de grands ensembles de données et d'assertions complexes, ce qui entraîne des difficultés dans l'identification des différences entre les résultats attendus et les résultats réels. En réponse à cette situation, la Console de test propose un nouveau flux de travail, passant de l'approche conventionnelle basée sur la prédiction à une comparaison côte à côte de la sortie formatée avec une version de sortie standard désignée comme "approuvée".

Dans cette bibliothèque, en particulier avec la TestConsole, la variante ".Core" étend les capacités de formatage héritées du projet TestConsole original et incorpore des fonctions essentielles d'approbation des tests dans les scénarios où les résultats des tests divergent des attentes. TestConsole.Core s'intègre de manière transparente au serveur de compilation pour déclencher l'échec d'un test. Sur le PC de développement, il offre par défaut la possibilité de reconfigurer l'utilisation des utilitaires de comparaison de fichiers installés pour visualiser les différences. Cette approche rationalise notamment le processus d'approbation, en permettant aux développeurs de mettre à jour manuellement la version approuvée si des différences sont attendues.

1.1. Pourquoi utiliser TestConsole ?

TestConsole.Core s'inspire d'ApprovalTests mais se distingue en fournissant un support pour écrire à la fois un framework complet et des suites de tests .NET Core. La bibliothèque répond au besoin de tests dans divers environnements, comme c'est le cas pour ApprovalTests qui, au moment de sa publication, s'adressait principalement à des scénarios de cadre complet. La syntaxe de TestConsole.Core, tout en présentant des similitudes avec ApprovalTests, offre des distinctions, notamment en ce qui concerne la sélection de l'outil de comparaison de fichiers et l'approbation directe du contenu.

Développée pour faciliter les tests dans le code des apps .NET Core, TestConsole.Core découle de la nécessité de combler le vide laissé par l'absence de prise en charge des standards .NET et des apps .NET Core dans ApprovalTests. Les fonctions d'approbation des tests de TestConsole.Core, qui permettent de tester efficacement de grands ensembles de données, prennent en charge les données formatées à l'aide de l'objet Test Console Output et étendent leurs fonctionnalités pour gérer n'importe quelle entrée de texte brut, offrant ainsi une solution complète pour les tests unitaires en C#.

1.2. Installer la C# de TestConsole ;

La console de test peut être installée en utilisant le formulaire du gestionnaire de paquets NuGet dans Visual Studio, ou en exécutant la commande suivante dans la console du gestionnaire de paquets NuGet.

Install-Package TestConsole -Version 2.6.0

Ou téléchargez directement à partir de TestCosole NuGet Page.

2. Exemple de code de TestConsole

Dans cette section, nous verrons comment convertir les sorties de la console en rapports. le code source ci-dessous utilise une console de test pour convertir les objets énumérables en un tableau de rapport bien formaté

using TestConsoleLib;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
Console.WriteLine(report);

using TestConsoleLib;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
Console.WriteLine(report);

Imports TestConsoleLib
Private output = New Output()
Private data = Enumerable.Range(0, 10).Select(Function(i) New With {
	Key .Value = i,
	Key .Squared = i * i,
	Key .String = New String("I"c, i)
})
output.FormatTable(data)
Dim report As String = output.Report
Console.WriteLine(report)

Cet extrait de code C# utilise la bibliothèque TestConsoleLib pour démontrer et exécuter un exemple simple de formatage et de présentation de données tabulaires à l'aide de la classe Output de TestConsole. Il commence par créer une instance de la classe Output nommée "output" Il génère ensuite une collection de 10 éléments contenant des objets anonymes dont les propriétés représentent une valeur entière, son carré et une chaîne de "I" dont la longueur correspond à la valeur entière.

La table output.FormatTable() est ensuite invoquée pour formater les données dans un tableau. Le résultat formaté est stocké dans la variable de chaîne "report", qui est finalement imprimée sur la console à l'aide de Console.WriteLine(). Cela illustre la capacité de TestConsole à formater et présenter facilement des données tabulaires pour une meilleure lisibilité lors des tests unitaires ou des scénarios de débogage.

2.1. Sortie

3. IronPDF

IronPDF est une puissante bibliothèque C# conçue pour simplifier et améliorer le processus de travail avec les documents PDF dans les applications .NET. Doté d'un ensemble complet de fonctionnalités, IronPDF permet aux développeurs de créer, de manipuler et d'extraire sans effort le contenu de fichiers PDF dans leurs projets C#. En mettant l'accent sur la flexibilité et la facilité d'utilisation, IronPDF prend en charge un large éventail de fonctionnalités, notamment la génération de PDF à partir de HTML, d'images ou de documents existants, ainsi que l'incorporation de contenu dynamique, tel que des graphiques et des tableaux.

Ses capacités s'étendent à la fusion, au fractionnement et à la manipulation de pages PDF, ainsi qu'à des fonctions telles que l'extraction de texte et d'images. Qu'il s'agisse de rapports, de documentation ou de toute autre tâche liée au format PDF, IronPDF s'impose comme une solution fiable et polyvalente, qui rationalise l'intégration de la fonctionnalité PDF dans les applications C# avec un minimum d'efforts.

3.1. Création de fichiers PDF des rapports de la console de test

Dans cette section, nous verrons comment convertir la sortie des rapports de TestConsole.

Installer la bibliothèque IronPDF

Installer avec NuGet

Install-Package IronPdf

nuget.org/packages/IronPdf/

ou

Télécharger DLL

Télécharger la DLL

Installation manuelle dans votre projet

Installer avec NuGet

Install-Package IronPdf

nuget.org/packages/IronPdf/

ou

Télécharger DLL

Télécharger la DLL

Installation manuelle dans votre projet

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :

Commencer gratuitement

Installer avec Nuget

Découvrez IronPDF sur NuGet pour une installation rapide et un déploiement facile. Avec plus de 8 millions de téléchargements, il transforme PDF avec C#.

nuget.org/packages/IronPdf/

Install-Package IronPdf

Télécharger la DLL

Envisagez d'installer le IronPDF DLL directement. Téléchargez et installez-le manuellement pour votre projet ou sous forme de GAC : {{lienDllAfficher}}

Installation manuelle dans votre projet

Télécharger la DLL

Installation à l'aide du gestionnaire de paquets NuGet

Pour intégrer IronPDF à votre projet Console à l'aide du gestionnaire de paquets NuGet, suivez les étapes suivantes :

1. Ouvrez Visual Studio et dans l'explorateur de solutions, faites un clic droit sur votre projet.

2. Choisissez "Gérer les paquets NuGet..." dans le menu contextuel.

3. Allez dans l'onglet Parcourir et recherchez IronPDF.

4. Sélectionnez la bibliothèque IronPDF dans les résultats de la recherche et cliquez sur le bouton d'installation.

5. Accepter tout accord de licence.

   Si vous souhaitez inclure IronPDF dans votre projet via la console du gestionnaire de paquets, exécutez la commande suivante dans la console du gestionnaire de paquets :

Install-Package IronPdf

Il récupérera et installera IronPDF dans votre projet.

Installation à l'aide du site NuGet

Pour une présentation détaillée d'IronPDF, notamment de ses caractéristiques, de sa compatibilité et des options de téléchargement supplémentaires, visitez la page IronPDF sur le site Web de NuGet à l'adresse https://www.nuget.org/packages/IronPdf.

Installation par DLL

Vous pouvez également incorporer IronPDF directement dans votre projet à l'aide de son fichier DLL. Téléchargez le fichier ZIP contenant la DLL à partir de ce lien lien. Décompressez-la et incluez la DLL dans votre projet.

Une fois installé, nous allons recréer l'exemple de rapport ci-dessus, mais cette fois-ci, au lieu de l'écrire dans la console, nous allons créer un rapport PDF à partir de celui-ci.

using TestConsole.OutputFormatting;
using TestConsoleLib;
using IronPdf;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
var htmlContent = $"<pre>{report}</pre>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("test.pdf");

using TestConsole.OutputFormatting;
using TestConsoleLib;
using IronPdf;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
var htmlContent = $"<pre>{report}</pre>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("test.pdf");

Imports TestConsole.OutputFormatting
Imports TestConsoleLib
Imports IronPdf
Private output = New Output()
Private data = Enumerable.Range(0, 10).Select(Function(i) New With {
	Key .Value = i,
	Key .Squared = i * i,
	Key .String = New String("I"c, i)
})
output.FormatTable(data)
Dim report As String = output.Report
Dim htmlContent = $"<pre>{report}</pre>"
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("test.pdf")

Cet extrait de code C# illustre l'intégration de TestConsoleLib et d'IronPDF pour générer un document PDF contenant un tableau de données formaté. Dans un premier temps, il crée une instance de la classe Output de TestConsoleLib et formate un tableau à l'aide de données générées à partir d'une série d'entiers. La sortie formatée est stockée dans la variable chaîne "report", qui est ensuite entourée de balises HTML pour préserver le formatage.

Ensuite, le code utilise le ChromePdfRenderer d'IronPDF pour rendre le contenu HTML sous forme de document PDF. Enfin, le PDF résultant est enregistré sous le nom de "test.pdf" Ce code démontre la combinaison transparente de TestConsoleLib pour le formatage et d'IronPDF pour la génération de PDF, fournissant une solution simple pour incorporer des données formatées dans des documents PDF au sein d'une application C#.

3.1.1. Sortie

4. Conclusion

La TestConsole .NET s'impose comme une bibliothèque de test essentielle pour les applications C#, présentant une approche distinctive des tests unitaires qui atténue les difficultés liées aux grands ensembles de données et aux assertions complexes. La variante TestConsole.Core étend son utilité à divers environnements, en comblant les lacunes laissées par d'autres cadres et en fournissant un flux de travail efficace pour les comparaisons côte à côte des résultats formatés.

Il s'intègre parfaitement à IronPDFune bibliothèque C# robuste, et permet non seulement de simplifier les tests mais aussi d'étendre ses capacités à la génération et à la manipulation de fichiers PDF. Ensemble, ces outils permettent aux développeurs de gérer sans effort les complexités des tests et d'améliorer la génération de documents dans leurs projets C#, offrant ainsi une solution complète et efficace.

Le tutoriel détaillé et complet sur la conversion HTML vers PDF d'IronPDF peut être trouvé ici.