An open API service indexing awesome lists of open source software.

https://github.com/gemini-testing/gemini-gui

GUI for gemini
https://github.com/gemini-testing/gemini-gui

gemini gemini-gui testing-tools

Last synced: about 2 months ago
JSON representation

GUI for gemini

Awesome Lists containing this project

README

        

# Gemini GUI

[![Build Status](https://travis-ci.org/gemini-testing/gemini-gui.svg)](https://travis-ci.org/gemini-testing/gemini-gui)

## WARNING

This package is deprecated and no longer supported.
Use [html-reporter](https://github.com/gemini-testing/html-reporter) plugin and `gemini gui` command instead.

### How to migrate

To be able to use `GUI` on a project you must have [gemini](https://github.com/gemini-testing/gemini) installed locally in the project.

1. Install [html-reporter](https://github.com/gemini-testing/html-reporter) plugin.

2. [Add html-reporter plugin](https://github.com/gemini-testing/html-reporter#gemini-usage) to your gemini config file.

3. Now you can use `GUI` by running `gemini gui` in the project root:

```
./node_modules/.bin/gemini gui
```

4. To see available options of `gemini gui` command, run in the project root:

```
./node_modules/.bin/gemini gui --help
```

## What is Gemini GUI?

GUI for [gemini](https://github.com/gemini-testing/gemini) utility.

![screenshot](assets/screenshot.png "Screenshot")

## Installation

Install globally with `npm`:

```
npm i -g gemini-gui
```

## Running

To be able to use `GUI` on a project you must have `gemini` installed
locally in this project. `GUI` will not work with `gemini` below
`2.0.0`.

Run in the project root:

`gemini-gui ./path/to/your/tests`

Web browser with `GUI` loaded will be opened automatically.

## Options

* `--config`, `-c` - specify config file to use.
* `--port`, `-p` - specify port to run `GUI` backend on.
* `--hostname` - specify hostname to run `GUI` backend on.
* `--root-url`, `-r` - use specified URL, instead of `rootUrl` setting from config file.
* `--grid-url` - use specified URL, instead of `gridUrl` setting from config file.
* `--screenshots-dir`, `-s` - use specified directory, instead of `screenshotsDir` setting
from config.
* `--grep`, `-g` - find suites by name. Note that if some suite files specified search will be done
only in that files.
* `--debug` - enable debug mode (verbose logging).
* `--auto-run`, `-a` - run gemini immediately (without pressing `run` button).
* `--set`, `-s` - run set specified in config.
* `--no-open`, `-O` - not to open a browser window after starting the server.
* `--reuse` - filepath to gemini tests results directory OR url to tar.gz archive to reuse

You can also override config file options with environment variables. Use `gemini`
[documentation](https://github.com/gemini-testing/gemini#configuration) for details.