LQA is both a tool and API for LAVA quality assurance tasks. It stands for LAVA Quality Assurance and its features go from submitting LAVA jobs, collect tests results, and query most of the LAVA metadata.
It is a tool developed by Collabora and it is the standard way to submit test jobs for Apertis images.
Fetch the latest code from the git repository and install using python pip as it will handle automatically the required dependencies::
$ git clone https://gitlab.collabora.com/collabora/lqa $ pip install --user lqa/
An alternative method is to use Python virtual environment to confine LQA dependencies to a specific directory instead of system wide.
git clone https://gitlab.collabora.com/collabora/lqa python3 -m venv venv source venv/bin/activate pip install pyyaml pip install lqa/ deactivate
Now you can make a symlink to the lqa script inside the venv/bin directory for running it by simply calling lqa.
cd ~/bin ln -s /<path to where the venv dir is>/venv/bin/lqa lqa
The lqa tool uses a global configuration file with the default name
lqa.yaml. This file can be found by lqa in different ways, though the
simplest way is to place this file inside the directory
The configuration file has three main fields:
These names are very self-explanatory,
user is your LAVA user name,
auth-token is the LAVA API token (generated from the web UI at
server is the LAVA
server URL address:
user: '<REPLACE_THIS_WITH_YOUR_LAVA_USERNAME>' auth-token: '<REPLACE_THIS_WITH_YOUR_API_TOKEN>' server: 'https://lava.collabora.co.uk/'
Save this file as
~/.config/lqa.yaml and now test your configuration:
$ lqa whoami <LAVA_USERNAME>
If everything is good, the above command should show your authenticated user name and you should be all set to start using lqa!