👁 Image
Enigmatry.Entry.AspNetCore.Tests.Utilities 10.2.3

ASP.NET Core Tests Utilities

A library that provides testing utilities and helpers for ASP.NET Core applications, making it easier to write clean, effective tests for web applications and APIs.

Intended Usage

Use this library when you need to write tests for ASP.NET Core applications. It provides utilities for mocking HTTP contexts, working with controllers, testing middleware, and more.

Installation

Add the package to your project:

dotnet add package Enigmatry.Entry.AspNetCore.Tests.Utilities

Usage Example

Testing exception handling in a controller:

using Enigmatry.Entry.AspNetCore.Tests;
using Enigmatry.Entry.AspNetCore.Filters;
using Microsoft.AspNetCore.Mvc;
using NUnit.Framework;
using FakeItEasy;
using FluentValidation;

[TestFixture]
public class ExceptionHandlingTests
{ [Test]
 public void HandleExceptionsFilter_ShouldReturnBadRequest_WhenValidationExceptionOccurs()
 {
 // Arrange
 var exceptionContext = ExceptionContextBuilder.Create()
 .WithValidationException()
 .WithJsonRequest()
 .Build();
 var filter = new HandleExceptionsFilter();
 
 // Act
 filter.OnException(exceptionContext);
 
 // Assert var result = exceptionContext.Result as BadRequestObjectResult;
 Assert.That(result, Is.Not.Null);
 Assert.That(result.Value, Is.Not.Null);
 }
}

Testing HTTP contexts:

using Enigmatry.Entry.AspNetCore.Tests;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Diagnostics;
using NUnit.Framework;

[TestFixture]
public class HttpContextTests
{ [Test]
 public void HttpContextBuilder_ShouldCreateValidContext_WithException()
 {
 // Arrange
 var exception = new InvalidOperationException("Test exception");
 
 // Act
 var context = HttpContextBuilder.Create()
 .With(exception)
 .Build();
 // Assert
 var feature = context.Features.Get<IExceptionHandlerPathFeature>();
 Assert.That(feature, Is.Not.Null);
 Assert.That(feature.Error.Message, Is.EqualTo("Test exception"));
 Assert.That(context.Request.Headers["Accept"], Is.EqualTo("application/json"));
 }
}

Service Scope Example

using Enigmatry.Entry.AspNetCore.Tests.Utilities;
using Microsoft.Extensions.DependencyInjection;
using NUnit.Framework;

[TestFixture]
public class ServiceTests
{ [Test]
 public void ServiceScope_ResolvesService_Successfully()
 {
 // Arrange
 var services = new ServiceCollection();
 services.AddScoped<IMyService, MyService>();
 var provider = services.BuildServiceProvider();
 
 // Act
 using var scope = provider.CreateScope();
 var service = scope.Resolve<IMyService>();
 // Assert
 Assert.That(service, Is.Not.Null);
 Assert.That(service, Is.TypeOf<MyService>());
 }
}

Database Utilities Example

using Enigmatry.Entry.AspNetCore.Tests.Utilities.Database;
using Microsoft.Data.SqlClient;
using NUnit.Framework;

[TestFixture]
public class DatabaseTests
{ [Test]
 public void DatabaseHelpers_ProvidesDropAllSql()
 {
 // Arrange
 var connectionString = "Server=(localdb)\\MSSQLLocalDB;Database=TestDb;Integrated Security=true";
 
 // Act & Assert
 Assert.NotNull(DatabaseHelpers.DropAllSql);
 
 // Example of how you might use it in a real test
 // using var connection = new SqlConnection(connectionString);
 // connection.Open();
 // var command = new SqlCommand(DatabaseHelpers.DropAllSql, connection);
 // command.ExecuteNonQuery();
 }
}