dereuromark/cakephp-test-helper

TestHelper plugin for CakePHP

2.0.4 2024-03-11 17:00 UTC

This package is auto-updated.

Last update: 2024-10-30 17:40:00 UTC


README

CI Coverage Status Latest Stable Version Minimum PHP Version License Total Downloads Coding Standards

Browser based addons for your test driven development.

Note: This branch is for CakePHP 5.0+. See version map for details.

Motivation

After 2.x=>3.x, the "web-tester" has been removed. It was, for certain cases, however, quite useful. This aims to bring back a part of it.

The CLI also doesn't allow a good overview. Even with auto-complete, you have to type almost everything out. With a browser backend generating tests or running them is just a simple mouse click.

You have an overview of your classes and the test classes to it. If there is one missing, you can easily "bake" it from this web backend. It internally uses Bake plugin as well as your preferred theme.

Further useful addons

  • URL array generation from string URLs (respects routing, so it is basically also a reverse lookup)
  • Fixture validation tool (compares actual DB with the schema files: fields and attributes, constraints and indexes)
  • GUI for fixture comparison and generation of missing ones per mouse click.

Installation

You can install this plugin into your CakePHP application using composer:

composer require --dev dereuromark/cakephp-test-helper

Note: This is not meant for production, so make sure you use the --dev flag and install it as development-only tool.

Setup

Don't forget to load it under your bootstrap function in Application.php:

if (Configure::read('debug')) {
    $this->addPlugin('TestHelper');
}

This will also load the routes.

non-dev mode

In certain apps it can be useful to have some of the helper functionality available also for staging and prod. Here you must make sure then to not load the routes, though:

$this->addPlugin('TestHelper', ['routes' => Configure::read('debug')]);

And here you must use composer require without --dev flag then.

Usage

Navigate to /test-helper backend and select the app or plugin you want to check. You can then with a single click

  • check what classes do not yet have a test case
  • generate a test case for them (or copy and paste a generated code into CLI)
  • run test case
  • check coverage on a tested class, as overall and in detail

Supported class types:

  • Controllers
  • Models (Tables/Entities)
  • Components
  • Behavior
  • Helpers
  • Commands
  • Tasks
  • Cells
  • CommandHelpers
  • Forms
  • Mailers

Feel free to help out improving and completing this test helper plugin.

Limitations

Executing the tests and coverage from the web backend usually can not work for long-running tests due to the timeout issues. Make sure you raise the apache/nginx settings here if you want to use this functionality here.

The focus is on providing an overview and quickly generating the desired classes with a single mouse click.