QA Tool installation guide

Guidelines for the installation of Aura QA Tool

Download the QA test set from a Github repository

In order to download the QA tool from one specific branch in the GitHub repository, follow these instructions:

  1. Open a terminal.
  2. Change the current working directory to the location where the cloned directory will be placed.
  3. Type the following command: git clone https://github.com/Telefonica/aura-tests.git
  4. Press “Enter”. The local clone will be created.
    $ git clone https://github.com/Telefonica/aura-tests.git
    Cloning into 'aura-tests'...
    remote: Enumerating objects: 1095, done.
    remote: Counting objects: 100% (1095/1095), done.
    remote: Compressing objects: 100% (235/235), done.
    remote: Total 30040 (delta 962), reused 947 (delta 850), pack-reused 28945
    Receiving objects: 100% (30040/30040), 55.39 MiB | 3.28 MiB/s, done.
    Resolving deltas: 100% (23490/23490), done.
    
  5. Check the specific branch for your release in Aura release vs QA Tool branches and switch to this branch using the following instructions:
    git checkout <branch_name>
    

Create and activate the new virtual environment

Make available a new virtual environment through these steps:

  1. Create a virtual environment for the project:
    $ cd <project_folder>
    $ virtualenv venv
    
  2. Activate the virtual environment:
    $ source venv/bin/activate
    
  3. If it is required to deactivate the virtual environment:
    $ deactivate
    

Install requirements

⚠️ Remember that it is highly recommended to reinstall the QA Tool requirements if you have installed a new Aura Platform release

Once the virtual environment is activated, install the packages required for the QA tests execution in the current environment. The installation must be done inside the activated virtual environment.

The requirements are included in the file requirements_ob.txt, within the folder: https://github.com/Telefonica/aura-tests/blob/master/acceptance

The steps to do that, are described below:

$ cd [project_folder]/aura-tests 
$ cd acceptance/ 
$ pip install -r requirements_ob.txt

ℹ️ Please, ignore no critical warning or errors messages that can be displayed, depending on the system versions.