This is a simple refactoring exercise that is meant to teach something about dependency inversion and dependency injection.
This is the initial code for this kata written in PHP.
The documentation: http://matteo.vaccari.name/blog/archives/154
In order to use this Kata boilerplate you need to have installed Docker and Docker Compose.
To get started you should create a new project throught composer, based on this repository on packagist
git clone [email protected]:trainings/birthday-greetings-kata.git
cd birthday-greetings-kata
To check that all the tests are passing just execute PHPUnit
docker-compose up -d
php bin/phpunit
Now open your favourite IDE/text editor and start hacking.
I've been coding/playing this Kata in order to focus to implement some concepts about Hexagonal Architecture.
Following some resources:
- The birthday greetings kata instructions by Matteo Vaccari
- Advanced Web Application Architecture book by Matthias Noback
I've tried to apply a project split in layers: Domain, Application & Infrastructure:
src
├── Application
│ └── SendBirthdayGreeting
│ ├── SendBirthdayGreetingMessenger.php
│ ├── SendBirthdayGreeting.php
│ └── SendBirthdayGreetingService.php
├── app.php
├── Domain
│ └── Model
│ ├── Employee.php
│ ├── EmployeeRepository.php
│ └── XDate.php
└── Infrastructure
├── Notification
│ ├── CallbackSendBirthdayGreetingMessenger.php
│ └── SwiftMailerSendBirthdayGreetingMessenger.php
└── Persistence
├── Csv
│ └── CsvEmployeeRepository.php
└── InMemory
└── InMemoryEmployeeRepository.php
The core of Acceptance test haven't been modified, only the usage of SendBirthdayGreetingService.
For the acceptance test, I've used as Fake mailer system a Callback mailer system. For the testing of persistence or to read the "Employees" I've used a In Memory repository.
Run
composer exec app.php
The application send emails to greeting the birthday employees who are its birthday. You could see the emails sent here.