ijvo / testbench
Simple integration testing tool for Nette Framework applications
Requires
- php: >=7.3
- ijvo/kdyby-fake-session: ^3.1
- nette/application: ^3.0
- nette/bootstrap: ^3.0
- nette/di: ^3.0
- nette/http: ^3.0
- nette/safe-stream: ^2.3
- nette/security: ^3.0
- nette/tester: ^2.2
- nette/utils: ^3.0 || ^4.0
Requires (Dev)
- ijvo/kdyby-doctrine: dev-master
- ijvo/nettrine-migrations: ^0.7
- kdyby/console: dev-master
- kdyby/doctrine-cache: ^3.0
- kdyby/doctrine-dbal-batchimport: dev-master
- kdyby/events: dev-master
- latte/latte: ^2.5 || ^3.0
- nette/database: ^3.0
- nette/forms: ^3.0
- nette/robot-loader: ^3.0
- nextras/dbal: ~3.0
- tracy/tracy: ^2.7
- v3.1.4
- v3.1.3
- v3.1.2
- dev-master / 3.1.1.x-dev
- v3.1.1
- v3.1.0
- v3.0.4
- v3.0.3
- v3.0.2
- v3.0.1
- v3.0.0
- v2.4.4
- v2.4.3
- v2.4.2.2
- v2.4.2.1
- v2.4.2
- v2.4.1
- v2.4
- v2.3.1
- v2.3
- v2.2.1
- v2.2
- v2.1.6
- v2.1.5
- v2.1.4
- v2.1.3
- v2.1.2
- v2.1.1
- v2.1
- v2.0.4
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0
- v2.0-rc.2
- v2.0-rc.1
- 1.2.1
- 1.2
- 1.1.1
- 1.1
- 1.0
- dev-ChPSR4
This package is auto-updated.
Last update: 2024-10-23 01:22:11 UTC
README
Testbench
Forked from https://github.com/mrtnzlml-archive/testbench
Update for Nette 3.0
Tested against PHP 7.4.
Please read this wiki.
Heavily inspired by these GitHub projects:
- Kdyby/TesterExtras, Librette tests, Nette tests and damejidlo/modular-testcase
And article(s):
- Bootstrap your integration testing database (Jiří Pudil)
- Testování presenterů v Nette (me)
Simple test bench for Nette Framework projects
Write integration tests as simple as possible. This project helps you to write tests very quickly. DRY! The main goal of this project is to make testing very simple for everyone and help with the difficult start.
You can find few examples in this readme or take a look to the tests
folder in this project.
Installation
$ composer require ijvo/testbench
Testbench itself doesn't need database. But if you want to use Testbench\TDoctrine
or Testbench\TNetteDatabase
trait you have to setup database for the first connection. You should use standard database configuration - nothing special. You can see example in tests/tests.local.neon.dist
file. Empty database is good enough for Testbench. Supported databases are:
- Doctrine 2
- Nette\Database
For another databases please send PR or open issue.
Minimal code
At first you need classic bootstrap file (just example, DIY):
<?php require __DIR__ . '/../vendor/autoload.php'; Testbench\Bootstrap::setup(__DIR__ . '/_temp', function (\Nette\Configurator $configurator) { $configurator->createRobotLoader()->addDirectory([ __DIR__ . '/../app', ])->register(); $configurator->addParameters([ 'appDir' => __DIR__ . '/../app', ]); $configurator->addConfig(__DIR__ . '/../app/config/config.neon'); $configurator->addConfig(__DIR__ . '/tests.neon'); });
It's important, that we are not creating dependency injection container here. You can use autoload from composer if you don't want to use robot loader.
You should also create config file e.g. tests.neon
. This file is needed only for database tests at this moment. In this file you should configure your project before tests:
testbench: sqls: #what should be loaded after empty database creation - %appDir%/../sqls/1.sql - %appDir%/../sqls/2.sql
And you are ready to go:
<?php //HomepagePresenterTest.phpt require __DIR__ . '/../bootstrap.php'; /** * @testCase */ class HomepagePresenterTest extends \Tester\TestCase { use \Testbench\TPresenter; public function testRenderDefault() { $this->checkAction('Homepage:default'); } public function testRenderDefaultModule() { $this->checkAction('Module:Homepage:default'); } } (new HomepagePresenterTest())->run();
You can easily write cover with tests UI\Controls, restricted areas, forms, signals, redirects, ...
Please read this article.
Give it a shot!
Look at the tests in this project. You'll see how to use it properly. There are examples in tests
folder or in the wiki. Learn how to use these traits: