README

Dies ist die CAG Tests erlaubt euch Standard Unit-, Acceptance- und Functional- Tests für Typo3 Installationen durchzuführen. cag_tests eingebettet sein.

Die Features

folgende Tests werden von der Extension durchgeführt

Tests stammen aus der dev Version des typo3 core
Erweiterung der Tests für Eigene Extensions

git clone git@bitbucket.org:web-tp3/cag_tests.git
cd cag_tests/
rm -rf .git .gitignore
composer install
git init

2 Resources

Resources/Core => Core Tests

Resources/Ext => Extension Tests + Vorlagen für eigene Acceptance Tests (BackendLoginPrototype.php)

Einbinden der cag_tests Extension

erfordert folgende Pakete im composer.json und ggf. auch seitens des Servers installiert und aktiviert

"require": { 

 		"typo3/cms": "dev-TYPO3_8-7",
 		"helhum/typo3-console": "^5",
 		"helhum/dotenv-connector": "^2",
 		"helhum/config-loader": "*",
 		"georgringer/news":"*"
 
}
 	
"require-dev": {
 		"devlog/devlog": "dev-master",
 		"deployer/deployer": "^6",
 		"consolidation/robo": "^1",
 		"phpunit/phpunit": "*",
 		"codeception/codeception":"*",
 		"typo3/testing-framework": "8.x-dev",
 		"friendsofphp/php-cs-fixer": "^2.13@dev",
 		"se/selenium-server-standalone":"~2.53",
 		"typo3/cms-styleguide" :"~8.0.8",
 		"ext-soap": "*",
 		"phpunit/php-invoker":"^1.1",
 		"nimut/testing-framework": "^3.0@dev"
}

Vorgesehen sind die Tests auf einer Entwicklungsumgebung -> require-dev web-tp3/cag_tests

Tests-Erweiterung herunterladen.

Setup https://getcomposer.org/ should be available on the system already, see its documentation for installation details. For functional tests, a database connection and credentials should be at hand.

Enthaltene Funktionalitäten

cag_tests Framework Wrapper

1000 Unit Tests
50 Functional Tests
25 Acceptance Tests

mit 2 gundlegenden Funktionalitäten Resources/Core & Resources/Ext Tests. Start configs sind jeweils im Ordner Build zu finden, wie weiteres wie z.B. FunctionalHelhumTests.xml Sowie vorkonfigurierte standardisierte Parameter "Fixtures".

Weitere Tests wie

PHPUnit Testing

TYPO3 >=8.7

 php bin/phpunit --configuration web/typo3conf/ext/cag_tests/Resources/Core/Build/UnitTests.xml --log-junit UnitExtTests.log

for Deprecated Units

 php bin/phpunit --configuration web/typo3conf/ext/cag_tests/Resources/Core/Build/UnitTestsDeprecated.xml --log-junit DeprecatedTests.log

Functional Testing

(phpunit & testing-framework)

Difference between unit and functional tests

Since TYPO3 6.2, additionally to unit tests, you can also write functional tests for TYPO3.

Unit tests should test only one small piece of code, and should not modify the environment (files, database). However with functional tests you can test the complete functionality.

With TYPO3 CMS version 6.2 the functional test execution and its required setup was streamlined. See Blueprints/StandaloneUnitTests for more details.

https://wiki.typo3.org/Functional_testing

shell script:

Execute all functional tests

TYPO3 >=8.7

 php bin/phpunit --configuration ../web/typo3conf/ext/cag_tests/Resources/Core/Build/FunctionalTests.xml --log-junit FunctionalTests.log
 php bin/phpunit --configuration ../web/typo3conf/ext/cag_tests/Resources/Ext/Build/FunctionalTests.xml --log-junit FunctionalExtTests.log

Acceptance Testing

(codeception & chromedriver)

https://docs.typo3.org/typo3cms/CoreApiReference/Testing/Index.html

Acceptance Testing since TYPO3 v8

Since the very early version of TYPO3 v8, the core ships with Acceptance tests based on Codeception, which are executed with chromedriver as headless Chrome browser.

As Fetch the TYPO3 sources and installed composer dependencies and start the chromedriver and the PHP HTTP server:

mkdir -p web/typo3temp/var/tests 
./bin/chromedriver --url-base=/wd/hub > /dev/null 2>&1 &
php -S 0.0.0.0:8000 >/devclass_name: AcceptanceTester /null 2>&1 &
sleep 3;

typo3DatabaseName='c1_cag_tests' typo3DatabaseHost='localhost' typo3DatabaseUsername='username' typo3DatabasePassword='pw' \
 bin/codecept run Acceptance -c web/typo3conf/ext/cag_tests/Resources/Core/Build/AcceptanceTests.yml

oder mit z.B. PHPStorm natürlich. Man kann Codeception zusammen mit Chrome/Firefow auch für eine kleine Vorführung nutzen, indem man chrome nicht headdless, sondern geöffnet starten lässt. Das kann auch zur Fehlersuche hilfreich sein... (config in Acceptance.suite.yml)

don't use Windows - works but... :-|

Einfach den Ordner aus EXT:cag_tests/Resources/Private/Ext kopieren als euren eigenen Tests Ordner anlegen. Die Fixtures & Pfade in den xml Test Config Dateien auf eure Struktur anpassen... Danach können die Tests beginnen

Weiteres wie Beispiele für Tests in eigenen Extensions sind im cag_wurmloch versteckt :-)

order unter https://bitbucket.org/web-tp3/cag_tests/wiki/Home

web-tp3 / cag_tests

Maintainers

Details