perceval-opnfv [](https://github.com/chaoss/grimoirelab-perceval-opnfv/actions?query=workflow:tests+branch:main+event:push) [](https://coveralls.io/r/chaoss/grimoirelab-perceval-opnfv?branch=main) [](https://badge.fury.io/py/perceval-opnfv)
September 8, 2025 ยท View on GitHub
Bundle of Perceval backends for OPNFV ecosystem.
Backends
The backends currently managed by this package support the next repositories:
- Functest
Requirements
- Python >= 3.10
You will also need some other libraries for running the tool, you can find the whole list of dependencies in pyproject.toml file.
Installation
There are several ways to install perceval-opnfv on your system: packages or source code using Poetry or pip.
PyPI
perceval-opnfv can be installed using pip, a tool for installing Python packages. To do it, run the next command:
$ pip install perceval-opnfv
Source code
To install from the source code you will need to clone the repository first:
$ git clone https://github.com/chaoss/grimoirelab-perceval-opnfv
$ cd grimoirelab-perceval-opnfv
Then use pip or Poetry to install the package along with its dependencies.
Pip
To install the package from local directory run the following command:
$ pip install .
In case you are a developer, you should install perceval-opnfv in editable mode:
$ pip install -e .
Poetry
We use poetry for dependency management and packaging. You can install it following its documentation. Once you have installed it, you can install perceval-opnfv and the dependencies in a project isolated environment using:
$ poetry install
To spaw a new shell within the virtual environment use:
$ poetry shell
Examples
Functest
$ perceval functest http://testresults.opnfv.org/test/ --from-date 2017-06-01 --to-date 2017-06-02
License
Licensed under GNU General Public License (GPL), version 3 or later.