krajcik/nette-tester-extension

Extension library for nette tester.

v1.0.3 2023-05-08 10:59 UTC

Requires

• php: >=7.1
• nette/nette: >= 2.3.0
• nette/tester: >=1.5.6
• nette/utils: >= 2.4.0

BSD-3-Clause, GPL-2.0, GPL-3.0

README

Easy testing of presenters

Library contains class BasePresenterTester which provide following methods:

• checkRequestNoError - expect that some action of presenter is without error
• checkRequestError - expect that some action of presenter throw error
• checkRedirectTo - expect that some action of presenter return redirect

Authenticator

In default ever request are sent as from unlogged user. If we want test behavior of action when is some user logged in, we can use parameters "$userId" etc. which provide all check* methods. We do not need to know password of user. Simply say that we want be logged in as user with id "$userId".

Default role of logged user is 'admin'. For change role use parameter "$userRole"

Example in practice

!!! Important recomended: Before start tests clear cache !!!

For each presenter to test must be created separated class

<?php

require __DIR__ . '/../../../../vendor/autoload.php';
require __DIR__ . '/../../../../vendor/helbrary/nette-tester-extension/src/BasePresenterTester.php';

final class TestAccountPresenter extends \Helbrary\NetteTesterExtension\BasePresenterTester
{

	/**
	 * @var \Model\UserModel
	 */
	private $userModel;

	/**
	 * @var bool|\Model\User
	 */
	private $testingUser;

	/**
	 * TestGoodsPresenter constructor.
	 */
	public function __construct()
	{
		parent::__construct('Front:Account'); // Here is defined presenter which we want test
		$this->userModel = $this->container->getByType('\Model\UserModel');
		$this->testingUser = $this->userModel->find()->fetch(); // get some user from db
	}

	/**
	 * Test detail action of account presenter
	 */
	public function testDetail()
	{
		// if no user is logged in, expected redirect to Sign in
		$this->checkRedirectTo(array(
			'action' => 'detail',
			'id' => 8, // parameter id for action detail
		), 'Front:Sign:in');

		// if some user is logged in, expected that action detail will be render without error
		// after send this request is logged in user with id $this->testingUser->id
		$this->checkRequestNoError(array(
			'action' => 'detail',
		), 'GET', $this->testingUser->id);
	}
}

$testCase = new TestAccountPresenter();
$testCase->run();

Multiple presenter tester in one test

<?php

require __DIR__ . '/../../vendor/autoload.php';
require __DIR__ . '/../../vendor/helbrary/nette-tester-extension/src/BasePresenterTester.php';

final class TestPresenterActions extends \Helbrary\NetteTesterExtension\BaseMultiPresenterTester
{

    /**
     * TestGoodsPresenter constructor.
     */
    public function __construct()
    {
        parent::__construct();
    }

    public function testActions()
    {
        $actions = [
            'Core:Customers' => [
                'actions' => [
                    [
                        'parameters' => ['action' => 'default'], // optional - default is empty array
                        'method' => 'GET', // optional - default is GET
                        'userId' => NULL, // optional - default is NULL
                        'userRole' => NULL, // optional - default is NULL
                        'identityData' => NULL, // optional - default is NULL
                    ],
                    [
                        'parameters' => ['id' => 1, 'action' => 'default'],
                    ],

                ]
            ]
        ];

        $this->checkWithoutErrors($actions);
    }
}

$testCase = new TestPresenterActions();
$testCase->run();