Skip to content

Commit

Permalink
Merge pull request #2 from Lakion/readme
Browse files Browse the repository at this point in the history
Created readme
  • Loading branch information
pamil committed Sep 11, 2015
2 parents 792926b + e62076a commit 47b20c7
Showing 1 changed file with 56 additions and 1 deletion.
57 changes: 56 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,56 @@
@TODO :)
MinkDebugExtension
==================

[![License](https://img.shields.io/packagist/l/lakion/mink-debug-extension.svg)](https://packagist.org/packages/lakion/mink-debug-extension)
[![Version](https://img.shields.io/packagist/v/lakion/mink-debug-extension.svg)](https://packagist.org/packages/lakion/mink-debug-extension)
[![Total Downloads](https://img.shields.io/packagist/dt/lakion/mink-debug-extension.svg)](https://packagist.org/packages/lakion/mink-debug-extension)
[![Build status...](https://img.shields.io/travis/Lakion/MinkDebugExtension/master.svg)](http://travis-ci.org/Lakion/MinkDebugExtension)
[![Scrutinizer Quality Score](https://img.shields.io/scrutinizer/g/Lakion/MinkDebugExtension.svg)](https://scrutinizer-ci.com/g/Lakion/MinkDebugExtension/)

**MinkDebugExtension** is a Behat extension made for debugging and logging Mink related data after every failed step.
It is especially useful while running tests on continuous integration server like Travis.
While using Selenium2 driver, you can also save screenshots just after the failure.

Installation
------------

Assuming you already have Composer:

```bash
composer require lakion/mink-debug-extension
```

Then you only need to configure you Behat profile:

```yml
default:
extensions:
Lakion\Behat\MinkDebugExtension:
directory: directory-where-to-save-logs
```
Configuration reference
-----------------------
Under `Lakion\Behat\MinkDebugExtension` there are three options to be configured:

- `directory` (required to enable extension) - contains path to directory that will contain generated logs, it can be relative to directory where your `behat.yml` is
- `screenshot` (default `false`) - whether to save screenshots if using `Selenium2Driver`
- `clean_start` (default `true`) - whether to clean your existing logs on each Behat execution

Testing
-------

In order to test the extensions run:

```bash
composer install
bin/phpspec run
bin/behat --strict
```

Authors
-------

MinkDebugExtension was originally created by [Kamil Kokot](http://kamil.kokot.me).
See the list of [contributors](https://github.com/Lakion/MinkDebugExtension/contributors).

0 comments on commit 47b20c7

Please sign in to comment.