PSpec
PSpec is a testing framework for PHP, influenced by RSpec and jest.
This project is experimental and still needs a lot of work.
Example
// src/Counter.php
class Counter {
public int $value = 0;
function increment() {
$this->value++;
}
}
// spec/Counter.spec.php
describe(Counter::class, function () {
subject(fn () => new Counter);
let('base_value', 10);
before(function () {
subject()->value = $this->base_value;
});
describe('#increment', function () {
it('increments by 1', function () {
expect(subject()->value)->toBe($this->base_value);
subject()->increment();
expect(subject()->value)->toBe($this->base_value + 1);
});
});
});
Getting started
- Install PSpec:
composer require --dev codingpaws/pspec - In your project root, create a
specdirectory - For a class in your project, for example
Counter, create a filespec/Counter.spec.php - Write some tests, like the example
- Run PSpec:
vendor/bin/pspec
Why?
PSpec models your application with natural language. In PHPUnit—the de facto standard in PHP testing—a test file contains a sequential list of tests. If two tests are related in PHPUnit, such as one authenticated and one unauthenticated request, it’s hard to understand.
In PSpec, tests are nested under real-world conditions, such as being signed-in or when a network error occurs. You use describe blocks to organize tests.
112 Feb 15, 2022
6 Nov 9, 2022
10 Aug 18, 2022
21 Dec 13, 2022
3 Dec 3, 2021
14 May 17, 2022
689 Dec 27, 2022
11 Aug 19, 2022
259 Jan 5, 2023
165 Oct 17, 2022
0 Dec 26, 2021
5 Feb 27, 2022
32 Mar 30, 2020
28 Jan 20, 2022
2 Aug 18, 2021
9 Nov 14, 2022
6 Oct 6, 2022
112 Nov 24, 2022
2 Jun 6, 2022