https://github.com/digitronik/miqsel

Selenium Containerize Server
https://github.com/digitronik/miqsel

Last synced: 17 days ago
JSON representation

Selenium Containerize Server

• Host: GitHub
• URL: https://github.com/digitronik/miqsel
• Owner: digitronik
• License: other
• Created: 2018-12-25T10:02:22.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-11-20T11:31:56.000Z (12 months ago)
• Last Synced: 2024-10-07T07:07:18.247Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 108 KB
• Stars: 7
• Watchers: 2
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
 miqsel

Miq Selenium Server


















`miqsel` is a Python CLI utility leaveraging a Selenium container image to efficiently manage a

`selenium server` and provide `vnc` access.

### Prerequisite:

1. **Podman/Docker**:

    Make sure `podman` or `docker` running on your system.

    - [Podman Installation](https://podman.io/getting-started/installation.html)

    - [Docker Installation](https://docs.docker.com/engine/install/)

2. **VNC Viewer**:

    You can choose any vnc viewer but most of user used _tigervnc_.

    - 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:

- **Help**:

    ```shell

    ❯❯❯ miqsel --help

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

      Miq Selenium Server

    Options:

      --version  Show the version and exit.

      --help     Show this message and exit.

    Commands:

      config    Set Configuration

      executor  Selenium executor URL

      start     Start Selenium Server

      status    Status of Selenium Server

      stop      Stop Selenium Server

      viewer    VNC viewer

      vnc       VNC URL

    ```

- **Status**:

Check status of selenium container (running/ stopped).

    ```shell

    ❯❯❯ miqsel status

    stopped

    ```

- **Start/Stop**:

    ```shell

    ❯❯❯ miqsel start

    Selenium Server started

    TigerVNC Viewer 64-bit v1.9.0

    ❯❯❯ miqsel stop

    Sun Apr 28 12:29:02 2019

     CConn:       End of stream

    Selenium Server stopped

    ```

    Note: `start` default invoke `vnc-viewer`. You can stop it like `miqsel start --no-viewer`

- **Viewer**:

Take `vnc` access of selenium server. At the start of selenium server, vnc viewer will be `invoked` automatically.

If the `status` is `running` and the `viewer` is `close` then viewer command will help to re-open vnc session.

    ```shell

    ❯❯❯ miqsel status

    running

    ❯❯❯ miqsel viewer

    TigerVNC Viewer 64-bit v1.9.0

    ```

- **Executor**:

Get command executor url

    ```shell

    ❯❯❯ miqsel executor

    http://172.17.0.2:4444/wd/hub

    ```

- **VNC**:

Get vnc session url

    ```shell

    ❯❯❯ miqsel vnc

    172.17.0.2:5999

    ```

- **Configuration**:

    Manage your miqsel configuration and change default setting as per need.

    ```shell

    ❯❯❯ miqsel config

    Container Engine (auto, podman, docker) [auto]:

    Selenium container image [selenium/standalone-chrome:latest]:

    VNC viewer (auto, vncviewer, vinagre, xdg-open) [auto]:

    Selenium server running on port? [4444]:

    VNC running on port? [5999]:

    Selenium container name [miqsel_container]:

    Selenium container network [default]:

    Selenium container shared Memory [2g]:

    Testing data mount to directory '/data' [default]:

    Configuration saved successfully...

    ```

    `selenium/standalone-chrome:latest` is default image. You can use other from [SeleniumHQ](https://github.com/SeleniumHQ/docker-selenium) or custom images.