Modelling an Extension by Example

Transcript

1. Modelling an Extension by Example Marco Lopes @mpmlopes
2. Modelling By Example
3. What is BDD?
4. Examples
5. Behat PHPSpec
6. Gherkin Scenarios
7. default:
 suites:
 domain:
 contexts: [DomainContext] 
 web:
 contexts: [WebContext]
 filters: { tags: '@critical' }
9. Why Gherkin?
16. Still not good enough!
17. Feature: Uploading images to cloudinary
 In order to be able to provide images via cloudinary 
 As a Store Admin
 I want to be able to upload images to cloudinary
18. Feature: Uploading images to cloudinary
 In order to optimise images for specific web clients 
 As a Store Admin
 I want to be able to upload images to cloudinary
19. Feature: Uploading images to an image provider
 In order to optimise images for specific web clients
 As a Store Admin
 I want to be able to upload images to the image provider
20. Scenario: Uploading an image to cloudinary
 Given I have an image "product1.gif"
 When I upload the image
 Then the image should be uploaded to cloudinary

21. Scenario: Uploading an image to an image provider
 Given I have an image "product1.gif"
 When I upload the image
 Then the image should be uploaded to cloudinary

22. Scenario: Uploading an image to an image provider
 Given I have an image "product1.gif"
 When I upload the image
 Then the image should be available at the provider

23. What changed?
24. Ubiquitous Language
25. Domain
26. /**
 * @Given I have an image :anImage
 */
 public function iHaveAnImage(Image $anImage)
 {
 $this->image = $anImage;
 }
27. /**
 * @When I upload the image
 */
 public function iUploadTheImage()
 {
 $this->imageProvider->upload($this->image);
 }

28. /**
 * @Then the image should be available at the provider
 */
 public function theImageShouldBeAvailableAtTheProvider()
 {
 expect( $this->imageProvider ->isImageAvailable($this->image) )->toBe(true);
 }

29. Image Provider Image Transformation Credentials Key Secret auth() upload()
30. Decoupling
31. Expressive domain
32. /**
 * @Given I have an image :anImage
 */
 public function iHaveAnImage(Image $anImage)
 {
 $this->image = $anImage;
 } Given I have an image "product1.gif"
33. /**
 * @Given I have an image :anImage
 */
 public function iHaveAnImage(Image $anImage)
 {
 $this->image = $anImage;
 } Given I have an image "product1.gif"
34. /**
 * @Transform :anImage
 */
 public function transformPathToAnImage($path)
 {
 return Image::fromPath($path);
 }

35. $image = Image::fromPath($path); $image = new Image($path); When I create an image from the path “path/to/image.gif”

36. Applying Modelling By Example
37. Tools
38. Behat
39. Suites
40. 
 
 @critical Scenario: Uploading an image to an image provider
 Given I have an image "product1.gif"
 When I upload the image
 Then the image should be available at the provider

41. default:
 suites:
 domain:
 contexts: [DomainContext] 
 web:
 contexts: [WebContext]
 filters: { tags: '@critical' }
42. /**
 * @When I upload the image
 */
 public function iUploadTheImage()
 {
 $this->imageProvider->upload($this->image);
 }

43. /**
 * @When I upload the image
 */
 public function iUploadTheImage()
 {
 $loginPage->getPage(‘AdminLogin'); $loginPage->open(); $loginPage->login();
 $uploadPage->getPage('ImageUpload'); $uploadPage->open(); $uploadPage->uploadImage(); }
44. PHPSpec
45. BehatMage
46. MageSpec
47. Magento
48. How did it affect decisions?
49. lib/ vs app/code
50. Naming Conventions
51. Why I went with PSR-4?
52. Consequences of using PSR-4
53. The Benefits
54. Developers
55. Knowing what to do next
56. Easy to get back to the codebase
57. Improved understanding of the domain
58. Decoupling from the Framework
59. Simple and clean code
60. Growth as a Developer
61. Handover
62. Documentation for free
63. Easier for developers to hit the ground running
64. Easier for QAs to understand what to test
65. Bhalin Ramabhadran - QA at SessionDigital “I saw those feature files written by you almost when everything was over. I could not believe myself how much better it would have been if I have had a chance to see them before starting the QA, as those where mostly the questions I was trying to get an answer for. Those features and scenarios were very well written and I could easily understand what the system was trying to achieve. It also gave me thoughts about more edge cases.”
66. Questions? Twitter: @mpmlopes Social Introducing Modelling By Example - http://everzet.com/post/99045129766/introducing-modelling-by-example Named Constructors in PHP - http://verraes.net/2014/06/named-constructors-in-php/ Related Links Short intro to BDD by everzet - https://www.youtube.com/watch?v=njcHzGYv7nI