My slides on PHPSpec 2 from Symfony November Camp Stockholm. www.symfony.se/november-camp/ More Domain-Driven Design related content at: https://domaincentric.net/

1. Spec BDD WITH
PHPSPEC 2
November Camp
Stockholm 22/11/2013
flickr.com/arnolouise/3252847397/

2. Kacper Gunia @cakper
Software Engineer @SensioLabsUK
Symfony Certified Developer
Polish Symfony Community
Silesian PHP User Group

3. Softw
are
Quality
flickr.com/adforce1/2462794123/

4. INTERNAL
Quality
flickr.com/ensh/5084228263/

5. EXTERNAL
Quality
flickr.com/arselectronicacenter/8695704856/

6. INTERNAL
vs
EXTERNAL

7. It’s NOT VS

8. It’s AND

9. InnerNAL
And
EXTERNAL
flickr.com/pmiaki/6768810175/

10. How to ensure
quality?
Test

11. How to test?
Automa
te

12. So you WRITE
your code…

13. …and your tests

14. HOW DARE YOU?

15. are YOU sure
Tests ARE
correct?

16. Test
Driven
Development

17. Red
Refactor
Green

18. BUT…

19. test Something
tha doesn’t
t
exists?
flickr.com/ucumari/580865728/

20. Test In TDD
means
Specifica
tion

21. Specifica
tion
describes
Beha
vior

22. BeHa
vior
Driven
Development

23. IMPROVED
Naming
Conventions
Tools

24. TDD
v2.0
‘TDD DONE RIGHT’

25. Story BDD
&
Spec BDD

26. STORY BDD
description of
business-targeted
application behavior

27. SPEC BDD
specification for
low-level
implementation

28. Story BDD
Failing
Scenario
Passing
Scenario
Failing
Spec
RefacTOR
Passing
Spec
SPEC BDD

29. External quality
Failing
Scenario
Passing
Scenario
Failing
Spec
RefacTOR
Passing
Spec
INTERNAL QUALITY

30. BEHA
T
(Story BDD)
&
PHPSpec
(Spec BDD)

31. BEHA
T
(Story BDD)
&
PHPSpec
(Spec BDD)

32. PHPSPEC 2
FRAMEWORK SPEC BDD
CREATED BY
@_MD & @EVERZET

33. PHPSPEC 2
Bundled With Mocking
Framework - Prophecy

34. BUT…

35. WHY NOT
PHPUNIT?

36. PHPUNIT Is A
TESTING TOOL

37. PHPSPEC Is A
DESIGN TOOL

38. EVIDENCE?

39. PHPUNIT

40. PHPSPEC

41. Differences?

42. tEST Suite
Specifica
tion

43. tEST
EXAMPLE

44. Assertion
expect tion
a

46. class
MovieSpec
extends
ObjectBehavior
{
function
it_returns_movie_title()
{
$this-­‐>getTitle()
-­‐>shouldReturn('Star
Wars');
}
}

47. Ma
tchers

48. IDENTITY MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_is_a_great_movie()
{
$this-­‐>getRating()-­‐>shouldBe(5);
$this-­‐>getTitle()
-­‐>shouldBeEqualTo('Star
Wars');
$this-­‐>getReleaseDate()
-­‐>shouldReturn(233366400);
}
}

49. COMPARISON MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_is_great_movie()
{
$this-­‐>getRating()-­‐>shouldBeLike('5');
}
}

50. THROW MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_does_not_allow_negative_ratings()
{
$this
-­‐>shouldThrow('InvalidArgumentException')
-­‐>duringSetRating(-­‐3);
}
}

51. THROW MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_does_not_allow_negative_ratings()
{
$this-­‐>shouldThrow(
new
InvalidArgumentException(
"Invalid
rating”
)
)-­‐>during('setRating',
array(-­‐3));
}
}

52. TYPE MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_is_a_movie()
{
$this-­‐>shouldHaveType('Movie');
$this-­‐>shouldReturnAnInstanceOf('Movie');
$this-­‐>shouldBeAnInstanceOf('Movie');
$this-­‐>shouldImplement('Movie');
}
}

53. OBJECT-STATE MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_is_available_on_cinemas()
{
$this-­‐>shouldBeAvailableOnCinemas();
}
}
!
class
Movie
{
public
function
isAvailableOnCinemas()
{
return
true;
}<?php
}

54. OBJECT-STATE MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_has_a_soundtrack()
{
$this-­‐>shouldHaveSoundtrack();
}
}
!
class
Movie
{
public
function
hasSoundtrack()
{
return
true;
}
}

55. COUNT MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_has_one_director()
{
$this-­‐>getDirectors()-­‐>shouldHaveCount(1);
}
}

56. SCALAR MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_has_a_string_as_title()
{
$this-­‐>getTitle()-­‐>shouldBeString();
}
!
function
it_has_an_array_as_cast()
{
$this-­‐>getCast()-­‐>shouldBeArray();
}
}

57. INLINE MATCHER
class
MovieSpec
extends
ObjectBehavior
{
function
it_has_default_options()
{
$this-­‐>getOptions()-­‐>shouldHaveKey('username');
}
!
public
function
getMatchers()
{
return
[
'haveKey'
=>
function($subject,
$key)
{
return
array_key_exists($key,
$subject);
}
];
}
}

58. BUT…

59. Softw
are Design
is about
Messaging

60. TEST DOUBLES

61. DUMMIES
class
CinemaSpec
extends
ObjectBehavior
{
/**
*
@param
BoxOffice
$boxOffice
*/
function
it_is_a_cinema($boxOffice)
{
$this-­‐>beConstructedWith($boxOffice);
$this-­‐>shouldHaveType('Cinema');
}
}

62. STUBS
class
CinemaSpec
extends
ObjectBehavior
{
/**
*
@param
Movie
$movie
*/
function
it_displays_big_movie_title($movie)
{
$movie-­‐>getTitle()
-­‐>willReturn('Star
Wars’);
!
$this-­‐>displayTitle($movie)
-­‐>shouldReturn('<h1>Star
Wars</h1>');
}
}

63. MOCKS
class
CinemaSpec
extends
ObjectBehavior
{
/**
*
@param
DvdPlayer
$dvdPlayer
*
@param
MovieDisc
$movieDisc
*/
function
it_plays_movie($dvdPlayer,
$movieDisc)
{
$dvdPlayer-­‐>playDisc($movieDisc)
-­‐>shouldBeCalled();
!
$this-­‐>setPlayer($dvdPlayer);
$this-­‐>playMovie($movieDisc);
}
}

64. SPIES
class
CinemaSpec
extends
ObjectBehavior
{
/**
*
@param
DvdPlayer
$dvdPlayer
*
@param
MovieDisc
$movieDisc
*/
function
it_plays_movie($dvdPlayer,
$movieDisc)
{
$this-­‐>setPlayer($dvdPlayer);
$this-­‐>playMovie($movieDisc);
!
$dvdPlayer-­‐>playDisc($movieDisc)
-­‐>shouldHaveBeenCalled();
}
}

65. SET UP & TEAR DOWN
class
CinemaSpec
extends
ObjectBehavior
{
/**
*
@param
BoxOffice
$boxOffice
*/
function
let($boxOffice)
{
$this-­‐>beConstructedWith($boxOffice);
}
!
function
letGo()
{
$this-­‐>tellPeopleToGoHome();
}
}

66. BUT…

67. HOW TO
‘DESIGN’?

68. THREE RULES OF TDD
1.
2.
3.
WRITE NO PRODUCTION CODE EXCEPT
TO PASS A FAILING TEST
WRITE ONLY ENOUGH OF A TEST
TO DEMONSTRATE A FAILURE
WRITE ONLY ENOUGH PRODUCTION
CODE TO PASS A TEST

69. 4 RULES OF SIMPLE DESIGN
1.
2.
3.
4.
Passes all the tests
Express every idea we need to
express
Contains no duplication
Minimized the number of classes,
methods and other moving parts

70. SMELLS
1.
2.
3.
4.
CODE SMELLS
TEST SMELLS
DRY SMELLS
…and others

71. And?

72. QUICK START
{
"require-­‐dev":
{
"phpspec/phpspec":
"2.0.*@dev"
},
"config":
{
"bin-­‐dir":
"bin"
},
"autoload":
{"psr-­‐0":
{"":
"src"}}
}
http://phpspec.net/

73. THANK YOU!
?
JOIND.IN/10130