Merge pull request #77 from bem/release/0.9.0

Prepare v0.9.0 release

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.9.0 - 2014-10-22
+
+* Replace `GraphicsMagick` with lightweight `png-img` library (@j0tunn).
+  As for this version, `gemini` no longer requires any external tool for
+  image processing.
+* CSS coverage now supports source maps (@scf2k).
+  If your CSS has the sourcemap, coverage report will show original files.
+
+  You can use `sourceRoot` option to tell `gemini` where are your sources
+  located on a filesystem.
+* CSS coverages statistics will now also be written to `coverage.json`
+  file (@scf2k).
+* Add `coverageExclude` option to allow exclude certain files from coverage
+  report (@scf2k).
+* Add index page to coverage report and improve appearance of a the coverage
+  pages (@scf2k).
+* Restructure documentation and add quick start guide in russian and english
+  (@jk708).
+
 ## 0.8.2 - 2014-10-06
 
 * Reset cursor position before reloading the page.

doc/commands.ru.md

@@ -67,4 +67,4 @@ gemini test --reporter flat --reporter html [пути к файлам с тес
 
 ## Автодополнение команд
 
-Чтобы настроить автодополнение команд по нажатию клавиши Tab, добавьте строку `. <(gemini completion)` в файл конфигурации командной строки (к примеру, файл `~/.bashrc` для `bash` или файл `~/.zshrc` для `zsh`).
+Чтобы настроить автодополнение команд по нажатию клавиши Tab, добавьте строку `. <(gemini completion)` в файл конфигурации командной строки (к примеру, файл `~/.bashrc` для `bash` или файл `~/.zshrc` для `zsh`).

doc/config.md

@@ -92,6 +92,18 @@ as test failure.
 * `http.timeout` - Selenium Grid request timeout, msec.
 * `http.retries` - Selenium Grid request tries count.
 * `http.retryDelay` - delay before retry of Selenium Grid request, msec.
-* `coverage` (CLI: `--coverage`, env: `GEMINI_COVERAGE`) - set to `true` to enable experimental
-  coverage reporting. Report will be saved to `gemini-coverage` directory.
-* `windowSize` (env: `GEMINI_WINDOW_SIZE`) - specify browser window dimensions (i.e. `1600x1200`).
+* `coverage` (CLI: `--coverage`, env: `GEMINI_COVERAGE`) - set to `true` to enable experimental 
+   coverage reporting. Report will be saved to `gemini-coverage` directory. If CSS on a pages under
+   tests has source map, original files will be shown in report.
+* `sourceRoot` (CLI: `--source-root`, env: `GEMINI_SOURCE_ROOT`) – directory which contains the source files.
+  Local sources will be used in coverage report when source map is available, but sources can not be downladed
+  from URL under tests. By default, it is equal to `projectRoot`.
+* `coverageExclude` – array of file paths or glob patterns to exclude from coverage report. For example:
+
+  ```yaml
+  coverageExclude:
+    - libs/**
+    - path/to/some.css
+    - 
+  ```
+* `windowSize` (env: `GEMINI_WINDOW_SIZE`) - specify browser window dimensions (i.e. `1600x1200`).

doc/config.ru.md

@@ -69,5 +69,18 @@ browsers:
 * `http.timeout` - таймаут запроса к Selenium Grid (мс).
 * `http.retries` - количество попыток отправки запроса в Selenium Grid.
 * `http.retryDelay` - пауза перед повторной отправкой запроса в Selenium Grid (мс).
-* `coverage` (CLI: `--coverage`, env: `GEMINI_COVERAGE`) - присвойте значение `true` для включения экспериментального отчёта о покрытии. Отчёт сохраняется в папку `gemini-coverage`.
-* `windowSize` (env: `GEMINI_WINDOW_SIZE`) - размеры окна браузера. Например, `1600x1200`.
+* `coverage` (CLI: `--coverage`, env: `GEMINI_COVERAGE`) - присвойте значение `true` для включения экспериментального отчёта о покрытии CSS-кода
+тестами. HTML-отчёт сохраняется в папку `gemini-coverage`. В случае, если CSS на тестируемых страницах есть source map, отчет будет составлен по
+исходным файлам.
+* `sourceRoot` (CLI: `--source-root`, env: `GEMINI_SOURCE_ROOT`) – папка, в которой располагаются исходные файлы.
+Локальные исходные файлы будут использваны для построения отчета о покрытии при использовании source map в том случае, 
+если не удастся скачать их с тестируемого URL. По умолчанию, совпадает с `projectRoot`.
+* `coverageExclude` - массив путей или glob-масок, которые следуют исключить из отчета о покрытии. Напрмер:
+
+  ```yaml
+  coverageExclude:
+    - libs/**
+    - path/to/some.css
+    - path/to/other.{css,less}
+  ```
+* `windowSize` (env: `GEMINI_WINDOW_SIZE`) - размеры окна браузера. Например, `1600x1200`.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemini",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "UI Screenshot testing utility",
   "bin": {
     "gemini": "./bin/gemini"