Пакет · cast

Тестирование

MockTransport заменяет сеть: отвечает из очереди и запоминает, что было отправлено. Всё, что выше сети, остаётся настоящим.

MockTransport

php
use Flytachi\Winter\Cast\Client\CastClient;
use Flytachi\Winter\Cast\Message\CastRequest;
use Flytachi\Winter\Cast\Message\CastResponse;
use Flytachi\Winter\Cast\Transport\MockTransport;

public function testCreatesAnOrder(): void
{
  $mock = new MockTransport(
      CastResponse::fromJson(['id' => 7], 201),
  );
  $client = CastClient::create()->withBaseUrl('https://shop.test/api')->withTransport($mock);

  $id = (new OrderService($client))->create(['sku' => 'A-1']);

  self::assertSame(7, $id);
  self::assertSame('POST', $mock->lastRequest()->getMethod());
  self::assertSame('https://shop.test/api/orders', (string) $mock->lastRequest()->getUri());
  self::assertSame('{"sku":"A-1"}', (string) $mock->lastRequest()->getBody());
}

Настоящими остаются базовый адрес, заголовки по умолчанию, middleware, повторы, редиректы и throwOnError. Поэтому тест проверяет именно то, что уйдёт на сервер.

Что можно положить в очередь

Элемент Что происходит
CastResponse возвращается как ответ
функция fn(CastRequest $request, TransferOptions $options) вызывается и возвращает ответ — для ответов, зависящих от запроса
исключение (Throwable) бросается
MockTransport::fail() падение как при обрыве связи: NetworkException
php
$mock = new MockTransport(
  MockTransport::fail(),                                   // первая попытка — обрыв
  CastResponse::fromString('', 503, ['Retry-After' => '0']),
  fn(CastRequest $r) => CastResponse::fromJson(['path' => $r->getUri()->getPath()]),
);
$mock->append(CastResponse::fromString('ok'));               // дописать в конец

MockTransport::fail($message, $curlErrno): по умолчанию код 7 «не удалось подключиться» — такую ошибку RetryPolicy считает временной и повторяет. Передайте другой код, чтобы проверить ошибку, которая не повторяется.

Если очередь кончилась, следующая отправка падает с CastException и называет запрос, на который не хватило ответа.

Проверка отправленного

Метод Что даёт
requests() все отправленные запросы по порядку — каждую попытку и каждый переход редиректа
lastRequest() последний
remaining() сколько ответов осталось в очереди; 0 в конце теста — все использованы
php
self::assertCount(2, $mock->requests());                    // был один повтор
self::assertSame(0, $mock->remaining());
self::assertSame('Bearer t', $mock->requests()[0]->getHeaderLine('Authorization'));

Ответы для тестов

php
CastResponse::fromJson(['id' => 1]);                          // 200, Content-Type: application/json
CastResponse::fromJson(['error' => 'taken'], 409);
CastResponse::fromString('<html>', 502, ['Content-Type' => 'text/html']);
new CastResponse(204);

Сценарии

Повторы:

php
$mock = new MockTransport(MockTransport::fail(), CastResponse::fromJson(['ok' => true]));
$client = $client->withTransport($mock)->withRetry(RetryPolicy::fixed(2, 0));

$response = $client->get('ping')->send();
self::assertSame(2, $response->info()->attempts);

Редирект:

php
$mock = new MockTransport(
  CastResponse::fromString('', 302, ['Location' => 'https://cdn.test/file']),
  CastResponse::fromString('data'),
);
// второй запрос — на cdn.test и без Authorization

Ошибка статуса:

php
$mock = new MockTransport(CastResponse::fromJson(['message' => 'nope'], 422));

$this->expectException(ClientErrorException::class);
(new OrderService($client->withTransport($mock)))->create([]);

Фасад в тестах

Если тестируемый код использует фасад, подмените его клиент и верните после теста:

php
protected function setUp(): void
{
  $this->mock = new MockTransport();
  Cast::setClient(CastClient::create()->withTransport($this->mock));
}

protected function tearDown(): void
{
  Cast::setClient(null);   // следующий вызов создаст клиент по умолчанию
}