diff --git a/CHANGELOG.md b/CHANGELOG.md index d161ad64e..d87732630 100644 --- a/CHANGELOG.md +++ b/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. diff --git a/doc/commands.ru.md b/doc/commands.ru.md index c7f9e9323..badba2d36 100644 --- a/doc/commands.ru.md +++ b/doc/commands.ru.md @@ -67,4 +67,4 @@ gemini test --reporter flat --reporter html [пути к файлам с тес ## Автодополнение команд -Чтобы настроить автодополнение команд по нажатию клавиши Tab, добавьте строку `. <(gemini completion)` в файл конфигурации командной строки (к примеру, файл `~/.bashrc` для `bash` или файл `~/.zshrc` для `zsh`). \ No newline at end of file +Чтобы настроить автодополнение команд по нажатию клавиши Tab, добавьте строку `. <(gemini completion)` в файл конфигурации командной строки (к примеру, файл `~/.bashrc` для `bash` или файл `~/.zshrc` для `zsh`). diff --git a/doc/config.md b/doc/config.md index c24248ece..81f5a1490 100644 --- a/doc/config.md +++ b/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`). \ No newline at end of file +* `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`). diff --git a/doc/config.ru.md b/doc/config.ru.md index c7220fae6..7bb01d0ca 100644 --- a/doc/config.ru.md +++ b/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`. \ No newline at end of file +* `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`. diff --git a/package.json b/package.json index 3b0cb1efa..9b184603a 100644 --- a/package.json +++ b/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"