Metadata-Version: 2.1
Name: miqsel
Version: 1.2
Summary: Miq Selenium Server for local testing
Home-page: https://github.com/digitronik/miqsel
Author: Nikhil Dhandre
Author-email: nik.digitronik@live.com
License: GPLv3
Keywords: miqsel
Platform: UNKNOWN
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: Click (>=5.0)
Requires-Dist: docker (>=3.1)
Requires-Dist: PyYAML (>=3.0)

# Miq Selenium Server

This is a simple script to make my life easy.
I want to run `selenium server` `locally` but don't want to use full `wharf`.
I want to check running container `ip's` and `ports` also point them in `env.ymal`.
I want to select `browser` with a single command.

Simple command line application to spin `selenium docker container` and provide `vnc` access.


## Prerequisite:
1. **Docker**:

    For setting `docker` environment follow below steps:

    - [Fedora](https://developer.fedoraproject.org/tools/docker/docker-installation.html)

        * Set Repository:
        ```
        sudo dnf -y install dnf-plugins-core
        sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
        ```

        * Install below packages:

        ```
        sudo dnf -y install docker-ce
        sudo systemctl start docker
        sudo systemctl enable docker
        ```

        * Run docker with non-root User:
        ```
        sudo usermod -aG docker <non-root-user>
        ```

    - [Ubuntu](https://docs.docker.com/install/linux/docker-ce/ubuntu/) and [others](https://docs.docker.com/install/)

2. **TigerVNC Versions(based on various Distro's)**:
    - Fedora:
        ```
        sudo dnf install tigervnc
        ```
    - [TigerVNC link for other Distro's](http://tigervnc.bphinz.com/nightly/)



## Installation:
```bash
pip install miqsel --user
```
or
```bash
 pip install git+https://github.com/digitronik/miqsel#egg=miqsel --user
```

## Usage:
```
Usage: miqsel [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  browser   Set Browser
  config    Configure Miq Selenium webdriver
  hostname  Miq Selenium Server Hostname
  start     Start Miq Selenium Server
  status    Status of Miq Selenium Server
  stop      Stop Miq Selenium Server
  urls      VNC and Command Executor URL's
  viewer    VNC viewer
```
- **Note**: If the project directory `not set` then you need to run commands from `integration_tests` directory. 

* set-project-directory:
    ```
    cd `<path>/integration_tests`
    miqsel config
    # follow options
    ```

