Game of Tests laravel

This package aims to enable a quick implementation of a Game of Tests in Laravel. Is uses the package swisnl/game-of-tests and gives you a set of commands and basic templates to make your own Game of Tests.

This package serves as a way to search through git repositories and find PHP tests. I was inspired by the the Spotify testing game I ran in to.

The reason i wanted to my own implementation for PHP was to help gamify testing in the company and encourage testing in general in the teams.

• How does it work?
• Demo
• Author
• Installation
• Available routes
• Commands
  • got:inspect-directory
  • got:inspect-github
  • got:inspect
  • got:normalize-names
• Configuration
  • normalize-names
  • route-prefix
  • excluded-remotes
  • excluded-filenames
  • excluded-authors

How does it work?

The Game of Tests works by scanning Git repositories and scanning for known test files. It uses Git blame to attribute tests to developers. You can update through multiple artisan commands for Github, bare directories, or single repositories.

For now it supports PhpUnit, Codeception and Behat for PHP and Ava, Jasmine, Jest, Mocha, Tape and QUnit for JavaScript and True for SCSS. Feel free to contribute new parsers to swisnl/game-of-tests.

Demo

I made a demo available which uses this package and show the Game of Tests for the Laravel Github organisation at http://gameoftests.swis.nl. For in information on installing the demo locally, please check out swisnl/game-of-tests-laravel-demo.

Author

Created by Björn Brala (@bbrala).

Installation

1. Require this repository

composer require swisnl/game-of-tests-laravel

2. Add the service provider to app.php

    ...
    \Swis\GotLaravel\Providers\GameOfTestsProvider::class,
    ...

3. Publish and run the migration

php artisan vendor:publish --tag="migrations"
php artisan migrate

4. (optional) Publish the config and views

php artisan vendor:publish --tag="config"
php artisan vendor:publish --tag="views"

This published the config. See Configuration for the available options.

Available routes

Routes are based on the configuration of route-prefix. Default value is got.

Commands

You have a few commands available to update your data.

got:inspect-directory

Inspect a directory with bare resposities.

Usage:
  got:inspect-directory [options] [--] <directory>

Arguments:
  directory

Options:
      --skippast[=SKIPPAST]  Skip all before (and including) this
      --modified[=MODIFIED]  Repository modified since (uses strtotime)
      --only[=ONLY]          Skip every directory except this one
      --dry-run              Only inspect, do not insert into the database

got:inspect-github

Inspect a github organisation.

Usage:
  got:inspect-github [options] [--] <organisation>

Arguments:
  organisation

Options:
      --modified[=MODIFIED]  Repository modified since (uses strtotime)
      --dry-run              Only inspect, do not insert into the database

got:inspect

Inspect a Git url.

Usage:
  got:inspect [options] [--] <repositoryUrl>

Arguments:
  repositoryUrl

Options:
      --dry-run   Only inspect, do not insert into the database

got:normalize-names

Normalize author names based on the config setting.

Usage:
  got:normalize-names

Configuration

normalize-names

normalize-names : array

Normalize the names in the array to one single result. Sometimes people are bad with their git name. This will normalize names of committees to the array key.

Example

'Björn Brala' => ['bjorn', 'bbrala']

route-prefix

route-prefix : string

Prefix for Game of Tests routes.

Example

'route-prefix' => 'got'

excluded-remotes

excluded-remotes : array

What remote should not be included in the statistics. This is database LIKE argument.

Example

'excluded-remotes' => [
    '[email protected]:swisnl/test-%',
]

excluded-filenames

excluded-filenames : array

What filename should not be included in the statistics. This is database LIKE argument.

Example

'excluded-filenames' => [
    'tests/ExampleTest.php',
    'vendor/%',
    'tests/_%',
]

excluded-authors

excluded-authors : array

What authors should not be included in the statistics. This is database LIKE argument.

cache

cache : boolean (default true)

Enable caching for GitHub requests so rate limiting is not a problem.

Example

'excluded-authors' => [
    'Automated Commiter',
    'System'
]