123 lines
4 KiB
PHP
123 lines
4 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Tests\Unit\Shared;
|
|
|
|
use Shared\Pagination;
|
|
|
|
covers(Pagination::class);
|
|
|
|
describe('Pagination Value Object Unit Tests', function (): void {
|
|
it('can be created from page and page size', function (): void {
|
|
// GIVEN
|
|
$page = 2;
|
|
$size = 20;
|
|
|
|
// WHEN
|
|
$pagination = Pagination::ofPage($page, $size);
|
|
|
|
// THEN
|
|
expect($pagination->from())->toBe(20)
|
|
->and($pagination->to())->toBe(39)
|
|
->and($pagination->pageSize())->toBe(20)
|
|
->and($pagination->pageNumber())->toBe(2);
|
|
});
|
|
|
|
it('can be created from offset and limit', function (): void {
|
|
// GIVEN
|
|
$offset = 20;
|
|
$limit = 10;
|
|
|
|
// WHEN
|
|
$pagination = Pagination::ofOffsetAndLimit($offset, $limit);
|
|
|
|
// THEN
|
|
expect($pagination->from())->toBe(20)
|
|
->and($pagination->to())->toBe(29)
|
|
->and($pagination->pageSize())->toBe(10)
|
|
->and($pagination->pageNumber())->toBe(3);
|
|
});
|
|
|
|
it('can be created from explicit indexes using ofIndexes', function (): void {
|
|
// GIVEN
|
|
$from = 5;
|
|
$to = 14;
|
|
|
|
// WHEN
|
|
$pagination = Pagination::ofIndexes($from, $to);
|
|
|
|
// THEN
|
|
expect($pagination->from())->toBe(5)
|
|
->and($pagination->to())->toBe(14)
|
|
->and($pagination->pageSize())->toBe(10);
|
|
});
|
|
|
|
it('can be created using first page helper', function (): void {
|
|
// GIVEN
|
|
$pageSize = 15;
|
|
|
|
// WHEN
|
|
$pagination = Pagination::firstPage($pageSize);
|
|
|
|
// THEN
|
|
expect($pagination->from())->toBe(0)
|
|
->and($pagination->to())->toBe(14)
|
|
->and($pagination->pageSize())->toBe(15)
|
|
->and($pagination->pageNumber())->toBe(1);
|
|
});
|
|
|
|
it('formats pagination as string representation via __toString', function (): void {
|
|
// GIVEN
|
|
$pagination = Pagination::ofIndexes(0, 9);
|
|
|
|
// WHEN
|
|
$stringRepresentation = (string) $pagination;
|
|
|
|
// THEN
|
|
expect($stringRepresentation)->toBe('Pagination{from=0, to=9}');
|
|
});
|
|
|
|
it('clamps invalid constructor-level values via ofIndexes', function (int $from, int $to, int $expectedFrom, int $expectedTo): void {
|
|
// GIVEN / WHEN
|
|
$pagination = Pagination::ofIndexes($from, $to);
|
|
|
|
// THEN
|
|
expect($pagination->from())->toBe($expectedFrom)
|
|
->and($pagination->to())->toBe($expectedTo);
|
|
})->with([
|
|
'negative from is clamped to 0' => [-1, 10, 0, 10],
|
|
'to below from+1 is clamped to from+1' => [10, 5, 10, 11],
|
|
'to equal from is clamped to from+1' => [10, 10, 10, 11],
|
|
'oversized range is clamped to max' => [0, 10001, 0, 10000],
|
|
]);
|
|
|
|
it('clamps invalid ofPage parameters', function (int $page, int $size, int $expectedPage, int $expectedSize): void {
|
|
// GIVEN / WHEN
|
|
$pagination = Pagination::ofPage($page, $size);
|
|
|
|
// THEN
|
|
expect($pagination->pageNumber())->toBe($expectedPage)
|
|
->and($pagination->pageSize())->toBe($expectedSize);
|
|
})->with([
|
|
'page 0 is clamped to 1' => [0, 10, 1, 10],
|
|
'negative page clamped to 1' => [-1, 10, 1, 10],
|
|
'size 0 is clamped to 1' => [1, 0, 1, 1],
|
|
'negative size clamped to 1' => [1, -5, 1, 1],
|
|
'oversized clamped to max' => [1, 20000, 1, 10000],
|
|
]);
|
|
|
|
it('clamps invalid ofOffsetAndLimit parameters', function (int $offset, int $limit, int $expectedFrom, int $expectedSize): void {
|
|
// GIVEN / WHEN
|
|
$pagination = Pagination::ofOffsetAndLimit($offset, $limit);
|
|
|
|
// THEN
|
|
expect($pagination->from())->toBe($expectedFrom)
|
|
->and($pagination->pageSize())->toBe($expectedSize);
|
|
})->with([
|
|
'negative offset clamped to 0' => [-1, 10, 0, 10],
|
|
'limit 0 clamped to 1' => [0, 0, 0, 1],
|
|
'negative limit clamped to 1' => [0, -5, 0, 1],
|
|
'oversized limit clamped' => [0, 20000, 0, 10000],
|
|
]);
|
|
});
|