Testing TYPO3 Flow Applications with Behat

Flow Applikationen
mit Behat testen
Markus Goldbeck
Senior Developer typovision GmbH

(c) 2013 - typovision GmbH | TYPO3 Flow Applikation mit Behat testen| Markus Goldbeck | www.typovision.de
TYPO3 Flow Applikation testen mit Behat
2
Markus Goldbeck
• Senior Developer bei der typovision GmbH
• TYPO3 Neos Member
• @MarkusGoldbeck

(c) 2013 - typovision GmbH | Thema der Präsentation | Autor | www.typovision.de 3
Was ist Behat?

A php framework for testing
your business expectations.
http://behat.org/

Aber wir haben doch
Unit und Functional Tests !

6
Unit Tests
Unit Tests
• testet funktionale Einzelteile
• sind die inneren und detailliertesten Komponenten der Software
• testet die Module isoliert
• für Modultests müssen externe Komponenten wie
Datenbankverbindungen aufwendig durch Mock-Objekte simuliert
werden

7
Functional Tests
Functional Tests
• sind eine Form von Integrationstest
• soll die einzelnen Komponenten zusammen testen
• auch hier muss für das testen mit externen Komponenten wie
Datenbankverbindungen diese aufwendig durch Mock-Objekte
simuliert werden

Und wofür brauch ich jetzt
noch Behat bzw. BDD ?

9
Behavior Driven Development
• Es werden während der Anforderungsanalyse die
• Aufgaben
• Ziele und
• Ergebnisse textuell festgehalten
• Anforderungen in „Wenn-Dann“- Sätze
• basierend auf ubiquitären Sprache des Domain-Driven Designs
=> einfacher Übergang zwischen fachlicher Anforderung und
Programmiersprache

10
Vorteile
• leichte Lesbarkeit durch „sprechende“ Tests
• Test von „außen“
• könnte vom Stakeholder selber geschrieben werden
• kann von jedem geschrieben werden, der die Business Logik kennt
• durch die Abstraktion der Tests kann sich die Implementierung ändern,
die Funktion bzw. der Test kann aber immer noch funktionieren
=> als Erweiterung für Unit und Functional Tests, um die Business Logik zu
testen

Einbindung von Behat in
TYPO3 Flow Applikationen

12
Einbindung
Flowpack.Behat
• fertiges Flow Package von Christopher Hlubek networkteam GmbH
• https://github.com/Flowpack/Flowpack.Behat
• Einbindung über Composer oder direkt clonen Packages/Application
{
"name": "typo3/neos-base-distribution",
"description" : "TYPO3 Neos Base Distribution",
"license": "GPL-3.0+",
"conﬁg": {
"vendor-dir": "Packages/Libraries",
"bin-dir": "bin"
},
"require": {
"typo3/neos": "dev-master",
"typo3/neosdemotypo3org": "dev-master",
"typo3/sitekickstarter": "dev-master"
},
"require-dev": {
"typo3/buildessentials": "dev-master",
"mikey179/vfsstream": "1.1.*",
"ﬂowpack/behat": "dev-master"
},
"minimum-stability": "dev",
"scripts": {
"post-update-cmd": "TYPO3FlowComposerInstallerScripts::postUpdateAndInstall",
"post-install-cmd": "TYPO3FlowComposerInstallerScripts::postUpdateAndInstall"
}
}

13
Einbindung
Flow Build path
• https://review.typo3.org/#/c/20756/3
• anlegen des Ordners „Behat“ in „Build“
• Einbindung composer.json
• cd Build/Behat
• composer install --dev
{

"require": {

"behat/behat": "2.4.*",

"behat/mink-extension": "1.0.*",

"behat/mink-goutte-driver": "*",
"behat/mink-selenium2-driver": "*"

},

"conﬁg": {

"bin-dir": "../../bin/"

}
}

14
Einbindung
Konﬁguration
• Behat braucht zwei spezielle Flow Kontexts
• „Development/Behat/Settings.yaml“
• wichtig: Angabe eigener Datenbank
• wichtig: Angabe des „drivers“
TYPO3:
Flow:
persistence:
# It is good practice to not specify user name and password of the database
# connection in this global Settings.yaml ﬁle. Rather specify them in the
# settings of the respective context (Production / Development ...).
backendOptions:
host: '127.0.0.1' # adjust to your database host
dbname: 'neosdev_behat' # adjust to your database name
user: 'root' # adjust to your database user
password: 'root' # adjust to your database password
driver: pdo_mysql

15
Einbindung
Konﬁguration
• Behat braucht zwei spezielle Flow Kontexts
• „Testing/Behat/Settings.yaml“
• wichtig: Angabe eigener Datenbank
• wichtig: Angabe des „drivers“
TYPO3:
Flow:
persistence:
# It is good practice to not specify user name and password of the database
# connection in this global Settings.yaml ﬁle. Rather specify them in the
# settings of the respective context (Production / Development ...).
backendOptions:
host: '127.0.0.1' # adjust to your database host
dbname: 'neosdev_behat' # adjust to your database name
user: 'root' # adjust to your database user
password: 'root' # adjust to your database password
driver: pdo_mysql

16
Einbindung
Konﬁguration vhost
• Behat Konﬁguration auf die gleiche Flow Installation
• setzen von „SetEnv FLOW_CONTEXT Development/Behat“ Kontext
<VirtualHost *:80>
DocumentRoot "/Applications/MAMP/htdocs/NeosDev/Web/"
ServerName neos.dev
ServerAlias neos.dev
SetEnv FLOW_CONTEXT Development
</VirtualHost>
<VirtualHost *:80>
DocumentRoot "/Applications/MAMP/htdocs/NeosDev/Web/"
ServerName neos.dev.behat
ServerAlias neos.dev.behat
SetEnv FLOW_CONTEXT Development/Behat
</VirtualHost>

17
Einbindung
Anlegen der Features
• anlegen von Behavior/Features/Botstrap/FeatureContext.php
• Kopie von behat.yml.dist anlegen und base_url analog zu vhost setzen

18
Einbindung
Anlegen der Features
• anlegen von Behavior/Features/Botstrap/FeatureContext.php
• Kopie von behat.yml.dist anlegen und base_url analog zu vhost setzen
require_once(__DIR__ . '/../../../../../Flowpack.Behat/Tests/Behat/FlowContext.php');
/**
* Features context
*/
class FeatureContext extends MinkContext {
}

19
Selenium
Testen von JavaScript
• im Beha
• @javascript neben @ﬁxtures
• Download Selenium Server
• java -jar selenium-server-standalone-2.32.0.jar

Wie sieht so ein Behat Test
aus ?

21
Thema des Slides
Feature
Feature: ls
In order to see the directory structure
As a UNIX user
I need to be able to list the current directory's contents
Scenario:
Given I am in a directory "test"
And I have a file named "foo"
And I have a file named "bar"
When I run "ls"
Then I should get:
"""
bar
foo
"""

Gherkin - Gürkchen ?

23
Aufbau
Unterteilung der Tests
• Gherkin als Beschreibungssprache
• features
• Background
• scenarios
• Given
• When
• Then
• But

24
Aufruf der Tests
Aufruf der Features aus dem Flow root path
• alle features
bin/behat -v -c Packages/Application/TYPO3.Neos/Tests/Behavior/
behat.yml
• einzelne features
behat.yml Packages/Application/TYPO3.Neos/Tests/Behavior/features/
ContentModule/PreviewMode.feature
• einzelne scenarios
behat.yml Packages/Application/TYPO3.Neos/Tests/Behavior/features/
ContentModule/PageTree.feature:26

So und jetzt bitte Beispiele

26
Behat Tests in TYPO3 Neos
Behat Tests sind bereits in TYPO3 Neos integriert
• steht am Anfang
• Ziel Backend stabiler machen und erhalten
• Beispiele /Packages/Application/TYPO3.Neos/Tests/Behavior

27
Quellen
Quellen
• http://behat.org/
• https://de.wikipedia.org/wiki/Modultest
• http://de.wikipedia.org/wiki/Funktionstest
• https://github.com/Flowpack/Flowpack.Behat
• TYPO3.Neos/Documentation/DeveloperGuide/Testing/Behat
• https://speakerdeck.com/everzet/behat-by-example

Vielen Dank für Eure
Aufmerksamkeit

Testing TYPO3 Flow Applications with Behat

Weitere ähnliche Inhalte

Was ist angesagt?

Andere mochten auch

Testing TYPO3 Flow Applications with Behat