Українська
Перші тести
Крок 1. Базовий клас із допоміжними методами заповнення даних
Навіщо. Майже кожному тесту рівня даних потрібні користувачі, чати й повідомлення, перш ніж він зможе щось перевірити. Якби створювати їх у самому тесті, кожен тест мав би 30 рядків підготовки й 3 рядки по суті. Базовий клас тестів даних реєструє рівень даних і пропонує короткі допоміжні методи заповнення (seeding helpers): CreateUserAsync("alice"), CreateChatAsync(ChatType.Direct, alice, [bob]), AddMessagesAsync(chat, alice, 120).
Що зробити. Створіть базовий клас у Chatex.Data.Tests:
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Microsoft.AspNetCore.Identity;
using Microsoft.Extensions.DependencyInjection;
// Tests share one database that is wiped before each test; xunit.runner.json turns off parallel runs.
[assembly: AssemblyFixture(typeof(PostgresFixture))]
namespace Chatex.Data.Tests;
/// <summary>Data access layer on a clean database, plus seeding helpers.</summary>
public abstract class DbTestBase(PostgresFixture fixture) : DatabaseTest(fixture)
{
protected override void ConfigureServices(IServiceCollection services, string connectionString) =>
services.AddData(connectionString, o => o.RootPath = StorageRoot);
protected async Task<User> CreateUserAsync(string userName)
{
await using var scope = NewScope();
var user = new User { UserName = userName, Email = $"{userName}@example.test" };
var result = await Get<UserManager<User>>(scope).CreateAsync(user, "Passw0rd!");
result.Succeeded.ShouldBeTrue(string.Join("; ", result.Errors.Select(e => e.Description)));
Get<IUserRepository>(scope).AddProfile(new UserProfile { UserId = user.Id, DisplayName = userName.ToUpperInvariant() });
await Get<IUnitOfWork>(scope).SaveChangesAsync(Ct);
return user;
}
protected async Task<Chat> CreateChatAsync(
ChatType type, User owner, IEnumerable<User> others, DateTimeOffset? lastActivityAt = null)
{
await using var scope = NewScope();
var othersList = others.ToList();
var chat = new Chat
{
Type = type,
Title = type == ChatType.Direct ? null : $"{type} chat",
DirectKey = type == ChatType.Direct ? Chat.MakeDirectKey(owner.Id, othersList.Single().Id) : null,
CreatedById = owner.Id,
LastActivityAt = lastActivityAt ?? default,
};
var ownerRole = type == ChatType.Direct ? ChatMemberRole.Member : ChatMemberRole.Owner;
var otherRole = type == ChatType.Channel ? ChatMemberRole.Subscriber : ChatMemberRole.Member;
chat.Members.Add(new ChatMember { UserId = owner.Id, Role = ownerRole });
foreach (var other in othersList)
{
chat.Members.Add(new ChatMember { UserId = other.Id, Role = otherRole });
}
Get<IChatRepository>(scope).Add(chat);
await Get<IUnitOfWork>(scope).SaveChangesAsync(Ct);
return chat;
}
/// <summary>Adds messages whose UUIDv7 ids are one millisecond apart, so their order is known.</summary>
protected async Task<List<Message>> AddMessagesAsync(Chat chat, User sender, int count)
{
await using var scope = NewScope();
var start = DateTimeOffset.UtcNow.AddMinutes(-count);
var messages = Enumerable.Range(0, count)
.Select(i => new Message
{
Id = Guid.CreateVersion7(start.AddMilliseconds(i)),
ChatId = chat.Id,
SenderId = sender.Id,
Body = $"message {i}",
})
.ToList();
var repository = Get<IMessageRepository>(scope);
messages.ForEach(repository.Add);
await Get<IUnitOfWork>(scope).SaveChangesAsync(Ct);
return messages;
}
}[assembly: AssemblyFixture(typeof(PostgresFixture))]реєструє фікстуру з попереднього розділу для всього тестового проєкту. xUnit створює її один раз і передає до конструктора кожного тестового класу, який про неї просить, – тут через первинні конструкториDbTestBase(PostgresFixture fixture)іDatabaseTest(fixture).ConfigureServicesреєструє справжній рівень даних із тимчасовою папкою тесту для файлів.- Кожен допоміжний метод використовує власну область і зберігає дані перед поверненням, достоту як окремий запит.
- Користувачів створюють через
UserManager, так, як їх створюватиме застосунок, щоб нормалізоване ім’я й штамп безпеки було задано так, як очікує Identity. AddMessagesAsyncдає повідомленням ідентифікатори рівно з різницею в одну мілісекунду за допомогоюGuid.CreateVersion7(timestamp). У темі 3 ми бачили, що ідентифікатори, створені в ту саму мілісекунду, мають випадковий порядок; тест посторінкового читання мусить напевно знати порядок.lastActivityAt ?? default– передаванняdefaultдозволяє перехоплювачу проставити час; тест, якому важливий порядок чатів, передає явні часи.
Крок 2. Перший тест
Навіщо. Наш перший тест доводить найважливіше правило моделі даних: пара користувачів може мати лише один особистий чат, у якому б порядку вони не йшли. Добрий тест читається як правило, яке перевіряє, – ім’я методу і є правилом, зі знаками підкреслення між словами (.editorconfig з теми 2 дозволяє такі імена в Tests/).
Кожен тест має три частини, розділені порожніми рядками:
- Arrange (підготовка) – створити ситуацію: двоє користувачів і особистий чат між ними;
- Act (дія) – зробити єдине, що тестується: створити той самий чат навпаки;
- Assert (перевірка) – перевірити результат: збереження завершується нашим винятком, що називає унікальний індекс.
Що зробити. Створіть тестовий клас із двома першими тестами:
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Chatex.Data.Exceptions;
using Microsoft.EntityFrameworkCore;
using Npgsql;
namespace Chatex.Data.Tests;
public sealed class ChatRepositoryTests(PostgresFixture fixture) : DbTestBase(fixture)
{
[Fact]
public async Task A_pair_of_users_can_have_only_one_direct_chat()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
await CreateChatAsync(ChatType.Direct, alice, [bob]);
var error = await Should.ThrowAsync<UniqueConstraintException>(() => CreateChatAsync(ChatType.Direct, bob, [alice]));
error.ConstraintName.ShouldBe("ix_chats_direct_key");
}
[Fact]
public async Task Only_direct_chats_have_a_direct_key()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
await using var scope = NewScope();
Get<IChatRepository>(scope).Add(new Chat
{
Type = ChatType.Group,
Title = "group",
DirectKey = Chat.MakeDirectKey(alice.Id, bob.Id),
CreatedById = alice.Id,
});
var error = await Should.ThrowAsync<DbUpdateException>(() => Get<IUnitOfWork>(scope).SaveChangesAsync(Ct));
error.InnerException.ShouldBeOfType<PostgresException>().SqlState.ShouldBe(PostgresErrorCodes.CheckViolation);
}
}[Fact]позначає тестовий метод без параметрів. Тестиasync TaskxUnit очікує через await.Should.ThrowAsync<T>(() => …)виконує лямбду й проходить, лише якщо вона викидаєT; повертає виняток для подальших перевірок.ShouldBeіShouldBeOfType<T>()– твердження Shouldly, записані як методи розширення значення, що перевіряється.ShouldBeOfType<T>()також повертає значення, приведене доT, тож ланцюжок може продовжитися.SqlState.- Другий тест доводить обмеження перевірки з теми 4. Воно не перетворюється на наш виняток – так перетворюють лише порушення унікальності, – тож тест очікує
DbUpdateExceptionз EF Core з кодом помилки PostgreSQL усередині.
Крок 3. Запустіть тести
Що зробити. Переконайтеся, що Docker Desktop працює, потім запустіть усі тести рішення з кореня репозиторію:
powershell
dotnet test --solution Chatex.slnxПерший запуск завантажує образ postgres:18-alpine, якщо його ще немає на вашому комп’ютері (він у вас є з compose.yaml), і невеликий допоміжний образ Testcontainers.
Перевірка
Підсумок наприкінці:
Test run summary: Passed!
total: 2
failed: 0
succeeded: 2
skipped: 0Поки тести виконуються, docker ps в іншому терміналі показує другий контейнер PostgreSQL із випадковим портом поряд із вашою базою даних розробки; після запуску його немає.
Щоб запустити один проєкт, один клас або кілька методів, використовуйте параметри Microsoft Testing Platform:
powershell
dotnet test --project Tests/Chatex.Data.Testspowershell
dotnet test --project Tests/Chatex.Data.Tests --filter-class "*ChatRepositoryTests"powershell
dotnet test --project Tests/Chatex.Data.Tests --filter-method "*direct_key*"Середовища розробки запускають ті самі тести з оглядача тестів (Visual Studio: Test → Test Explorer; Rider: Unit Tests; VS Code: подання Testing у C# Dev Kit) із кнопкою на кожен тест.
./Run.ps1 test --solution Chatex.slnx передає свої параметри в dotnet test, а ./Run.ps1 clean тепер працює, бо папка Tests/ існує (табл. 2.2 з теми 2).
Крок 4. Подивіться, як тест падає
Навіщо. Тест, який ви ніколи не бачили падаючим, може нічого не перевіряти – через пропущений await або хибне твердження він може проходити вічно. Один раз навмисно зламайте код і прочитайте, що каже збій.
Що зробити. У ChatConfiguration закоментуйте унікальний індекс на прямому ключі:
cs
// builder.HasIndex(c => c.DirectKey).IsUnique();Тести застосовують міграції, а не модель, тож індекс усе одно створюється – конфігурація й міграція тепер розходяться. Запустіть тести: обидва проходять. Це саме та ситуація, для якої існує has-pending-model-changes (тема 4):
powershell
dotnet ef migrations has-pending-model-changes --project Source/Chatex.DataВін повідомляє про зміни. Тепер зламайте натомість міграцію: відновіть конфігурацію, потім у вашому *_InitialCreate.cs видаліть виклик migrationBuilder.CreateIndex(...) для ix_chats_direct_key і запустіть перший тест:
powershell
dotnet test --project Tests/Chatex.Data.Tests --filter-method "*only_one_direct_chat*"Перевірка
Тест падає, і Shouldly каже, чого очікував:
failed Chatex.Data.Tests.ChatRepositoryTests.A_pair_of_users_can_have_only_one_direct_chat
Shouldly.ShouldAssertException : Task `CreateChatAsync(ChatType.Direct, bob, [alice])`
should throw
Chatex.Data.Exceptions.UniqueConstraintException
but did notВідновіть міграцію (git restore Source/Chatex.Data/Migrations) і запустіть тест знову: він проходить.