Grunt plugin for running TYPO3 UnitTests with the phpunit-extension.
CoffeeScript
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src/tasks Release version 1.0 Feb 26, 2015
tasks Release version 1.0 Feb 26, 2015
README.md Release version 1.0 Feb 26, 2015
package.json Release version 1.0 Feb 26, 2015

README.md

grunt-typo3-phpunit

Grunt plugin to run PHPUnit inside of TYPO3 CMS.

This plugin is developed for Grunt 0.4.0 and is not tested for backward compatibility with Grunt 0.3.x.

Getting Started

  1. Install this grunt plugin with the follwing command:
npm install grunt-typo3-phpunit --save-dev
  1. Install phpunit in your TYPO3 installation:
cd $TYPO3_SRC && composer install
  1. Add this to your project's Gruntfile.js:
grunt.loadNpmTasks('grunt-typo3-phpunit');

TYPO3 PHPUnit task

Run this task with the grunt typo3-phpunit command.

This task is a multi task so any targets, files and options should be specified according to the multi task documentation.

Usage Example

'typo3-phpunit: {
  application: {
	  target: 'typo3conf/ext/news'
	}
	options: {
	  dd: {
		  'log-junit': '/tmp/result.xml'
		}
	}
}

Target Properties

target

Type: String

The full path to the Extension to test.

Options

environment

Type: String Default: ''

Any prefix to the command, e.g. environment-variables.

cliDispatch

Type: String Default: 'typo3/cli_dispatch.phpsh'

The path to the TYPO3 CLI Dispatcher.

cwd

Type: String Default: null

Change the working directory when executing the command. Use this if your Gruntfile is not in your TYPO3 root.

phpunitExtension

Type: String Default: phpunit

Only change this if you use a fork of phpunit or similar.

d

Type: Object Default: { "c": "typo3/sysext/core/Build/UnitTests.xml" }

Configure single-dash commandline-arguments such as -v by adding key-value pairs: 'v':''.

dd

Type: Object Default: {}

Configure double-dash commandline-arguments such as --log-junit by adding key-value pairs: 'log-junit':'<file>'

ignoreExitCode

Type: Number Default: 99

If PHPUnit doesn't find tests in an extension, it fails but with exit code 99 instead of 1, so you can ignore those errors for your CI-environment.

maxBuffer

Type: Number Default: 200*1024

Override the maxBuffer-Size of nodejs's exec() function if you expect a long output on stdout.