Download the PHP package drupsys/codeception-use-cases-module without Composer

CODECEPTION USE CASES MODULE

A codeception module for use case based tests, this module aims to promote writing of real unit tests as described in the "TDD, Where Did It All Go Wrong" talk by Ian Cooper.

Relevant references:

• TDD, Where Did It All Go Wrong
• How to write use case tests

Setup

Assuming you have tests/usecase.suite.yaml file, enable this module like this

Specifically note \MVF\Codeception\UseCases\Module added to the list of modules. This module has required config to function properly, the list of providers must be defined.

MySql Provider

This is an object that must implement MVF\Codeception\UseCases\Contracts\MySqlInterface and it should look something like this.

Redis Provider

This is an object that must implement MVF\Codeception\UseCases\Contracts\RedisInterface and it should look something like this.

Services

Your docker compose file should have the following services

\<app>-test-mysql

MySql service should have MYSQL_ROOT_PASSWORD set to 12345, have command with the following flags --server-id=1 --log-bin=test.log, if you already define some command just append these flags to your existing command, and should use [mvf_shared] network.

\<app>-binlog-parser

Maxwell service should use [mvf_shared] network as well and it should be built in build/binlog-parser folder. this folder should have Dockerfile and config.properties files.

The content of your Dockerfile is below, check maxwell and alpine versions to see if there is a newer version available.

The content of your config.properties is below.

Most of this config should be self-explanatory the only thing to elaborate is redis_key this is where maxwell will store all the bin log data, by default this key is set to maxwell but if you are already using this key in your application then you need to change the value of it.

If you change your redis_key value to testing then you must also provide additional config in your test suite. Assuming you have tests/usecase.suite.yaml then new redis_key must also be defined there like this.

\<app>-redis

Redis service should use [mvf_shared] network like the other services.

Requirements and Motivation

For this module to work you will need:

• MySql test database with binlogs enabled
• Maxwell daemon to read binlogs and push them to Redis
• Redis cache to store binlog data

There is quite a lot going on in this module, I assume you will have a lot of questions, lets start answering some of them.

Why do we need mysql test server with bin logs enabled?

Short answer is, it is needed for maxwell daemon to know what mutations have been performs on the database.

What is Maxwell daemon?

This is a process that consumes mysql binlogs converts them to simple json objects and sends them to one of the supported targets, in our case a Redis server.

Why does this module need Redis to function?

Again, short answer is, maxwell daemon uses redis as the store for binlogs. There are a number of different services where maxwell daemon can store binlogs but redis is the most suitable because we need to read the stored data in php code, and it is very easy to read data from Redis.

What is the point of it all?

The added complexity solves an issue we had with database resets. The database that we are working with takes about 40 seconds to reset after each test. Maxwell daemon allows us to know what tables were effected anc with that we can truncate only those tables that must be truncated. This improved the speed of each test around 120 times.

This also provides us a way to write purely declarative tests, at no point in you test you have to interact with a database or write logic. The process of writing tests can be summarised with these steps:

• declare initial state of the application
• run code under test
• declare assertions against the final state of the application

initial state is just an associative array that describes everything about the state of your application before code execution and final state is an associative array that describes everything about your application after code execution.