Python package lbr_testsuite
The purpose of this package is to provide common set of tools
that can be used in development of tests. Package now contains
common, data_table, executable, ipconfigurer, packet_crafter,
profiling, spirent, vlan_config and optionally trex.
The package also includes the Topology plugin for pytest. The plugin provides
a set of fixtures and pre-defined pytest arguments that can be used to prepare
a testing environment. The Topology plugin is automatically installed into
pytest with the lbr_testsuite package.
Hosting and contribution
Package lbr_testsuite is hosted in PyPI index.
You can list all available versions by following this link.
This project uses GitLab CI pipeline which is triggered
with every new commit. If coding style (PEP8) check passes, then
pipeline creates .whl package from contents inside lbr_testsuite
folder. This package can be found in build step of pipeline and downloaded
for manual installation.
If the pipeline triggers on the master branch, the package is also published.
Releases (tagged commits) are uploaded to PyPI, development versions are uploaded
to internal GitLab's Package Registry.
Version of the package is controlled using git tags. Development package names
are composed from current version and the hash of the last commit.
Development of this repository is done mainly through GitLab. The repository is mirrored to GitHub for the purpose of publishing the code.
Installation
Install from PyPI index via commands:
- base version without TRex client
pip install lbr-testsuite
- version with custom API for TRex packet generator
pip install lbr-testsuite[trex]
The PyPI index contains only release versions. The development version of
the package can be obtained by installing it from the GitLab's Package Registry.
The Package Registry have to be specified as index url. Authentication via
personal access token
with scope set to api must be used.
Usage
For common:
import lbr_testsuite
All stuff from common module are available directly under the lbr_testsuite package.
For data_table:
from lbr_testsuite import data_table
Provides tools for storing results and generating graphs not only for throughput tests.
For executable:
from lbr_testsuite import executable
Executable module provides Tool, AsyncTool and Daemon convenient classes for local or remote execution of various commands.
For ipconfigurer:
from lbr_testsuite import ipconfigurer
Ipconfigurer provides API for ip configuration using pyroute2 library.
For packet_crafter:
from lbr_testsuite import packet_crafter
Classes providing high-level packet crafting. Used for trex module.
For profiling:
from lbr_testsuite import profiling
Provides measures for profiling, such as perf tool or cache misses.
For spirent:
from lbr_testsuite import spirent
Provides API for Spirent Test Center (STC).
For trex:
from lbr_testsuite import trex
Provides our custom API for Cisco TRex traffic generator. Official API is provided by required package lbr_trex_client. This module won't be accessible if only base version lbr-testsuite is installed.
For vlan_config:
from lbr_testsuite import vlan_config
Helper class for VLAN configuration management.
Repository Maintainers
- Jan Sobol, Jan.Sobol@cesnet.cz
- Dominik Tran, Dominik.Tran@cesnet.cz
License
This project is licensed under the BSD-3-Clause License - see the LICENSE file for details.
Acknowledgement
The software was partially developed within the scope of the Security Research Programme of the Czech Republic 2015-2022 (BV III / 1 VS) granted by the Ministry of the Interior of the Czech Republic under the project No. VI20192022137 -- Adaptive protection against DDoS attacks (AdaptDDoS).
Metadata
Release files for lbr-testsuite 6.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| lbr_testsuite-6.3.0-py3-none-any.whl | Python 3 | none | any | Details for lbr_testsuite-6.3.0-py3-none-any.whl |
Release files / lbr_testsuite-6.3.0-py3-none-any.whl
| Download URL | lbr_testsuite-6.3.0-py3-none-any.whl |
|---|---|
| Size | 222.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec1119f9913a81d84d283961cf165e87551f387bc6cb9740aeec5ae03f0a38d4
|
|
BLAKE2b-256 checksum How to use checksums |
f775221a9b99a12bd052c05481601b0970a781e193f66cf2e4b4c660826074a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.17
|
Security for lbr-testsuite 6.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.