alies-dev / psalm-plugin-pest

0.2.3 2026-10-05 21:39 UTC

Requires

• php: ^8.3
• nikic/php-parser: ^5.0
• vimeo/psalm: ^6.19 || ^7.0.0-rc1 || dev-master

Requires (Dev)

• alies-dev/psalm-tester: ^0.4
• friendsofphp/php-cs-fixer: ^3.94
• pestphp/pest: ^4.0 || ^5.0
• phpunit/phpunit: ^12.5 || ^13.3
• rector/rector: ^2.5
• symfony/filesystem: ^7.4 || ^8.0
• symfony/process: ^7.4 || ^8.0

Suggests

• pestphp/pest: The test framework this plugin models. Without it installed the plugin is inert.

MIT

• Alies Lapatsin

• dev
• static-analysis
• pest
• psalm
• psalm-plugin

Published on Packagist.org on 2026-10-05 21:39 UTC

README

Makes Psalm understand Pest tests.

composer require --dev alies-dev/psalm-plugin-pest
vendor/bin/psalm-plugin enable alies-dev/psalm-plugin-pest

Requires PHP 8.3+, Psalm 6.19+ or 7 (including dev-master) and Pest 4 or 5. Your tests/ directory must be in <projectFiles>.

What it does

• Types $this in test, hook and dataset closures as the TestCase from uses() / pest()->extend(), including traits from uses() / ->use().
• Declares $this->x assigned in beforeEach() (in the file or in tests/Pest.php hooks) for the tests it applies to.
• Types test() with no arguments as the bound TestCase, and resolves higher-order tests like it('x')->actingAsAdmin().
• Types expectation chains: ->not, ->each, higher-order members (expect($user)->name->toBe('Ada')), and expect($v) as Expectation<T>.
• Narrows variables after type assertions: expect($user)->not->toBeNull() makes $user non-null.
• Stops reporting InternalMethod on Pest's public API.
• Reports PestHookInDescribe for beforeAll() / afterAll() inside describe(), which Pest rejects when loading the file.
• Reports PestStaticTestClosure for a static closure passed to test(), it(), beforeEach() or afterEach(), since Pest cannot bind $this to it.
• Reports PestDuplicateTestDescription for a second test with the same description in a file (scoped by describe()), which Pest rejects when loading the file.
• Reports PestImpossibleExpectation when a type matcher such as expect(42)->toBeString() can never pass for the value's type.

Known limitations

• tests/Pest.php is looked up next to your Psalm config, and a test file outside tests/ keeps Pest's own types.
• Files are parsed, never executed: a boot file with dynamic uses() calls disables TestCase resolution for the suite.
• Custom expectations from expect()->extend() are still reported.
• Narrowing works on plain variables only, not $this->prop.

License

MIT, see LICENSE.