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

Test
First

Domain
Domain

Implementations
are

Details

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 Framework
The Best

Our Practices
The Best

Our Community
never makes
mistakes

Framework is
convenient

But we are not
solving
The Problem

Domain
Expert

BDD
Tools
Behat, PhpSpec

but DDD is
for Large
Systems ...

show me
how...

Problem: some don’t want to pay for
certiﬁcation exams, so let’s build a community
site for those exams.

Before we jump into the sauce:
Find a qualiﬁed 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
BDD Scenario

feature

DSL

Learning Process

Modeling
repository

BDD Scenario

feature

DSL
Support BDD

entity

value
object

service

interactor
(use case)

port

Learning Process

Modeling
Exam
Repository

Attempt
Repository

Exam

Attempt

service

Grader

Converter

interactor
(use case)

ShowAll
Exams

Grade
Attempt

repository

BDD Scenario

feature

DSL
Support BDD

entity

BDD Spec

value
object

port

Learning Process

Question

Modeling
Exam
Repository

Attempt
Repository

Exam

Attempt

service

Grader

Converter

interactor
(use case)

ShowAll
Exams

Grade
Attempt

repository

BDD Scenario

feature

DSL
Support BDD

entity

BDD Spec

value
object

port

Learning Process

Question

DDD Breaking and Fixing Specs

Modeling
Exam
Repository

Attempt
Repository

Exam

Attempt

service

Grader

Converter

interactor
(use case)

ShowAll
Exams

Grade
Attempt

repository

BDD Scenario

feature

DSL
Support BDD

DDD Refactoring Behavior

entity

BDD Spec

value
object

port

Learning Process

Question

DDD Breaking and Fixing Specs

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
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


~ 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


Show what
you did :)

"repositories": [
{
"type": "vcs",
"url": "git@github.com:cordoval/ExamSimulator"
}
],
"require": {
"igorw/yolo": "dev-master",
"cordoval/exam-simulator": "dev-master"
},


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


http://
craftitonline.com
END

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

Recommended

Recommended

More Related Content

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

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

Recently uploaded

Recently uploaded (20)

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