Specking Interactors with PHPSpec and YOLO (DDD) at PHPConference Argentina 2013

Specking Interactors with PHPSpec and YOLO

Toward the scorners he is scornful, but to the humble he gives favor. ~ Proverbs 3:34

Friday, October 4, 13

Take control of your project and live a

simpler life

Toward the scorners he is scornful, but to the humble he gives favor. ~ Proverbs 3:34


Framework != Domain


TestFirst


DomainDomain


Implementations are

DetailsFriday, October 4, 13

http://www.austinchronicle.com/binary/d294/SS.Hook._leftsideonly_.jpg




http://www.collider.com/wp-content/uploads/Inception-movie-poster-2.jpg






http://static.guim.co.uk/sys-images/Film/Pix/pictures/2008/06/06/matrix460.jpg




Signs of Inception


Our FrameworkThe Best


Our PracticesThe Best


Our Communitynever makes

mistakes


Framework isconvenient


But we are notsolving

The Problem






Domain


DomainExpert


BDD


BDDTools

Behat, PhpSpec


but DDD isfor Large Systems ...



show mehow...



Problem: some don’t want to pay for certification exams, so let’s build a community

site for those exams.


Before we jump into the sauce:

Find a qualified examiner,could be a real educator

if not

then try to become one


Spec First ↝ BDD + DDD

Feature: student can take an exam Scenario: student takes an exam Given student starts an exam And student is presented with a question When student answers to question ... Then student ends exam and gets graded


Modeling

feature DSL

BDD Scenario

Learning Process


Modeling

feature DSL entity

service

repository

interactor(use case)

port

value object

BDD Scenario

Support BDD

Learning Process


Modeling

feature DSL entity

service

repository


port

value object

ExamRepository

AttemptRepository

Attempt QuestionExam

Grader Converter

ShowAllExams

GradeAttempt

BDD ScenarioBDD Spec

Support BDD

Learning Process


Modeling

feature DSL entity

service

repository


port

value object

ExamRepository

AttemptRepository


Grader Converter

ShowAllExams

GradeAttempt


Support BDD

DDD Breaking and Fixing Specs

Learning Process


Modeling

feature DSL entity

service

repository


port

value object

ExamRepository

AttemptRepository


Grader Converter

ShowAllExams

GradeAttempt


Support BDD

DDD Refactoring Behavior DDD Breaking and Fixing Specs

Learning Process


Learning Process


Folder Structure

To convey:

- inversion of dependencies

- make dependencies explicit

- domain and infrastructure separation

- bounded context separation


~ tree -L 6 !"" features# !"" student_takes_exam.feature# $"" teacher_builds_exam.feature!"" spec# $"" Simulator# !"" Domain# # !"" Model# # # $"" Exam# # # !"" AttemptSpec.php# # # !"" ExamSpec.php# # # !"" OptionSpec.php# # # $"" QuestionSpec.php# # !"" Port# # # !"" AnswerSpec.php# # # !"" ExamSpec.php

Notice these are specs!






~ tree -L 6 ...# # !"" Port# # # !"" AnswerSpec.php# # # !"" ExamSpec.php# # # $"" ExamsSpec.php# # !"" Services# # # !"" ExamsConverterSpec.php# # # !"" GraderSpec.php# # # $"" PrototypeManagerSpec.php# # !"" Support# # # $"" StudentHelperSpec.php# # $"" UseCase# # !"" GradesAttemptSpec.php






~ tree -L 6 ...# $"" Infrastructure# !"" Cilex# # !"" Command# # # $"" ShowAllExamsCommand.php# # !"" Console# # # $"" Runner.php# # !"" Provider# # # $"" SimulatorServiceProvider.php# # $"" config.yml


~ tree -L 6 ...# $"" Infrastructure| ...# !"" Persistence# # !"" Doctrine# # # $"" OrmExamRepository.php# # !"" InMemoryAttemptRepository.php# # !"" InMemoryExamRepository.php# # $"" PDO# # $"" PdoExamRepository.php# !"" Symfony# # $"" Bundle# # $"" SimulatorBundle# $"" Yolo# $"" Controller# $"" ExamController.php






What if I ask you which classes implement the features?


Folder Structure~ tree -L 6

...# # !"" Port# # # !"" AnswerSpec.php# # # !"" ExamSpec.php# # # $"" ExamsSpec.php# # !"" Services# # # !"" ExamsConverterSpec.php# # # !"" GraderSpec.php# # # $"" PrototypeManagerSpec.php# # !"" Support# # # $"" StudentHelperSpec.php# # $"" UseCase# # !"" GradesAttemptSpec.php

This bring us back to interactors/use cases




Domain ↝ Domain- intention- expressive- explicit


Domain ↝ Domain


Domain ↝ Domain


Show whatyou did :)


"repositories": [ { "type": "vcs", "url": "[email protected]:cordoval/ExamSimulator" } ], "require": { "igorw/yolo": "dev-master", "cordoval/exam-simulator": "dev-master" },


mailto:[email protected]

mailto:[email protected]

~ php bin/console exams:show - yolo - part I- yolo - part IIAll exams displayed


http://craftitonline.com

END






Technology

Specking Interactors with PHPSpec and YOLO (DDD) at PHPConference Argentina 2013