property-testing-core — движок property-based тестирования без привязки к фреймворку, со встроенным shrinking
$ composer require --dev rasuvaeff/property-testing-core
$definition = new PropertyDefinition( id: 'demo::everyIntStaysBelowHundred', name: 'everyIntStaysBelowHundred', generators: ['value' => Gen::intBetween(0, 10_000)], parameterNames: ['value'], config: new PropertyConfig(runs: 200, seed: 42),); $result = (new PropertyRunner())->run($definition, new CallableTrialExecutor( static function (int $value): void { if ($value >= 100) { throw new RuntimeException(sprintf('%d is not below 100', $value)); } },));
Движок property-based тестирования со встроенным shrinking, без зависимости от тестового фреймворка.
Вручную подобранные входные данные упускают граничные случаи. Движок генерирует сотни случайных входов, находит падающий и сжимает его (shrinking) до минимального читаемого контрпримера.
Gen: int, float, строки, байты, naughtyString, mixed, массивы, записи.PropertyRunner возвращает структурированные результаты. Он ничего не печатает, не завершает процесс и не бросает исключений, чтобы сообщить об исходе.FilesystemCorpus воспроизводит записанные падения до случайной фазы.flakyReplays раз.Gen::rules).Assume, гейты распределения Classify, целевой поиск, детерминированные прогоны.Property falsified after 0 successful run(s); seed=42 Original: value=3989 Shrunk: value=100 (9 shrink step(s), 39 trial(s)) Changed: value=3989 -> 100 Failure: 100 is not below 100
Целевой поиск поднимает заявленную метрику и доходит до угла, который случайная выборка почти не задевает.
static function (int $a, int $b, int $c): void { Target::maximize('sum', $a + $b + $c); Assert::true($a + $b + $c <= 2_900);0.17% of the space}
Автомат на правилах: правила это шаги, precondition охраняет шаг, invariant проверяется после каждого.
final class QueueMachine{ private array $model = []; public function __construct(private readonly Queue $sut) {} #[Rule] public function enqueue(int $value): void { $this->sut->push($value); $this->model[] = $value; } #[Rule] #[Precondition('notEmpty')] public function dequeue(): void { Assert::same($this->sut->pop(), array_shift($this->model)); } public function notEmpty(): bool { return $this->model !== []; } #[Invariant] public function sizeMatches(): void { Assert::same($this->sut->size(), count($this->model)); }}
Gen::forClass строит генератор по psalm-аннотациям конструктора, с переопределением отдельных параметров.
final readonly class Money{ /** * @param int<0, 1000> $amount * @param non-empty-string $label * @param list<int> $tags */ public function __construct( public int $amount, public string $label, public array $tags, public Currency $currency, ) {}} foreach (Gen::sample(Gen::forClass(Money::class), 3, 7) as $money) { printf(" amount=%d currency=%s\n", $money->amount, $money->currency->name);}$fixed = Gen::forClass(Money::class, ['amount' => Gen::intBetween(500, 510)]);
| Package | Role |
|---|---|
| property-testing-testo(3) | #[Property] для Testo |
| property-testing-phpunit(3) | Fluent forAll()->check() для PHPUnit |
| property-testing-openapi(3) | Запросы, сгенерированные из документа OpenAPI |
| property-testing-names(3) | Генераторы человеческих имён |
Значения берутся из MT19937 с seed из отчёта: это PRNG, а не CSPRNG. Seed — это способ воспроизвести прогон, а не секрет. Корпус хранит падающие входы как обычный JSON.
Требует PHP 8.3–8.5, ext-mbstring, ext-random, ext-tokenizer.
от него зависят: property-testing-names(3), property-testing-openapi(3), property-testing-phpunit(3), property-testing-testo(3), schema(3)
Первый релиз v0.1.0 — 2026-08-09, всего релизов: 22.
| v1.3.0 | 2026-11-03 |
| v1.2.0 | 2026-10-02 |
| v1.1.0 | 2026-09-28 |
| v1.0.0 | 2026-09-20 |
| v0.12.0 | 2026-09-20 |
| v0.11.0 | 2026-09-19 |
| v0.10.0 | 2026-09-12 |
| v0.9.0 | 2026-09-05 |
| v0.8.0 | 2026-09-04 |
| v0.7.0 | 2026-09-04 |
… и ещё 12 раньше. Все релизы
/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу