|
@@ -1,31 +1,31 @@
|
|
|
-BAANGT UI Web-Service
|
|
|
+baangt UI Web-Service
|
|
|
=====================
|
|
|
-**BAANGT UI Web-Service** provides Web GUI for definition *BAANGT* tests. The main features of the service:
|
|
|
+**baangt UI Web-Service** provides Web GUI for definition *baangt* tests. The main features of the service:
|
|
|
- creating test definitions using Web GUI
|
|
|
- importing test definitions from local files (XLSX, JSON formats are supported, see available [examples](https://gogs.earthsquad.global/athos/baangt-service/src/master/ui/examples))
|
|
|
- exporting test definitions to XLSX or JSON files
|
|
|
- storing test definitions in a database (see details on the database in [**Database Description**](https://gogs.earthsquad.global/athos/baangt-service/src/master/ui/docs/database.md))
|
|
|
-- running the defined tests via **[BAANGT Execution API](https://gogs.earthsquad.global/athos/baangt-service/src/master/api)**
|
|
|
+- running the defined tests via [**baangt Execution API**](https://gogs.earthsquad.global/athos/baangt-service/src/master/api)
|
|
|
|
|
|
Environmental Variables
|
|
|
-----------------------
|
|
|
-You may use the following environmental variables to configure the **BAANGT UI Web-Service**:
|
|
|
+You may use the following environmental variables to configure the **baangt UI Web-Service**:
|
|
|
|
|
|
| Variable | Default Value | Description
|
|
|
|----------|---------------|-------------
|
|
|
| SECRET_KEY | secret!key | The secret key of the app
|
|
|
| DATABASE_URL | sqlite:///testrun.db | [*Database*](https://gogs.earthsquad.global/athos/baangt-service/src/master/ui/docs/database.md) URL
|
|
|
-| BAANGT_API_HOST | 127.0.0.1:8000 | The host that runs [*BAANGT Execution API*](https://gogs.earthsquad.global/athos/baangt-service/src/master/api)
|
|
|
-| BAANGT_DATAFILE_HOST | 127.0.0.1:5050 | The host that runs [*BAANGT Data Files*](https://gogs.earthsquad.global/athos/baangt-service/src/master/files)
|
|
|
+| BAANGT_API_HOST | 127.0.0.1:8000 | The host that runs [*baangt Execution API*](https://gogs.earthsquad.global/athos/baangt-service/src/master/api)
|
|
|
+| BAANGT_DATAFILE_HOST | 127.0.0.1:5050 | The host that runs [*baangt Data Files*](https://gogs.earthsquad.global/athos/baangt-service/src/master/files)
|
|
|
|
|
|
Set-up
|
|
|
------
|
|
|
-Before starting the **BAANGT UI Web-Service** application you need to define *DATABASE_URL* and run
|
|
|
-Before starting the **BAANGT Data Files** application you need to:
|
|
|
+Before starting the **baangt UI Web-Service** application you need to define *DATABASE_URL* and run
|
|
|
+Before starting the **baangt Data Files** application you need to:
|
|
|
- install the required python packages from `requirements.txt`
|
|
|
- define *DATABASE_URL* var
|
|
|
-- run `flask db upgrade` to create required by the *BAANGT UI Web-Service* data tables
|
|
|
-- run `python db_update.py` to populate *BAANGT UI Web-Service* database with the default supporting instances
|
|
|
+- run `flask db upgrade` to create required by the *baangt UI Web-Service* data tables
|
|
|
+- run `python db_update.py` to populate *baangt UI Web-Service* database with the default supporting instances
|
|
|
|
|
|
```bash
|
|
|
pip install -r requirements.txt
|
|
@@ -36,14 +36,14 @@ python db_update.py
|
|
|
|
|
|
Supporting Entities
|
|
|
-------------------
|
|
|
-It is easily to customize the *BAANGT* supporting entities (namely, `classnames`, `testcases`, `browsers`, `activities`, `locators`). You may just edit file `db_supports.json` and run the update script:
|
|
|
+It is easily to customize the *baangt* supporting entities (namely, `classnames`, `testcases`, `browsers`, `activities`, `locators`). You may just edit file `db_supports.json` and run the update script:
|
|
|
```bash
|
|
|
python db_update.py
|
|
|
```
|
|
|
|
|
|
Subclasses
|
|
|
----------
|
|
|
-To benefit subclasses that was installed in [**BAANGT Execution API**](https://gogs.earthsquad.global/athos/baangt-service/src/master/api) service, add them to `db_supports.json` and update the database. For instance, to introduce subclass `myTestCaseSequence.py` from [https://gogs.earthsquad.global/athos/baangt-subclassingDemo.git](https://gogs.earthsquad.global/athos/baangt-subclassingDemo.git) add it to `db_supports.json` first:
|
|
|
+To benefit subclasses that was installed in [**baangt Execution API**](https://gogs.earthsquad.global/athos/baangt-service/src/master/api) service, add them to `db_supports.json` and update the database. For instance, to introduce subclass `myTestCaseSequence.py` from [https://gogs.earthsquad.global/athos/baangt-subclassingDemo.git](https://gogs.earthsquad.global/athos/baangt-subclassingDemo.git) add it to `db_supports.json` first:
|
|
|
```JSON
|
|
|
{
|
|
|
"classnames": {
|
|
@@ -58,11 +58,11 @@ then update the database:
|
|
|
python db_ipdate.py
|
|
|
```
|
|
|
**IMPORTANT!**
|
|
|
-Ensure, you install the new subclasses in [**BAANGT Execution API**](https://gogs.earthsquad.global/athos/baangt-service/src/master/api).
|
|
|
+Ensure, you install the new subclasses in [**baangt Execution API**](https://gogs.earthsquad.global/athos/baangt-service/src/master/api).
|
|
|
|
|
|
Run Service
|
|
|
-----------
|
|
|
-Please use a Python WSGI Server to run the *BAANGT* UI Web-Service application.
|
|
|
+Please use a Python WSGI Server to run the *baangt* UI Web-Service application.
|
|
|
The **application name** is `app`
|
|
|
For example, to run the service with *gunicorn* use:
|
|
|
|