Jorge Serrano
  • Home

Como usar xUnit y Fluent Assertions en .NET Core 2.x

  • By jorge
  • Ago-25-2018
  • .NET Core, C#, Fluent Assertions, Testing, Visual Studio 2017, xUnit
  • 0 Comments.

En esta entrada vamos a ver como utilizar xUnit y Fluent Assertions en .NET Core.

Por hacer un pequeño recordatorio, xUnit es una herramienta gratuita y de código abierto que nos permitirá realizar pruebas unitarias en nuestro código.
Aunque lo podemos utilizar en .NET Framework, también podemos utilizarlo en .NET Core.

En realidad, el uso de xUnit en .NET Framework y .NET Core es prácticamente el mismo.

Por otro lado, Fluent Assertions hace que las Asserts sean utilizadas de forma más natural a como lo haríamos en el lenguaje humano de forma que nuestros tests puedan ser comprendidos y leídos de forma más clara.

Te recomiendo leer la entrada Unit Testing y el Patrón AAA si tienes alguna duda respecto al Patrón AAA que utilizaré en este ejemplo.

Al igual que xUnit, Fluent Assertions puede ser utilizado con .NET Framework y con .NET Core.
Y de igual manera, su uso en .NET Framework y .NET Core es prácticamente el mismo también.

También conviene mencionar que Fluent Assertions soporta no sólo xUnit, sino un montón de frameworks de pruebas unitarias como por ejemplo MsTest o NUnit por citar algunos de los más habituales en el mundo .NET.

Este proyecto de ejemplo nos explicará como trabajar con xUnit, Fluent Assertions y .NET Core de forma sencilla.

En primer lugar, vamos a crear un proyecto de .NET Core.
En mi caso utilizando Visual Studio 2017.

Para ello, he utilizado la plantilla xUnit Test Project (.NET Core).

Una vez creado nuestro proyecto, lo primero que haremos será abrir NuGet sobre nuestro proyecto e instalar el paquete de Fluent Assertions.

La plantilla de xUnit para Visual Studio 2017 por su parte, instalará dos paquetes NuGet relacionados con xUnit.

A continuación podremos escribiremos el código de nuestra aplicación.

El código lo he dividido en cuatro ficheros.
Tres de ellos tendría que ver con la «lógica» que quiero probar.
El último corresponde con los tests (5 en mi caso).

Aunque lo habitual es probar un ensamblado y no tener todo en el mismo proyecto, he decidido hacerlo así sólo para llevar a cabo nuestras pruebas de forma práctica.

El código de la parte «lógica» a probar es el siguiente:

MissingPersonNameException.cs

using System;

namespace xUnitFluentAssertions.UnitTests
{

    public class MissingPersonNameException : Exception
    {
        public MissingPersonNameException() : base("Name is missing") { }
    }

}

WrongPersonAgeException.cs

using System;

namespace xUnitFluentAssertions.UnitTests
{

    public class WrongPersonAgeException : Exception
    {
        public WrongPersonAgeException(int age) : base($"Age {age} is invalid. Should be greater than 18.") { }
    }

}

Person.cs

using System;

namespace xUnitFluentAssertions.UnitTests
{

    public class Person
    {
        public string Name { private get; set; }
        public int Age { private get; set; }

        public Person(string name, int age)
        {
            if (age < 18) throw new WrongPersonAgeException(age);

            this.Name = name;
            this.Age = age;
        }

        public override string ToString()
        {
            if (String.IsNullOrEmpty(this.Name))
                throw new MissingPersonNameException();

            return $"Hi {this.Name}!";
        }

        public string GetName() => this.Name;
        public int GetAge() => this.Age;
    }

}

Si nos paramos un poco a mirar el código de estas tres clases, veremos que la última, la clase Person, es la que tiene en sí la parte más global a probar.

Así que la última clase que tendremos, la que corresponde con el test en sí, la he enfocado a la clase Person.

El código de esta clase queda de la siguiente forma:

PersonTests.cs

using FluentAssertions;
using System;
using Xunit;

namespace xUnitFluentAssertions.UnitTests
{

    public class PersonTests
    {
        private readonly string _name = "Jorge";
        private readonly int _age = 18;

        [Fact]
        public void Person_WithConstructorValues_ShouldBeNameAsExpected()
        {
            // Arrange
            var person = new Person(this._name, this._age);
            // Act
            var personName = person.GetName();
            // Assert
            personName.Should().Be(this._name);
        }

        [Fact]
        public void Person_WithConstructorValues_ShouldBeAgeAsExpected()
        {
            // Arrange
            var person = new Person(this._name, this._age);
            // Act
            var personAge = person.GetAge();
            // Assert
            personAge.Should().Be(this._age);
        }

        [Fact]
        public void Person_WithConstructorValuesAndUsingToString_ShouldBeAsExpected()
        {
            // Arrange
            var person = new Person(this._name, this._age);
            // Act
            var personToString = person.ToString();
            // Assert
            personToString.Should().StartWith("Hi").And.EndWith("!").And.Contain(this._name).And.ContainAll($"Hi {this._name}!");
        }

        [Fact]
        public void Person_WithMissingName_ShouldReturnsAnException()
        {
            // Arrange
            var person = new Person(String.Empty, this._age);
            // Act
            Action action = () => person.ToString();
            // Assert
            person.GetAge().Should().Be(this._age);
            action.Should().Throw<MissingPersonNameException>().WithMessage("Name is missing");
        }

        [Fact]
        public void Person_WithWrongAge_ShouldReturnsAnException()
        {
            // Arrange & Act
            var age = 17;
            Action action = () => new Person(String.Empty, age);
            // Assert
            action.Should().Throw<WrongPersonAgeException>().WithMessage($"Age {age} is invalid. Should be greater than 18.");
        }

    }

}

Y aquí empezaremos a explicar todo lo relativo a xUnit y Fluent Assertions, ya que esta última clase es la que lo usa.

Aunque explicaré de forma breve los ejemplos de test que he hecho, recuerda que la documentación es siempre nuestra aliada.
Podrás acceder a la documentación de Fluent Assertions en este enlace.

Fluent Assertions necesita los símbolos de depuración o debug symbols para encontrar sobre todo los detalles de código con respecto a posibles problemas o fallos en los tests.
De ahí que la compilación de los tests deba hacerse en modo Debug incluso en el sistema que tengamos preparado para compilar nuestra solución.

Las pruebas que he preparado consiste en validar el objeto Person.

Las pruebas básicas tienen que ver con la clase Person y sus propiedades, en las que validamos en cierta manera la inmutabilidad de la información y nos aseguramos que no ha sido alterada al crearse.

Otra prueba tiene por objeto recibir una información de la clase Person y validar que realmente se está generando correctamente tal y como esperamos. Sin Fluent Assertions deberíamos crear tantos Assert como partes del resultado quisiéramos probar, pero en este caso y con una única instrucción, estaremos probando todos los posibles casos esperados.

Sin embargo, he querido complicar un poco las validaciones y he optado por levantar dos excepciones según determinadas circunstancias. Una proactiva al instanciar Person y otra reactiva al llamar a un método de la clase Person. En estos dos casos, preparamos una acción sobre la cuál vamos a preguntar si se ha producido una excepción del tipo esperado e incluso vamos a validar el mensaje que debería tener.

Como vemos, el uso de Fluent Assertions lo estamos comenzando con Should(), y a partir de ahí y según lo que deseemos validar, empezaremos a anidar las validaciones.

El método Should() es la base de Fluent Assertions, y es la puerta de entrada para validar el resultado esperado.

Recuerda compilar la solución antes de abrir la ventana de tests para poder lanzarlos.
Nuestros tests en ejecución se muestran como se indica en la siguiente imagen.

Podrás acceder al código de estos Tests en mi repositorio de GitHub en este enlace.

Happy Coding!

Comments

Deja un comentario Cancelar respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

← Previous Post Next Post →

Jorge Serrano

MVP Reconnect


¡Subscríbete a mi canal!
YouTube

Donaciones
Donation

Entradas recientes

  • Go – Arrays
  • Go – Operators
  • Go – Constants
  • Go – Tipos de Datos
  • Go – Variables
  • Hello Go-rld!
  • Introducción a Go o Golang
  • JSON Patch en ASP.NET Core 5 Web API
  • Null Checking en C#
  • ¿Porqué mi página web por defecto de ASP.NET Core no se vé en mi Azure Web App y me da un 404?

Categorías

  • .NET 5
  • .NET Core
  • .NET Core 3.0
  • .NET Core 3.1
  • .NET Framework 2.0
  • .NET Framework 3.0
  • .NET Framework 3.5
  • .NET Framework 4.0
  • .NET Framework 4.5
  • .NET Framework 4.6
  • .NET Framework 4.7
  • .NET Framework 4.8
  • .NET Standard 2.0
  • .NET Standard 2.1
  • AMQP
  • Android
  • Angular
  • API REST
  • Apple
  • Apple iOS
  • Apple macOs
  • Arquitectura
  • ASP.NET
  • ASP.NET Core
  • ASP.NET Core 3
  • ASP.NET Core 5
  • AWS
  • Azure App Service
  • Azure Application Insights
  • Azure Cosmos DB
  • Azure Database Migration Service
  • Azure Databricks
  • Azure DevOps
  • Azure Event Grid
  • Azure Functions
  • Azure IoT
  • Azure Portal
  • Azure PowerShell
  • Azure Queue Storage
  • Azure SQL
  • Azure Storage
  • Azure Virtual Datacenter
  • Azure WebApps
  • Big Data
  • Bing
  • Blazor
  • Blog
  • Bots
  • C#
  • C# 7.0
  • C# 7.1
  • C# 7.2
  • C# 7.3
  • C# 8.0
  • C# 9.0
  • Channel 9
  • Codeplex
  • Codespaces
  • Containers
  • Debugging
  • DevOps
  • Docker
  • Electron
  • Entity Framework
  • Entity Framework Core
  • Entity Framework Core 3.0
  • Entity Framework Core 5
  • Eventos
  • F#
  • FaaS
  • FeatureFlags
  • FeatureToggles
  • Feeds
  • Fluent Assertions
  • General
  • GIMP
  • Git
  • GitHub
  • Go
  • Google
  • Google Analytics
  • Gradle
  • gRPC
  • GSA
  • Historia de la Informática
  • HoloLens
  • HtmlAgilityPack
  • IdentityServer4
  • Inkscape
  • Ionic
  • iOS
  • IoT
  • Java
  • JavaScript
  • JDBC
  • JSON
  • Kubernetes
  • Lenguajes de Programación
  • Libros y Cursos
  • LINQ
  • Linux
  • LiteDB
  • Machine Learning
  • macOS
  • Microservices
  • Microsoft
  • Microsoft .NET Framework 4.5
  • Microsoft 365
  • Microsoft Azure
  • Microsoft Build
  • Microsoft Ignite
  • Microsoft Learn
  • Microsoft Orleans
  • Microsoft Surface Go
  • Microsoft Teams
  • ML.NET
  • MQTT
  • MRO
  • MS-DOS
  • MsCoders Madrid
  • MVP
  • NancyFx
  • Node.js
  • NoSQL
  • NuGet
  • NUnit
  • OData
  • ODP.NET Core
  • Office 2007
  • Office 2010
  • Office 2013
  • Office 2016
  • Office 2019
  • Office 365
  • Open Source
  • Open XML SDK
  • Opinión
  • Orchard CMS
  • OT
  • PaaS
  • Patterns
  • PdfSharpCore
  • Performance
  • PHP
  • Postman
  • Power BI
  • PowerShell
  • PowerShell Core
  • Productividad
  • Project Server 2019
  • R
  • Rendimiento
  • Scala
  • Scraper
  • Security
  • Serverless
  • Service Fabric
  • SharePoint Server 2019
  • SignalR
  • Sin categoría
  • Sistemas Distribuidos
  • Skype
  • Skype for Business Server 2019
  • Small Basic Online
  • SQL Server 2005
  • SQL Server 2008
  • SQL Server 2012
  • SQL Server 2014
  • SQL Server 2016
  • SQL Server 2017
  • SQL Server 2019
  • STOMP
  • Swagger
  • Testing
  • TFS 2017
  • TFS 2018
  • Tools
  • TypeScript
  • Unity
  • UWP
  • UX
  • Visio
  • Visual Basic
  • Visual Studio 2010
  • Visual Studio 2012
  • Visual Studio 2013
  • Visual Studio 2015
  • Visual Studio 2017
  • Visual Studio 2017 for Mac
  • Visual Studio 2019
  • Visual Studio 2019 for Mac
  • Visual Studio App Center
  • Visual Studio Code
  • Visual Studio IntelliCode
  • Visual Studio Live Share
  • Visual Studio Live Share Audio
  • Visual Studio Online
  • VS Anywhere
  • Vue.js
  • Web API
  • WebAssembly
  • WinDbg
  • Windows
  • Windows 10
  • Windows Compatibility Pack
  • Windows Phone 10
  • Windows Phone 7
  • Windows Phone 8
  • Windows Server 2008
  • Windows Server 2012
  • Windows Server 2016
  • Windows Server 2019
  • Windows Service
  • WinForms
  • WinUI
  • WPF
  • Xamarin
  • Xbox
  • Xcode
  • Xiaomi Mi Band 2
  • xUnit
  • YAML

Archivos

  • enero 2021
  • diciembre 2020
  • noviembre 2020
  • octubre 2020
  • septiembre 2020
  • agosto 2020
  • julio 2020
  • junio 2020
  • mayo 2020
  • abril 2020
  • marzo 2020
  • febrero 2020
  • enero 2020
  • diciembre 2019
  • noviembre 2019
  • octubre 2019
  • septiembre 2019
  • agosto 2019
  • julio 2019
  • junio 2019
  • mayo 2019
  • abril 2019
  • marzo 2019
  • febrero 2019
  • enero 2019
  • diciembre 2018
  • noviembre 2018
  • octubre 2018
  • septiembre 2018
  • agosto 2018
  • julio 2018
  • junio 2018
  • mayo 2018
  • abril 2018
  • marzo 2018
  • febrero 2018
  • enero 2018
  • diciembre 2017
  • noviembre 2017
  • octubre 2017
  • septiembre 2017
  • agosto 2017
  • julio 2017
  • junio 2017
  • febrero 2015
  • octubre 2014
  • junio 2014
  • marzo 2014
  • febrero 2014
  • enero 2014
  • diciembre 2013
  • septiembre 2013
  • agosto 2013
  • julio 2013
  • junio 2013
  • abril 2013
  • febrero 2013
  • enero 2013
  • diciembre 2012
  • noviembre 2012
  • septiembre 2012
  • agosto 2012
  • junio 2012
  • mayo 2012
  • abril 2012
  • marzo 2012
  • febrero 2012
  • enero 2012
  • diciembre 2011
  • noviembre 2011
  • octubre 2011
  • septiembre 2011
  • agosto 2011
  • julio 2011
  • junio 2011
  • mayo 2011
  • abril 2011
  • marzo 2011
  • enero 2011
  • diciembre 2010
  • noviembre 2010
  • octubre 2010
  • septiembre 2010
  • agosto 2010
  • julio 2010
  • junio 2010
  • mayo 2010
  • abril 2010
  • marzo 2010
  • febrero 2010
  • enero 2010
  • diciembre 2009
  • noviembre 2009
  • octubre 2009
  • septiembre 2009
  • agosto 2009
  • julio 2009
  • junio 2009
  • mayo 2009
  • abril 2009
  • marzo 2009
  • febrero 2009
  • enero 2009
  • diciembre 2008
  • noviembre 2008
  • octubre 2008
  • septiembre 2008
  • agosto 2008
  • julio 2008
  • junio 2008
  • mayo 2008
  • abril 2008
  • marzo 2008
  • febrero 2008
  • enero 2008
  • diciembre 2007
  • noviembre 2007
  • octubre 2007
  • septiembre 2007
  • agosto 2007
  • julio 2007
  • junio 2007
  • mayo 2007
  • abril 2007
  • marzo 2007
  • febrero 2007
  • enero 2007
  • diciembre 2006
  • noviembre 2006
  • octubre 2006
  • septiembre 2006
  • agosto 2006
  • julio 2006
  • junio 2006
  • mayo 2006
About This Site

A cras tincidunt, ut tellus et. Gravida scel ipsum sed iaculis, nunc non nam. Placerat sed phase llus, purus purus elit.

Archives Widget
  • January 2010
  • December 2009
  • November 2009
  • October 2009
Categories
  • Entertainment
  • Technology
  • Sports & Recreation
  • Jobs & Lifestyle
Search
  • twitter

Powered by WordPress  |  Business Directory by InkThemes.

This site uses cookies: Find out more.