Do you know Jasmine, the BDD framework for JavaScript? This holidays I was looking for something like that in PHP and I didn’t found anything similar (please let me know if I’m wrong) (now I know a few of them thanks to Dave’s comment) . Because of that, and as an exercise, I hack a little bit building something similar for PHP.
I want to write as less code as I can (it’s only a proof of concept), so I will reuse the assertion framework or PHPUnit. As I’ve seen when studying Behat, we can use the assertion part as standalone functions. We only need to include vendor/phpunit/phpunit/PHPUnit/Framework/Assert/Functions.php file
Here you can see one example.
class StringCalculator { public function add($string) { return (int)array_sum(explode(",", $string)); } } $stringCalculator = new StringCalculator; describe("add mull returns zero", function () use ($stringCalculator) { assertEquals(null, $stringCalculator->add("")); }); describe("1,1 should return 2", function () use ($stringCalculator) { assertEquals(2, $stringCalculator->add("1,1")); });
We also can use something similar than DataProvider in PHPUnit:
describe("add number returns number", function ($expected, $actual, $message) use ($stringCalculator) { assertEquals($expected, $stringCalculator->add($actual), $message); }, [ ['expected' => 1, 'actual' => "1", 'message' => 'add 1'], ['expected' => 2, 'actual' => "2", 'message' => 'add 1'], ['expected' => 10, 'actual' => "10", 'message' => 'add 10'], ]);
And if we need mocks we can use Mockery, for example:
class Temperature { public function __construct($service) { $this->_service = $service; } public function average() { $total = 0; for ($i=0;$i<3;$i++) { $total += $this->_service->readTemp(); } return $total/3; } } $service = m::mock('service'); describe("testing mocks with mockery", function() use ($service) { $service->shouldReceive('readTemp')->andReturn(11, 12, 13); $temperature = new Temperature($service); assertEquals(12, $temperature->average(), "dummy message"); });
I’ve created an small console application to run the test suites using symfony/console and symfony/finder components. We can run it with:
php ./bin/console.php texter:run ./tests
Beware because this library is a proof of concept. There’re a lot of remaining things. What do you think?
Source code at github