Building a BDD framework with PHP

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.
[sourcecode language=”php”]
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"));
});
[/sourcecode]

We also can use something similar than DataProvider in PHPUnit:

[sourcecode language=”php”]
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’],
]);
[/sourcecode]

And if we need mocks we can use Mockery, for example:

[sourcecode language=”php”]
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");
});
[/sourcecode]

I’ve created an small console application to run the test suites using symfony/console and symfony/finder components. We can run it with:

[sourcecode language=”bash”]
php ./bin/console.php texter:run ./tests
[/sourcecode]

Beware because this library is a proof of concept. There’re a lot of remaining things. What do you think?

Source code at github