Українська
Тестування профілів
Крок 1. Файлове сховище в пам’яті
Навіщо. Тести аватарів записують і замінюють файли. З LocalFileStorage вони писали б на диск і потребували б прибирання; гірше того, тест не міг би легко запитати: «скільки файлів зараз збережено?». Підробка (fake) – проста реалізація IFileStorage, що тримає файли в словнику, – робить файли видимими для тесту й швидкою. Тут інтерфейс із теми 5 окупається: сервіси не відчувають різниці.
Що зробити. Створіть Fakes.cs у тестовому проєкті:
cs
using System.Collections.Concurrent;
using Chatex.Data.Abstractions;
namespace Chatex.Core.Tests;
public sealed class InMemoryFileStorage : IFileStorage
{
private readonly ConcurrentDictionary<string, byte[]> _files = new();
public int Count => _files.Count;
public async Task<string> SaveAsync(Stream content, CancellationToken cancellationToken = default)
{
var copy = new MemoryStream();
await content.CopyToAsync(copy, cancellationToken);
var path = $"test/{Guid.NewGuid():N}";
_files[path] = copy.ToArray();
return path;
}
public Task<Stream> OpenReadAsync(string storagePath, CancellationToken cancellationToken = default) =>
_files.TryGetValue(storagePath, out var bytes)
? Task.FromResult<Stream>(new MemoryStream(bytes))
: throw new FileNotFoundException(storagePath);
public Task DeleteAsync(string storagePath, CancellationToken cancellationToken = default)
{
_files.TryRemove(storagePath, out _);
return Task.CompletedTask;
}
}ConcurrentDictionaryробить його безпечним, якщо два виклики колись перекриються.Count– число, яке перевіряють тести: після заміни аватара має бути рівно один файл.OpenReadAsyncкидаєFileNotFoundExceptionдля невідомого шляху, як задокументовано в інтерфейсі з теми 5: підробка має дотримуватися контракту справжньої реалізації.
Крок 2. Використання підробки в базовому класі
Навіщо. Тестова база реєструє підробку й отримує допоміжні методи для сервісу профілів та для створення завантажень.
Що зробити. Розширте BusinessTestBase (нові рядки зеленим):
cs
using Chatex.Core.Auth;
using Chatex.Core.Common;
using Chatex.Core.Users;
using Chatex.Data.Abstractions;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection.Extensions;
using Microsoft.Extensions.Time.Testing;
// Tests share one database that is wiped before each test; xunit.runner.json turns off parallel runs.
[assembly: AssemblyFixture(typeof(PostgresFixture))]
namespace Chatex.Core.Tests;
public abstract class BusinessTestBase(PostgresFixture fixture) : DatabaseTest(fixture)
{
public const string Password = "Passw0rd!";
public const string Issuer = "chatex-tests";
public const string SigningKey = "test-signing-key-that-is-long-enough-for-hmac";
protected FakeTimeProvider Time { get; } = new(DateTimeOffset.UtcNow);
protected InMemoryFileStorage Files { get; } = new();
protected override void ConfigureServices(IServiceCollection services, string connectionString)
{
var configuration = new ConfigurationBuilder()
.AddInMemoryCollection(new Dictionary<string, string?>
{
["ConnectionStrings:Chatex"] = connectionString,
["Storage:RootPath"] = StorageRoot,
["Jwt:Issuer"] = Issuer,
["Jwt:Audience"] = Issuer,
["Jwt:SigningKey"] = SigningKey,
})
.Build();
services.AddSingleton<TimeProvider>(Time);
services.AddCore(configuration);
services.Replace(ServiceDescriptor.Singleton<IFileStorage>(Files));
}
protected Task<T> Auth<T>(Func<IAuthService, Task<T>> call) => Use(call);
protected Task<T> Profiles<T>(Func<IProfileService, Task<T>> call) => Use(call);
/// <summary>Registers <paramref name="userName"/> and returns the signed-in session.</summary>
protected async Task<AuthResult> RegisterAsync(string userName)
{
var result = await Auth(s => s.RegisterAsync(
new RegisterCommand(userName, $"{userName}@example.test", Password, $"{userName} display"), ClientInfo.Unknown, Ct));
return result.ShouldSucceed();
}
protected async Task<Guid> RegisterUserAsync(string userName) => (await RegisterAsync(userName)).User.Id;
protected static FileUpload Upload(int size, string contentType, long? claimedLength = null) =>
new(new MemoryStream(new byte[size]), "photo.png", contentType, claimedLength ?? size);
private async Task<T> Use<TService, T>(Func<TService, Task<T>> call) where TService : notnull
{
await using var scope = NewScope();
return await call(Get<TService>(scope));
}
}
internal static class ResultAssertions
{
public static T ShouldSucceed<T>(this Result<T> result)
{
result.IsSuccess.ShouldBeTrue($"Expected success but got {result.Error}");
return result.Value;
}
public static void ShouldSucceed(this Result result) =>
result.IsSuccess.ShouldBeTrue($"Expected success but got {result.Error}");
public static Error ShouldFail<T>(this Result<T> result, ErrorKind kind, string code)
{
result.IsSuccess.ShouldBeFalse("Expected a failure but the operation succeeded.");
result.Error.Kind.ShouldBe(kind);
result.Error.Code.ShouldBe(code);
return result.Error;
}
public static Error ShouldFail(this Result result, ErrorKind kind, string code)
{
result.IsSuccess.ShouldBeFalse("Expected a failure but the operation succeeded.");
result.Error.Kind.ShouldBe(kind);
result.Error.Code.ShouldBe(code);
return result.Error;
}
}services.Replace(ServiceDescriptor.Singleton<IFileStorage>(Files))виконується післяAddCore:Replaceвидаляє реєстраціюLocalFileStorage, зробленуAddData, і ставить на її місце підробку. (Годинник ми реєстрували першим і покладалися наTryAddSingleton; для сховищаAddDataвикористовує звичайнийAddSingleton, тож його треба замінювати потім.)Profiles<T>– однорядковий допоміжний метод для нового сервісу.Upload(size, contentType, claimedLength)будуєFileUploadізMemoryStreamзsizeнульових байтів;claimedLengthдозволяє тестові збрехати про довжину, як це зробив би ворожий клієнт.
Крок 3. Тести профілів
Що зробити.
cs
using Chatex.Core.Auth;
using Chatex.Core.Common;
using Chatex.Core.Users;
namespace Chatex.Core.Tests;
public sealed class ProfileServiceTests(PostgresFixture fixture) : BusinessTestBase(fixture)
{
[Fact]
public async Task UpdateProfileAsync_changes_display_name_and_bio()
{
var alice = await RegisterUserAsync("alice");
var updated = await Profiles(s => s.UpdateProfileAsync(alice, new UpdateProfileCommand(" Alice A. ", " "), Ct));
var seenByOthers = await Profiles(s => s.GetUserAsync(alice, Ct));
updated.ShouldSucceed().DisplayName.ShouldBe("Alice A.");
seenByOthers.ShouldSucceed().DisplayName.ShouldBe("Alice A.");
seenByOthers.Value.Bio.ShouldBeNull();
}
[Fact]
public async Task ChangePasswordAsync_ends_all_sessions()
{
var session = await RegisterAsync("alice");
(await Profiles(s => s.ChangePasswordAsync(session.User.Id, new ChangePasswordCommand(Password, "NewPassw0rd"), Ct)))
.ShouldSucceed();
(await Auth(s => s.RefreshAsync(new RefreshCommand(session.RefreshToken), ClientInfo.Unknown, Ct)))
.ShouldFail(ErrorKind.Unauthorized, "invalid_refresh_token");
(await Auth(s => s.LoginAsync(new LoginCommand("alice", "NewPassw0rd"), ClientInfo.Unknown, Ct))).ShouldSucceed();
}
[Fact]
public async Task ChangePasswordAsync_requires_the_current_password()
{
var alice = await RegisterUserAsync("alice");
var result = await Profiles(s => s.ChangePasswordAsync(alice, new ChangePasswordCommand("Wrong1234", "NewPassw0rd"), Ct));
result.ShouldFail(ErrorKind.Validation, "wrong_password");
}
[Fact]
public async Task SetAvatarAsync_accepts_images_only_and_replaces_the_old_file()
{
var alice = await RegisterUserAsync("alice");
(await Profiles(s => s.SetAvatarAsync(alice, Upload(10, "text/html"), Ct)))
.ShouldFail(ErrorKind.Validation, "avatar_invalid_type");
(await Profiles(s => s.SetAvatarAsync(alice, Upload(10, "image/png"), Ct))).ShouldSucceed().HasAvatar.ShouldBeTrue();
(await Profiles(s => s.SetAvatarAsync(alice, Upload(20, "image/webp"), Ct))).ShouldSucceed();
Files.Count.ShouldBe(1);
await using var avatar = (await Profiles(s => s.OpenAvatarAsync(alice, Ct))).ShouldSucceed();
avatar.Length.ShouldBe(20);
}
[Fact]
public async Task SearchUsersAsync_needs_two_characters_and_finds_by_display_name()
{
await RegisterUserAsync("alice");
await RegisterUserAsync("bob");
(await Profiles(s => s.SearchUsersAsync("a", null, Ct))).ShouldFail(ErrorKind.Validation, "query_too_short");
(await Profiles(s => s.SearchUsersAsync("BOB DISP", null, Ct))).ShouldSucceed().Select(u => u.UserName).ShouldBe(["bob"]);
}
}- Оновлення обрізає пробіли в імені й перетворює порожній опис на
null; інший користувач бачить нове ім’я. - Зміна пароля завершує всі сесії – старий токен оновлення відхиляється – і новий пароль працює для входу.
- Хибний поточний пароль дає
wrong_passwordяк помилку перевірки. - Аватари: файл HTML відхиляється; PNG зберігається; WebP замінює його, і після цього лишається рівно один файл – старий видалено. Збережений аватар має розмір другого завантаження.
- Пошук вимагає двох символів і знаходить користувачів за відображуваним іменем у будь-якому регістрі (
"BOB DISP"знаходитьbob display).
Перевірка
powershell
dotnet test --solution Chatex.slnxПроходить 36 тестів: 19 тестів даних і 17 бізнес-тестів.