Reo.Core.IntegrationTesting 10.0.222

Reo.Core.IntegrationTesting

Описание пакета

Reo.Core.IntegrationTesting — это библиотека для упрощения написания интеграционных тестов в .NET-приложениях. Она предоставляет фикстуры для работы с различными системами (PostgreSQL, Redis, MongoDB, Elasticsearch), автоматизирует настройку и очистку тестовых данных, а также интегрируется с Moq.AutoMock для создания мок-объектов.

Решает следующие проблемы:

• Сложности настройки тестовых сред для разных баз данных и сервисов.
• Повторяющийся код для инициализации и очистки ресурсов.
• Нужда в абстракции для тестирования слоев, зависящих от внешних сервисов.

Основные функции:

• Автоматическая настройка тестовых баз данных (PostgreSQL, MongoDB и др.).
• Инструменты для работы с Elasticsearch, Redis и другими сервисами.
• Интеграция с Moq.AutoMock для мокирования зависимостей.
• Поддержка тестов с использованием контейнеров (Testcontainers).

Основные компоненты

Требования

• .NET: 8.0, 9.0
• Зависимости:
  • Moq.AutoMock
  • Testcontainers
  • Npgsql (для PostgreSQL)
  • MongoDB.Driver
  • Elasticsearch.Net

Установка

Используйте следующие команды для установки пакета:

NuGet Package Manager:

Install-Package Reo.Core.IntegrationTesting

.NET CLI:

dotnet add package Reo.Core.IntegrationTesting

Настройка

Регистрация в DI-контейнере (ASP.NET Core)

Добавьте сервисы в Startup.cs или Program.cs:

services.AddIntegrationTestingServices(); // Если есть кастомные настройки

Конфигурационные параметры

Укажите параметры в appsettings.json или через AddSingleton:

{
 "Testcontainers": {
 "Postgres": {
 "Image": "postgres:15",
 "Username": "test",
 "Password": "test"
 },
 "Mongo": {
 "Image": "mongo:5.0",
 "Username": "test",
 "Password": "test"
 }
 }
}

Использование

Пример 1: Тест с PostgreSQL

[Fact]
public async Task TestWithPostgres()
{
 // Arrange
 var fixture = new PostgresFixture<MyDbContext>();
 var dbContext = fixture.CreateContext();

 // Act
 await dbContext.MyEntities.AddAsync(new MyEntity { Name = "Test" });
 await dbContext.SaveChangesAsync();

 // Assert
 var result = await dbContext.MyEntities.FirstOrDefaultAsync();
 Assert.NotNull(result);
 Assert.Equal("Test", result.Name);
}

Пример 2: Тест с Elasticsearch

[Fact]
public async Task TestWithElasticsearch()
{
 // Arrange
 var fixture = new ElasticFixture();
 var client = fixture.Client;

 // Act
 await client.IndexAsync(new { Id = 1, Name = "Test" }, idx => idx.Index("test-index"));

 // Assert
 var result = await client.SearchAsync<TestDocument>(s => s
 .Index("test-index")
 .Query(q => q.Match(m => m.Field("name").Query("Test"))));
 Assert.Single(result.Documents);
}

Пример 3: Использование AutoMocker

var mocker = new AutoMocker();
mocker.SetupPostgres<MyDbContext>(fixture); // Для PostgreSQL
var service = mocker.CreateInstance<MyService>();
service.DoSomething(); // Тест логики, зависящей от БД

Лицензия

Данный пакет распространяется под лицензией MIT.

Разработано с любовью для тестирования сложных систем! 🚀