2015-11-14 21:07:10 +01:00
|
|
|
This repository will provide all you need to get you up and running with Behat
|
|
|
|
|
and mink in a basic setup.
|
|
|
|
|
|
|
|
|
|
# Install
|
|
|
|
|
|
2015-11-14 22:00:07 +01:00
|
|
|
1. [Install Composer](https://getcomposer.org/doc/00-intro.md)
|
|
|
|
|
2. Clone the repository, or download.
|
|
|
|
|
3. Run `composer install` from within the repository.
|
|
|
|
|
With `bin/behat -di` you can verify whether Behat works and the language is
|
2015-11-14 21:16:23 +01:00
|
|
|
available to write website tests.
|
2015-11-14 21:07:10 +01:00
|
|
|
|
|
|
|
|
## For non headless browser
|
|
|
|
|
|
|
|
|
|
Headless means without a GUI, just CLI. This is default for this setup. So all
|
|
|
|
|
your tests are run without a GUI of an actual browser.
|
|
|
|
|
|
|
|
|
|
To use a real browser like Firefox, you need to install selenium standalone
|
|
|
|
|
server, in addition, by downloading from http://www.seleniumhq.org/download/
|
|
|
|
|
|
|
|
|
|
# Execute
|
|
|
|
|
|
|
|
|
|
Per default you just can run your tests. Therefor execute: `bin/behat features`.
|
|
|
|
|
|
|
|
|
|
If you wanna see your tests running in real time inside the browser, or need a
|
|
|
|
|
specific feature, you need to start the selenium server before running the
|
|
|
|
|
tests.
|
|
|
|
|
Start selenium server: `java -jar bin/selenium-server-standalone-2.48.2.jar`.
|
|
|
|
|
Modify the call to match path and filename of downloaded server.
|
|
|
|
|
Uncomment the line containing `default_session` in `behat.yml`, then run your
|
|
|
|
|
tests again.
|
|
|
|
|
|
|
|
|
|
# Extending
|
|
|
|
|
|
|
|
|
|
Once the tests work you are set to start your own. Just follow the [official
|
|
|
|
|
documentation](http://behat.org) and write your own tests.
|
|
|
|
|
|
|
|
|
|
# Support
|
|
|
|
|
|
|
|
|
|
Native support is given for Firefox. This repository aims to provide basic
|
|
|
|
|
support to get you started. For full support contact us or dive deeper on your
|
|
|
|
|
own.
|
|
|
|
|
|
2015-11-14 22:00:07 +01:00
|
|
|
## Further languages
|
|
|
|
|
|
|
|
|
|
English for your tests works out of the box. But it also will provide further
|
|
|
|
|
languages, e.g. German. To verify your language exists, run `./bin/behat --lang
|
|
|
|
|
de -di`. If it exists, e.g. German in this case, you should get a list of
|
|
|
|
|
available definitions. In addition you can run `./bin/behat --story-syntax
|
|
|
|
|
--lang de` to get information how to write the stories in your language.
|
|
|
|
|
|
|
|
|
|
Note, what the last command points out, you have to add the language at the
|
|
|
|
|
beginning, with a leading `#`. E.g.: `# language: de`.
|
|
|
|
|
|
2015-11-14 21:07:10 +01:00
|
|
|
# Further resources
|
|
|
|
|
|
|
|
|
|
- http://docs.behat.org/en/v2.5/
|
|
|
|
|
- http://mink.behat.org/en/latest/index.html
|
|
|
|
|
- http://blog.lepine.pro/images/2012-03-behat-cheat-sheet-en.pdf
|
|
|
|
|
|
|
|
|
|
## For further features
|
|
|
|
|
|
|
|
|
|
- PHPStorm plugin for Behat: http://projectspace.pl/plugins/behat/screenshots/
|
|
|
|
|
- Diff Screenshots from Testsessions: https://github.com/jadu/BehatPerceptualDiffExtension
|
|
|
|
|
- Web GUI for all your features: https://github.com/Halleck45/BDDWizard
|
