Archive for November 14, 2007

PHPSpec is closing in on its first stable release, so the time had finally come to spruce up its output! No more the simple reporting of failed specs – now you get a few more details in a readable format, exceptions and errors even come with traces. In addition, I’ve implemented specdoc output as an option (using “-s”) so you can get a list of specs in their plain text form.

I’ve pasted in a copy of the output from a real PHPSpec run and added a few issues to show how they are output. I’ve been writing some experimental source code for a possible Mock Object framework in PHP (see last blog entry), so I used PHPSpec to apply Behaviour-Driven Development in its development. You can read the actual spec files over at http://phpmock.googlecode.com/svn/branches/padraic/specs/.

PHPSpec development snapshots have been updated on http://dev.phpspec.org, which also hosts the manual being written (HTML).

$ phpspec -rs

p h p mock method expectations
-should expect each method exactly once unless otherwise specified (ERROR)
-should throw default exception if method call count is unexpected (EXCEPTION)
-should expect number of methods in times term
-should return self from times term invocation
-should set return value in terms and default to returning value for all calls
-should return values in order of setting but return last value remaining on other calls
-should return self from return term invocation
-should set expected args using with term
-should return self from with term invocation
-should allow no calls for zeroormoretimes term
-should allow one call with once term
-should throw exception if less than once using once tern
-should throw exception if greater than once using once term
-should return self instance from once term
-should allow two calls with twice term
-should throw exception if less than twice using twice term
-should throw exception if greater than twice using twice term
-should return self instance from twice term
-should allow no calls with never term
-should throw exception if any call after never term
-should return self instance from never term
-should allow any calls for zeroormoretimes term
-should allow zero calls for zeroormoretimes term
-should return self instance from zeroormoretimes term
-should set times minimum with once using atleast term
-should set times minimum with times using atleast term
-should throw exception if less than minimum using atleast term
-should return self instance from atleast term
-should set times maximum with once using atmost term
-should set times maximum with times using atmost term
-should throw exception if more than twice using twice term
-should return self instance from atmost term
-should allow any args using withanyargs term
-should return self instance from withanyargs term
-should disallow args using withnoargs term
-should return self instance from withnoargs term
-should obey ordering via sequence of ordered term calls
-should disallow method calling if method has specified order
-should allow method calling of unordered expectations in any order
-should return self instance from ordered term
-should throw specified exception using andthrow term
-should throw specified exception with message using andthrow term
-should throw exception if class passed to andthrow term not an exception
-should return self instance from andthrow term

p h p mock
-should create mock inheriting class type from original
-should create mock inheriting type if original an interface
-should create mock with specified name
-should create stub from an array of methods and return values
-should throw exception if class is final
-should throw exception if class does not exist
-should not throw class not exists exception if an interface
-should mock all allowed public methods which do nothing since mocked
-should mock public static methods which do nothing since mocked (PENDING)
-should retain method parameter definitions in mocks
-should return true on validation by default if no expectations set

55 examples, 0 failures, 1 error, 1 exception, 1 pending

Errors:

1)
'p h p mock should mock public static methods which do nothing since mocked' PENDING
Static methods will need static handling