Releases · pestphp/pest

fix: up to 30% faster boot times before your test suite runs (measured on laravel cloud)
fix: if you pass --filter or a test file, --update-snapshots now only updates the snapshots that match

Assets 2

14 Apr 17:33

nunomaduro

v4.6.0

4e03cd3

v4.6.0

feat: time based sharding by @nunomaduro in #1671

For better shard balance, Pest can distribute tests based on their actual execution time using the --update-shards option. This ensures each shard takes roughly the same wall-clock time, minimizing how long your slowest CI job runs.

Step 1: Generate the timing data by running your full test suite with --update-shards:

./vendor/bin/pest --update-shards

This runs all tests and records each test class's duration into tests/.pest/shards.json. You can also combine it with --parallel to speed things up:

./vendor/bin/pest --parallel --update-shards

Step 2: Commit tests/.pest/shards.json to your repository. This file is human-readable and looks like this:

{
    "timings": {
        "Tests\\Feature\\Payments\\StripeCheckoutTest": 1.608,
        "Tests\\Feature\\Reports\\SalesReportTest": 2.105,
        "Tests\\Unit\\Models\\UserTest": 0.050
    },
    "checksum": "...",
    "updated_at": "2026-04-14T10:30:00+00:00"
}

Step 3: When you run --shard and tests/.pest/shards.json exists, Pest automatically uses time-balanced distribution:

./vendor/bin/pest --shard=1/5

The output will indicate that time-balanced sharding is active:

Shard:    1 of 5 — 12 files ran, out of 50 (time-balanced).

Contributors

nunomaduro

Assets 2

10 Apr 20:05

nunomaduro

v4.5.0

13c322b

v4.5.0

Announcement: x.com/enunomaduro/status/2042697927483609449

feat: flaky and --flaky by @nunomaduro
feat: toBeCasedCorrectly arch test assertion by @SimonBroekaert and @nunomaduro in #1455
feat: add '--only-covered' option to '--coverage' by @SimonBroekaert in #1626
fix: typo in Pest.php in stubs by @orphanedrecord in #1653
fix: toUseTrait to detect inherited and nested traits by @yondifon in #1515
fix: missing classes before toExtend on laravel preset by @treyssatvincent in #1569
fix: add "Rules" to laravel preset by @bibrokhim in #1580
fix: enhance support for --parallel and --teamcity arguments by restoring --teamcity for ParaTest and fixing teamcity output concurrency by @smirok in #1615
fix: nested dataset discovery and parallel invalid-dataset reporting by @stsepelin in #1655
fix: preserve unicode characters in filenames for --filter matching by @Vmadmax in #1624
fix: dataset named parameters by @dbpolito in #1634
fix: parameter closure this type annotations in functions by @DevDavido in #1628
fix: dataset inheritance with method chaining (beforeEach()->with(), describe()->with()) by @louisbels in #1565